> ## 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/zh/guides/use-cases/ai-ml/MCP)或 [ClickHouse Cloud 远程 MCP 服务器](/docs/zh/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
```