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

# Connect AI assistants

> Give AI tools like ChatGPT and Claude secure access to your Kime data.

Kime exposes a secure connection that lets AI assistants work with your data directly. Once connected, tools like Claude and ChatGPT can read your AI perception data, analyze your competitors, and help you act on your visibility — right inside the assistant you already use.

You'll find it under **Integrations** in your organization settings.

<Note>
  This integration is rolling out gradually. If you don't see **Integrations** in your organization yet, it isn't enabled for your account.
</Note>

## Connection URL

Every client connects to the same Kime endpoint. Your exact URL is shown on the **Integrations** page in your organization settings — always copy it from there so it's correct for your account and environment.

```text theme={null}
https://<your-kime-mcp-url>
```

## Authentication

Kime uses **OAuth** — there's nothing to paste or store. The first time an assistant uses a Kime tool, it opens a secure sign-in window where you log in and approve access. After that, your session persists across conversations.

Access always respects your Kime account: an assistant can only see the organizations and workspaces you can, and acts within your existing permissions.

## Claude (Desktop & Web)

<Steps>
  <Step title="Open connectors">
    In Claude, go to **Customize** (gear icon) → **Connectors**.
  </Step>

  <Step title="Add a custom connector">
    Click **+**, choose **Add custom connector**, name it **Kime**, and paste the connection URL from the Integrations page.
  </Step>

  <Step title="Connect">
    Click **Add**, then **Connect**. You'll be redirected to Kime to sign in. The first time you ask about your data, approve access when prompted.
  </Step>
</Steps>

<Note>
  In some Claude workspaces, only an admin can add connectors. If you can't add one, ask your Claude workspace admin.
</Note>

## ChatGPT

Custom connectors in ChatGPT require **Developer mode** (available on paid plans; on Business and Enterprise workspaces an admin may need to enable it first).

<Steps>
  <Step title="Enable Developer mode">
    Go to **Settings** → **Apps** → **Advanced settings** and turn on **Developer mode**.
  </Step>

  <Step title="Create the app">
    Click **Create app**, name it **Kime**, paste the connection URL from the Integrations page, and choose **OAuth** as the authentication method.
  </Step>

  <Step title="Enable it in a chat">
    Save the app and use **Scan tools** to confirm the connection. In a new chat, open the **+** menu → **Developer mode** and enable your Kime connector.
  </Step>
</Steps>

## Other MCP clients

Kime uses the standard **Model Context Protocol** over Streamable HTTP, so it works with any MCP-compatible tool — including Cursor, VS Code (GitHub Copilot), and Claude Code. Point your client at the Kime connection URL, choose **Streamable HTTP** as the transport, and sign in via OAuth when prompted.

<CodeGroup>
  ```bash Claude Code theme={null}
  claude mcp add kime --transport http https://<your-kime-mcp-url>
  ```

  ```json VS Code (.vscode/mcp.json) theme={null}
  {
    "servers": {
      "kime": {
        "type": "http",
        "url": "https://<your-kime-mcp-url>"
      }
    }
  }
  ```
</CodeGroup>

In **Cursor**, open **Settings → Tools & Integrations → MCP**, add a custom MCP server with the Kime URL, and select Streamable HTTP. You'll be prompted to sign in via Kime on first use.

## Verify your connection

After connecting, ask your assistant something like:

> "List my Kime workspaces."

If it returns your workspaces, you're connected. From there you can ask it to summarize your visibility, compare competitors, or review your open actions.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authorization failed or unauthorized">
    Confirm you signed in with the correct Kime account, then remove and re-add the connector. Clearing cookies for the Kime sign-in window and reconnecting can also help.
  </Accordion>

  <Accordion title="No workspaces found">
    Make sure your Kime account has access to at least one workspace, and that you approved access for the right organization during sign-in.
  </Accordion>

  <Accordion title="Connection won't complete">
    Check your internet connection and confirm the URL exactly matches the one on the Integrations page. If your client supports multiple transports, make sure it's set to Streamable HTTP.
  </Accordion>

  <Accordion title="I don't see Integrations">
    The integration is in gradual rollout. If it isn't visible in your organization settings, it isn't enabled for your account yet.
  </Accordion>
</AccordionGroup>