启用并连接 ClickHouse Cloud 远程 MCP 服务器

本指南介绍如何启用 ClickHouse Cloud Remote MCP Server，并将其配置为可与常见的开发者工具配合使用。

前置条件

• 一个正在运行的 ClickHouse Cloud 服务
• 你选择的 IDE 或智能体开发工具

连接到要为其启用远程 MCP 服务器的 ClickHouse Cloud 服务。 在左侧菜单中，点击 Connect。此时会打开一个显示连接详情的对话框。

选择 Connect with MCP：

打开切换开关，为该服务启用 MCP：

复制显示的 URL，它与下方的 URL 相同：

https://mcp.clickhouse.cloud/mcp

请选择下方的 IDE 或工具，并按相应说明完成设置。

在工作目录中，运行以下命令，将 ClickHouse Cloud MCP Server 配置添加到 Claude Code 中：

claude mcp add --transport http clickhouse-cloud https://mcp.clickhouse.cloud/mcp

然后启动 Claude Code：

claude

运行以下命令以列出 MCP 服务器：

/mcp

选择 clickhouse-cloud，然后使用 ClickHouse Cloud 凭据通过 OAuth 完成身份验证。

1. 前往 Customize > Connectors
2. 点击 “+” 图标，然后点击 Add custom connector
3. 为自定义连接器命名，例如 clickhouse-cloud，然后将其添加
4. 点击新添加的 clickhouse-cloud 连接器，然后点击 Connect
5. 通过 OAuth 使用你的 ClickHouse Cloud 凭据进行身份验证

1. 在 Cursor 市场中浏览并安装 MCP 服务器。
2. 搜索 ClickHouse，然后在任一服务器上点击“Add to Cursor”进行安装
3. 通过 OAuth 进行身份验证。

将以下配置添加到 .vscode/mcp.json 中：

{
  "servers": {
    "clickhouse-cloud": {
      "type": "http",
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

更多详情请参阅 Visual Studio Code 文档。

按以下配置编辑 mcp_config.json 文件：

{
  "mcpServers": {
    "clickhouse-cloud": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.clickhouse.cloud/mcp"]
    }
  }
}

更多详细信息请参阅 Windsurf 文档。

将 ClickHouse 添加为自定义服务器。 在 Zed 设置的 context_servers 下添加以下内容：

{
  "context_servers": {
    "clickhouse-cloud": {
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

当 Zed 首次连接到服务器时，应会提示你通过 OAuth 进行身份验证。 更多信息请参阅 Zed 文档。

运行以下命令，通过 CLI 添加 ClickHouse Cloud MCP 服务器：

codex mcp add clickhouse-cloud --url https://mcp.clickhouse.cloud/mcp

连接完成后，您就可以通过自然语言提示词与 ClickHouse Cloud 交互。 下面列出了一些常见工作流，以及您的 MCP 客户端会在后台调用的工具。 如需查看可用工具的完整列表，请参阅工具参考。

先查看有哪些可用内容：

用自然语言提问，agent 会将其转换为 SQL：

run_select_query 工具只允许执行 SELECT 语句。所有查询均为只读。

查看你的 ClickHouse Cloud 资源信息：

• ClickHouse agent 技能