Skip to main content
并非所有用户都通过 Cloud 控制台 与 ClickHouse 交互。 例如，许多开发者直接在自己偏好的代码编辑器、CLI 智能体中工作，或通过自定义方式连接到数据库；还有一些人则在大多数探索过程中依赖 Anthropic Claude 这类通用 AI 助手。 这些用户以及代表他们执行操作的智能体工作负载，需要一种无需复杂配置或自建基础设施、即可安全访问和查询 ClickHouse Cloud 的方式。 ClickHouse Cloud 的远程 MCP 服务器能力正是为此而设计，它提供了一个标准接口，供外部智能体获取分析上下文。 MCP (即 Model Context Protocol) 是供基于 LLM 的 AI 应用访问结构化数据的标准。 借助这一集成，外部智能体可以列出数据库和表、检查 schema，并运行有范围限制的只读 SELECT 查询。 身份验证通过 OAuth 2.0 或 ClickHouse Cloud API key 完成。该服务器由 ClickHouse Cloud 完全托管，因此无需任何设置或维护。 这让智能体工具更容易接入 ClickHouse 并获取所需数据，无论是用于分析、摘要、代码生成还是探索。

​
远程 MCP 服务器 与开源 MCP 服务器 对比

ClickHouse 提供两种 MCP 服务器。 远程 MCP 服务器为 ClickHouse Cloud 提供最完整的集成能力，包括服务管理、备份监控、ClickPipe 可见性和计费数据，且无需管理任何基础设施。 如需用于自托管 ClickHouse instance，请参阅开源 MCP 服务器 指南。

​
启用远程 MCP 服务器

远程 MCP 服务器必须按服务分别启用，启用后才能接受连接。 在 ClickHouse Cloud 控制台中，打开你的服务，点击 Connect 按钮，选择 MCP，然后将其启用。 启用或禁用远程 MCP 服务器需要具备 control-plane:service:manage-mcp 权限 (参见控制台角色和权限) 。 如需查看带截图的详细步骤，请参阅设置指南。

​
端点

启用后，可通过以下地址访问远程 MCP 服务器：

​
身份验证

远程 MCP 服务器支持两种身份验证方法：
  • OAuth 2.0：推荐用于交互式客户端。MCP 客户端首次连接时，会打开浏览器窗口，供用户使用其 ClickHouse Cloud 凭证登录。访问范围仅限于已通过身份验证的用户有权访问的组织和服务。
  • ClickHouse Cloud API key：适用于远程、无界面及自动化环境等不便使用基于浏览器的 OAuth 流程的场景。通过 HTTP Basic 身份验证发送 API key ID 和密钥：
通过 API key 访问时，其访问范围由该密钥配置的角色、权限和过期时间决定。请使用专用的最小权限密钥，并通过机密信息管理系统注入。Base64 编码并不会加密凭证，因此切勿将编码后的值提交到源代码管理系统，也不要让其出现在日志中。 有关在无界面环境中配置 MCP 客户端的示例，请参阅从无界面环境进行身份验证。

​
安全性

远程 MCP 服务器提供的所有工具均为只读。每个工具在其 MCP 元数据中都标注了 readOnlyHint: true。没有任何工具可以修改数据、更改服务配置或执行任何破坏性操作。

​
可用工具

远程 MCP 服务器提供了 13 个工具，分为以下几类。

​
查询与 schema 探索

这些工具允许智能体发现有哪些可用数据，并运行分析查询。

​
组织

​
服务

​
备份

​
ClickPipes

​
计费

​
快速入门

有关如何启用远程 MCP 服务器并将其连接到 MCP 客户端的分步说明，请参阅设置指南。