跳到主要内容
跳到主要内容

启用 ClickHouse Cloud 远程 MCP 服务器

本指南介绍如何启用和使用 ClickHouse Cloud 远程 MCP 服务器。本示例使用 Claude Code 作为 MCP 客户端,但您可以使用任何支持 MCP 的 LLM 客户端。

为 ClickHouse Cloud 服务启用远程 MCP 服务器​

  1. 连接到 ClickHouse Cloud 服务，单击 Connect 按钮，为该服务启用远程 MCP 服务器
在 Connect 弹窗中选择 MCP
启用 MCP 服务器
  1. 在 Connect 视图或下方复制 ClickHouse Cloud MCP 服务器的 URL
https://mcp.clickhouse.cloud/mcp

在 Claude Code 中添加 ClickHouse MCP 服务器​

  1. 在您的工作目录中运行以下命令，将 ClickHouse Cloud MCP 服务器的配置添加到 Claude Code 中。在此示例中，我们在 Claude Code 配置中将 MCP 服务器命名为 clickhouse_cloud。
claude mcp add --transport http clickhouse_cloud https://mcp.clickhouse.cloud/mcp

1b. 具体取决于你使用的 MCP 客户端，你也可以直接编辑 JSON 配置

{
  "mcpServers": {
    "clickhouse-remote": {
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}
  1. 在当前工作目录中启动 Claude Code
[user@host ~/Documents/repos/mcp_test] $ claude

通过 OAuth 验证 ClickHouse Cloud 身份​

  1. 在首次会话时，Claude Code 会打开一个浏览器窗口。否则，您也可以在 Claude Code 中运行 /mcp 命令，并选择 clickhouse_cloud MCP 服务器来发起连接

  2. 使用您的 ClickHouse Cloud 凭证进行身份验证

OAuth 连接流程
OAuth 连接流程成功

从 Claude Code 使用 ClickHouse Cloud 远程 MCP 服务器​

  1. 在 Claude Code 中验证远程 MCP 服务器已连接
Claude Code MCP success
Claude Code MCP Details
  1. 恭喜!您现在可以从 Claude Code 使用 ClickHouse Cloud 远程 MCP 服务器了
Claude Code MCP Usage

虽然本示例使用了 Claude Code,但您可以按照类似步骤使用任何支持 MCP 的 LLM 客户端。