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

# Set up your client

> Connect Claude, Claude Code, Cursor, Codex, or any MCP app to Komo

<Note>
  The fastest path is [app.komo.ai/connect](https://app.komo.ai/connect) — it
  creates a key and renders every snippet below with your real key filled in.
</Note>

All clients need two things: the server URL `https://mcp.komo.ai/mcp` and an
API key from
[app.komo.ai/settings/api-keys](https://app.komo.ai/settings/api-keys).
Replace `YOUR_API_KEY` below with the full `pk_…:sk_…` pair.

<Tabs>
  <Tab title="Claude (claude.ai & Desktop)">
    Claude's connector UI can't set custom headers, so the key goes in the URL
    path:

    1. Open **Settings → Connectors → Add custom connector**
    2. Name: `Komo`
    3. URL: `https://mcp.komo.ai/mcp/YOUR_API_KEY`
    4. Click **Add** — no restart needed

    Ask *"What can Komo do?"* to confirm the connection.
  </Tab>

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

    Verify with `/mcp` inside a session.
  </Tab>

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

    ```json theme={null}
    {
      "mcpServers": {
        "komo": {
          "url": "https://mcp.komo.ai/mcp",
          "headers": { "Authorization": "Bearer YOUR_API_KEY" }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Codex">
    Add to `~/.codex/config.toml`:

    ```toml theme={null}
    [mcp_servers.komo]
    url = "https://mcp.komo.ai/mcp"
    http_headers = { "Authorization" = "Bearer YOUR_API_KEY" }
    ```
  </Tab>

  <Tab title="Other clients">
    Any client that supports remote MCP servers over **Streamable HTTP**
    works:

    * URL: `https://mcp.komo.ai/mcp`
    * Auth: `Authorization: Bearer YOUR_API_KEY` or `x-api-key: YOUR_API_KEY`
    * Header-less clients: `https://mcp.komo.ai/mcp/YOUR_API_KEY`
  </Tab>
</Tabs>

## Optional: the Komo prospecting skill

For noticeably better results in Claude, add the **komo-prospecting skill** —
a workflow guide that teaches Claude Komo etiquette (qualify the ICP before
spending credits, always save results to lists, never send without showing you
the message first). Download the zip from
[app.komo.ai/connect](https://app.komo.ai/connect) and upload it at
claude.ai → **Settings → Capabilities → Skills** (or drop the folder into
`~/.claude/skills/` for Claude Code). The MCP server works fine without it.

## Connecting LinkedIn and email from chat

Sending tools need a connected LinkedIn seat or email inbox. You can start
either connection from chat — the tool returns a secure browser URL:

1. Ask: *"Connect my LinkedIn account."*
2. The assistant calls `connect_linkedin_account` and gives you a hosted sign-in
   link — your credentials go to LinkedIn's flow, never through the chat.
3. Finish in the browser, then ask the assistant to verify with
   `list_linkedin_accounts`.

Email works the same way via `connect_email_account` (Gmail / Outlook OAuth).

## Troubleshooting

| Symptom                                   | Fix                                                                                                                                                                                       |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "API key invalid or revoked"              | Create a new key at [settings/api-keys](https://app.komo.ai/settings/api-keys) and update your client config.                                                                             |
| "Payment required" on a tool              | Your credit balance can't cover the action — top up at [settings/billing](https://app.komo.ai/settings/billing).                                                                          |
| "Rate/safety limit hit" on LinkedIn sends | The seat's daily/weekly cap or pacing window is active; the message includes when to retry. Limits are adjustable per seat at [settings/linkedin](https://app.komo.ai/settings/linkedin). |
| Client can't connect at all               | Confirm the URL is exactly `https://mcp.komo.ai/mcp` and your client supports Streamable HTTP (SSE-only clients are not supported).                                                       |