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

启用 ClickHouse Cloud 远程 MCP 服务器

本指南解释了如何启用和使用 ClickHouse Cloud 远程 MCP 服务器。我们将在此示例中使用 Claude Code 作为 MCP 客户端，但可以使用任何支持 MCP 的 LLM 客户端。

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

  1. 连接到您的 ClickHouse Cloud 服务，点击 Connect 按钮，并为您的服务启用远程 MCP 服务器
在连接模态中选择 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 成功
Claude Code MCP 详细信息
  1. 恭喜！您现在可以从 Claude Code 使用 ClickHouse Cloud 远程 MCP 服务器
Claude Code MCP 使用

虽然这个示例使用了 Claude Code，但您可以通过遵循类似步骤，使用任何支持 MCP 的 LLM 客户端。