Client Setup

Claude (claude.ai)

Settings → Connectors → Add custom connector. Name it NinjaChat, paste the URL, sign in when prompted. No API key.

ChatGPT

Settings → Connectors → Advanced → enable developer mode. Then Create a connector, name it NinjaChat, paste the URL, and approve the OAuth sign-in. Enable it in the composer.

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "ninjachat": {
      "url": "https://www.ninjachat.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer nj_sk_YOUR_KEY"
      }
    }
  }
}

Cursor Settings → MCP should show ninjachat with a green dot. If not, reload the window.

Claude Code

claude mcp add --transport http ninjachat https://www.ninjachat.ai/api/mcp \
  --header "Authorization: Bearer nj_sk_YOUR_KEY"

Verify with /mcp. Add --scope user to use it in every project.

Listed as failed? Use --transport http (not sse) and keep the whole "Authorization: Bearer …" string as one shell argument.

Codex

~/.codex/config.toml

[mcp_servers.ninjachat]
url = "https://www.ninjachat.ai/api/mcp"
http_headers = { "Authorization" = "Bearer nj_sk_YOUR_KEY" }

Restart the session — config loads at launch.

TOML is picky: [mcp_servers.ninjachat] with an underscore, and http_headers as an inline table.

VS Code

.vscode/mcp.json

{
  "servers": {
    "ninjachat": {
      "type": "http",
      "url": "https://www.ninjachat.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer nj_sk_YOUR_KEY"
      }
    }
  }
}

Click the Start code lens above the entry, then use it in Copilot Chat’s agent mode.

Hermes

~/.hermes/config.yaml

mcp_servers:
  ninjachat:
    url: "https://www.ninjachat.ai/api/mcp"
    headers:
      Authorization: "Bearer nj_sk_YOUR_KEY"
    enabled: true

Start a new session — the dashboard’s MCP panel shows the connection.

OpenClaw

openclaw mcp add ninjachat \
  --url https://www.ninjachat.ai/api/mcp \
  --transport streamable-http \
  --header "Authorization: Bearer nj_sk_YOUR_KEY"

Restart the gateway to load it.

Get Started

Using It

Reference

Test it

​Test it

Test it