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

启用 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 Server​

  1. 在工作目录下运行以下命令，将 ClickHouse Cloud MCP Server 的配置添加到 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 客户端中使用。