跳转到主内容
跳转到主内容

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

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

前提条件

为 Cloud 启用远程 MCP 服务器​

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

选择 "Connect with MCP"：

在 Connect 对话框中选择 MCP

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

启用 MCP 服务器

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

https://mcp.clickhouse.cloud/mcp

为开发环境配置远程 MCP​

请选择下面的 IDE 或工具，并按照相应的配置说明进行操作。

Claude Code​

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

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

然后启动 Claude Code：

claude

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

/mcp

选择 clickhouse-cloud，然后使用你的 ClickHouse Cloud 凭据通过 OAuth 进行身份验证。

Claude 网页界面​

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

Cursor​

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

Visual Studio Code​

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

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

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

Windsurf​

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

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

更多详情，请参阅 Windsurf 文档

Zed​

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

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

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

Codex​

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

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

相关内容​