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

# Connect

> Connection configuration examples for each MCP client

You only need two things to connect: the server **URL** and the `API-Key: <API key>` **header**. Here are examples for the most common clients.

```bash Claude Code theme={null}
claude mcp add --transport http chainshift \
  https://platform-api.trychainshift.ai/mcp \
  --header "API-Key: cs_live_xxxxxxxx"
```

```json Cursor theme={null}
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "chainshift": {
      "url": "https://platform-api.trychainshift.ai/mcp",
      "headers": {
        "API-Key": "cs_live_xxxxxxxx"
      }
    }
  }
}
```

```json VS Code theme={null}
// .vscode/mcp.json
{
  "servers": {
    "chainshift": {
      "type": "http",
      "url": "https://platform-api.trychainshift.ai/mcp",
      "headers": {
        "API-Key": "cs_live_xxxxxxxx"
      }
    }
  }
}
```

```json Windsurf theme={null}
// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "chainshift": {
      "serverUrl": "https://platform-api.trychainshift.ai/mcp",
      "headers": {
        "API-Key": "cs_live_xxxxxxxx"
      }
    }
  }
}
```

```toml Codex CLI theme={null}
# ~/.codex/config.toml
[mcp_servers.chainshift]
url = "https://platform-api.trychainshift.ai/mcp"
http_headers = { "API-Key" = "cs_live_xxxxxxxx" }
```

```json Claude Desktop theme={null}
// claude_desktop_config.json — stdio only, so connect through the mcp-remote bridge.
{
  "mcpServers": {
    "chainshift": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://platform-api.trychainshift.ai/mcp",
        "--header", "API-Key: cs_live_xxxxxxxx"
      ]
    }
  }
}
```

Once connected, the client shows the list of Chainshift tools. You can then make requests such as "Show me my brands" or "Create a prompt set called Spring Campaign".

> [!NOTE]
>
> Clients not listed here also connect with the same URL and `API-Key` header as long as they support Streamable HTTP. For clients that only support stdio, bridge with `npx mcp-remote <URL> --header "API-Key: …"`.

> [!NOTE]
>
> The **web connectors** in Claude.ai and ChatGPT use OAuth authentication instead of entering an API key directly. See [Web connectors](https://docs.trychainshift.ai/en/mcp/web-connectors.md) for how to connect and [OAuth 2.1](https://docs.trychainshift.ai/en/authentication/oauth2.md) for the technical flow.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.