> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ninjachat.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP quickstart

> Connect NinjaChat, check the connection for free, then make your first creation.

Open [Connect your agent](https://www.ninjachat.ai/developers/agents) for guided setup, or choose your client below. You need a NinjaChat account and a client that supports remote MCP servers.

<Tabs>
  <Tab title="Claude">
    1. In Claude web, open **Settings → Connectors → Add custom connector**.
    2. Name it `NinjaChat` and paste this URL:

    ```text theme={null}
    https://www.ninjachat.ai/api/mcp
    ```

    3. Sign in to NinjaChat, review permissions and set your spending limit.
    4. Start a new chat and enable NinjaChat. Your account or workspace must allow custom connectors.
  </Tab>

  <Tab title="ChatGPT">
    1. On ChatGPT web, enable **Settings → Security and login → Developer mode**.
    2. Open [Plugins](https://chatgpt.com/plugins), select **+**, and name the connection `NinjaChat`.
    3. Under **Connection**, enter:

    ```text theme={null}
    https://www.ninjachat.ai/api/mcp
    ```

    4. Connect, sign in to NinjaChat, and approve access. Add NinjaChat from the tools menu in a new chat.

    Availability depends on your account and workspace. See [OpenAI's connection guide](https://developers.openai.com/plugins/deploy/connect-chatgpt).
  </Tab>

  <Tab title="Claude Code">
    Create a connection key in [Developers → Agents](https://www.ninjachat.ai/developers/agents?client=claude-code). Replace `nj_sk_YOUR_KEY` with the **entire key**, then run:

    ```bash theme={null}
    claude mcp add --transport http --scope user ninjachat https://www.ninjachat.ai/api/mcp --header "Authorization: Bearer nj_sk_YOUR_KEY"
    ```

    Start Claude Code and run `/mcp` to check `ninjachat`. This setup applies to all your projects.
  </Tab>

  <Tab title="Other clients">
    [Client setup](/mcp/clients) has the exact configuration for Cursor, Codex, VS Code, Hermes and OpenClaw.
  </Tab>
</Tabs>

## Check the connection — free

```text theme={null}
Use NinjaChat to check my balance and list available image,
video and voice models. Do not generate anything or add credits.
```

## Make your first creation

```text theme={null}
Use NinjaChat to make one image of a lighthouse in a storm,
with golden light through a wave. Check my balance, quote the
model and total price, and wait for approval before generating.
Return the finished image and download link.
```

Then try “animate this image” or “write and quote a voiceover for this scene.” Video jobs can take several minutes; ask your agent to check the existing job instead of starting again.

<CardGroup cols={2}>
  <Card title="Workflows" icon="book-open" href="/mcp/recipes">Turn one brief into a larger production.</Card>
  <Card title="Credits & limits" icon="credit-card" href="/mcp/billing">Check starter-credit eligibility and control spending.</Card>
</CardGroup>
