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

# 연결

> MCP 클라이언트별 연결 설정 예시

연결에 필요한 건 두 가지뿐입니다 — 서버 **URL**과 `API-Key: <API 키>` **헤더**. 대표 클라이언트 예시는 다음과 같습니다.

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

  ```json Cursor theme={null}
  // ~/.cursor/mcp.json
  {
    "mcpServers": {
      "chainshift": {
        "url": "https://dev-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://dev-platform-api.trychainshift.ai/mcp",
        "headers": {
          "API-Key": "cs_live_xxxxxxxx"
        }
      }
    }
  }
  ```

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

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

  ```json Claude Desktop theme={null}
  // claude_desktop_config.json — stdio 전용이라 mcp-remote 브리지로 연결합니다.
  {
    "mcpServers": {
      "chainshift": {
        "command": "npx",
        "args": [
          "-y", "mcp-remote",
          "https://dev-platform-api.trychainshift.ai/mcp",
          "--header", "API-Key: cs_live_xxxxxxxx"
        ]
      }
    }
  }
  ```
</CodeGroup>

연결하면 클라이언트가 Chainshift tool 목록을 표시합니다. 예를 들어 "내 브랜드 목록 보여줘" 또는 "Spring Campaign 이라는 프롬프트 그룹 만들어줘" 처럼 요청하면 됩니다.

<Note>
  여기에 없는 클라이언트도 Streamable HTTP를 지원하면 같은 URL과 `API-Key` 헤더로 연결됩니다. stdio만 지원하는 클라이언트는 `npx mcp-remote <URL> --header "API-Key: …"`로 브리지하세요.
</Note>

<Note>
  Claude.ai·ChatGPT의 **웹 커넥터**는 API 키 직접 입력 대신 OAuth 인증을 사용합니다. 연결 방법은 [웹 커넥터](/mcp/web-connectors)를, 기술 흐름은 [OAuth 2.1](/authentication/oauth2)을 참고하세요.
</Note>