> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/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 서버](/ko/guides/use-cases/ai-ml/MCP) 또는 [ClickHouse Cloud 원격 MCP 서버](/ko/products/cloud/features/ai-ml/remote-mcp)를 사용하십시오.
</Info>

Model Context Protocol(MCP)을 사용하여 AI 도구에서 ClickHouse 문서를 직접 쿼리할 수 있습니다.

<div id="connect-your-ai-tool">
  ## AI 도구 연결하기
</div>

<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-trino-dialect/TaJVOJrb2nH0JFss/images/logo-codex.svg?fit=max&auto=format&n=TaJVOJrb2nH0JFss&q=85&s=32e8fc19cdff83681dea520e34e5e27c" 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>

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

에이전트에 ClickHouse 전문가 수준의 지식과 모범 사례를 제공하려면 ClickHouse 스킬을 설치하십시오:

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