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

# ClickHouse 문서 MCP 서버 설정

> Model Context Protocol을 통해 AI 도구를 ClickHouse 문서에 연결합니다.

<Info>
  이 페이지에서는 ClickHouse 문서를 검색하는 MCP 서버를 설정합니다. ClickHouse 데이터를 쿼리하려면 [오픈 소스 ClickHouse MCP 서버](/docs/ko/guides/use-cases/ai-ml/MCP) 또는 [ClickHouse Cloud 원격 MCP 서버](/docs/ko/products/cloud/features/ai-ml/remote-mcp)를 사용하세요.
</Info>

Model Context Protocol(MCP)을 사용하여 AI 도구에서 ClickHouse 문서를 직접 조회합니다.

<h2 id="connect-your-ai-tool">
  AI 도구 연결
</h2>

<Tabs>
  <Tab title="Claude Code" icon="https://clickhouse-docs-assets.s3.us-east-1.amazonaws.com/logo-claudecode-color.svg">
    터미널에서 실행하세요:

    ```bash theme={null}
    claude mcp add --transport http clickhouse-docs https://clickhouse.com/docs/mcp --scope user
    ```
  </Tab>

  <Tab title="Claude Desktop" icon="https://clickhouse-docs-assets.s3.us-east-1.amazonaws.com/logo-claude.svg">
    `claude_desktop_config.json`에 추가하세요:

    ```json theme={null}
    {
      "mcpServers": {
        "clickhouse-docs": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://clickhouse.com/docs/mcp"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Codex" icon="https://mintcdn.com/private-7c7dfe99/XJAlwu-tcr9cBsLZ/images/logo-codex.svg?fit=max&auto=format&n=XJAlwu-tcr9cBsLZ&q=85&s=7f52668daa9560ccb0c6439fe7bbd264" width="24" height="24" data-path="images/logo-codex.svg">
    터미널에서 실행하세요:

    ```bash theme={null}
    codex mcp add clickhouse-docs --url https://clickhouse.com/docs/mcp
    ```
  </Tab>

  <Tab title="Cursor" icon="https://clickhouse-docs-assets.s3.us-east-1.amazonaws.com/logo-cursor.png">
    `.cursor/mcp.json`에 추가하세요:

    ```json theme={null}
    {
      "mcpServers": {
        "clickhouse-docs": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://clickhouse.com/docs/mcp"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windsurf" icon="https://clickhouse-docs-assets.s3.us-east-1.amazonaws.com/logo-windsurf.svg">
    `~/.codeium/windsurf/mcp_config.json`에 추가하세요:

    ```json theme={null}
    {
      "mcpServers": {
        "clickhouse-docs": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://clickhouse.com/docs/mcp"]
        }
      }
    }
    ```
  </Tab>
</Tabs>

<h2 id="add-clickhouse-skills">
  코딩 에이전트에 ClickHouse 스킬 추가
</h2>

에이전트에 ClickHouse 전문 지식과 모범 사례를 제공하려면 ClickHouse 스킬을 설치하세요:

```bash theme={null}
npx skills add https://clickhouse.com
```