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

# MCP quickstart

> Connect Claude Code, Claude Desktop, Cursor, or ChatGPT to Atako in under a minute.

<Steps>
  <Step title="Get an API key">
    Go to [app.atako.ai](https://app.atako.ai) → **Settings → API keys** → **Create
    key**. Copy it immediately — it's shown once. See [API keys](/developers/api-keys)
    for details.
  </Step>

  <Step title="Add the server to your client">
    Pick your client below.
  </Step>

  <Step title="Try it">
    Ask your client something like *"list my Atako agents"* or *"what's my Atako
    credit balance?"* — it should call `list_agents` / `get_credits` and answer from
    the result. Once that works, try something that writes: *"create an agent that
    triages my Zendesk tickets"* or *"send a message to my support agent and wait
    for the reply."*
  </Step>
</Steps>

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http atako https://api.atako.ai/mcp \
      --header "Authorization: Bearer aik_..."
    ```

    Verify with `claude mcp list`, or `/mcp` inside a Claude Code session.
  </Tab>

  <Tab title="Claude Desktop">
    Claude Desktop reads remote MCP servers from its config file (**Settings →
    Developer → Edit Config**, or directly):

    ```json theme={null}
    {
      "mcpServers": {
        "atako": {
          "url": "https://api.atako.ai/mcp",
          "headers": {
            "Authorization": "Bearer aik_..."
          }
        }
      }
    }
    ```

    Restart Claude Desktop after saving.
  </Tab>

  <Tab title="Cursor">
    Add to `~/.cursor/mcp.json` (or your project's `.cursor/mcp.json`):

    ```json theme={null}
    {
      "mcpServers": {
        "atako": {
          "url": "https://api.atako.ai/mcp",
          "headers": {
            "Authorization": "Bearer aik_..."
          }
        }
      }
    }
    ```

    Reload Cursor, then check **Settings → MCP** to confirm it connected.
  </Tab>

  <Tab title="ChatGPT (developer mode)">
    In ChatGPT, open **Settings → Connectors → Advanced → Developer mode**, then
    **Add custom connector**:

    * **URL**: `https://api.atako.ai/mcp`
    * **Authentication**: choose a header-based/API key option and set
      `Authorization: Bearer aik_...`

    Developer mode connectors are currently available on paid ChatGPT plans; the
    exact menu wording may vary as OpenAI iterates on it.
  </Tab>
</Tabs>

## No account, just curious?

`https://api.atako.ai/mcp/public` needs no API key and exposes 3 tools —
`get_pricing`, `list_use_cases`, `list_integration_pages` — the same content
available on [atako.ai](https://atako.ai) without signing in. Configure it the same
way as above, just without the `Authorization` header.

## Troubleshooting

<AccordionGroup>
  <Accordion title="My client says it can't connect">
    Confirm the URL is exactly `https://api.atako.ai/mcp` (no trailing slash issues,
    `https`, no typo in `atako`) and that your client supports the Streamable HTTP
    transport (all four clients above do).
  </Accordion>

  <Accordion title="I get an authentication / 401 error">
    Check the header is exactly `Authorization: Bearer aik_...` — the full key,
    including the `aik_` prefix, with no extra whitespace. If the key was revoked
    from Settings → API keys, create a new one.
  </Accordion>

  <Accordion title="A tool call fails or says 'not found'">
    Most tools take an `agentId` — get one first from `list_agents`. A "not found"
    error on `get_agent`/`list_messages`/etc. usually means the id belongs to an
    agent your key's owner can't access, or doesn't exist.
  </Accordion>

  <Accordion title="A write tool fails with AGENT_LIMIT_REACHED or NO_ACTIVE_SUBSCRIPTION">
    `create_agent`, `resume_agent`, and `retry_agent_provisioning` are subject to the
    same seat-limit and subscription checks as the app's own "Create an agent"
    button. The tool error names the next step — e.g. end an agent you no longer
    need to free a seat, or subscribe from **app.atako.ai → Settings → Billing**.
  </Accordion>

  <Accordion title="My client won't finish connecting an integration">
    An OAuth-only provider can't be connected purely through MCP — `get_connect_url`
    only gives you the authorization URL; you still have to open it in a browser and
    grant consent yourself. For a provider that accepts a pasted API key/token
    instead, use `create_integration_connection`, which needs no browser step.
  </Accordion>
</AccordionGroup>

See the [Atako MCP overview](/developers/mcp/overview) for the full tool list and
what's coming next.