Set up docs MCP并非所有用户都通过 Cloud Console 与 ClickHouse 交互。 例如，许多开发者直接在自己偏好的代码编辑器、CLI 智能体中工作，或通过自定义方式连接到数据库；还有一些人则在大多数探索过程中依赖 Anthropic Claude 这类通用 AI 助手。 这些用户以及代表他们执行操作的智能体工作负载，需要一种无需复杂配置或自建基础设施、即可安全访问和查询 ClickHouse Cloud 的方式。
ClickHouse Cloud 的远程 MCP 服务器能力正是为此而设计，它提供了一个标准接口，供外部智能体获取分析上下文。 MCP (即 Model Context Protocol) 是供基于 LLM 的 AI 应用访问结构化数据的标准。 借助这一集成，外部智能体可以列出数据库和表、检查 schema，并运行有范围限制的只读 SELECT 查询。 身份验证通过 OAuth 处理。该服务器由 ClickHouse Cloud 完全托管，因此无需任何设置或维护。
这让智能体工具更容易接入 ClickHouse 并获取所需数据，无论是用于分析、摘要、代码生成还是探索。
远程 MCP 服务器 与开源 MCP 服务器 对比
ClickHouse 提供两种 MCP 服务器。
| Remote MCP 服务器 (Cloud) | 开源 MCP 服务器 | |
|---|---|---|
| 来源 | 由 ClickHouse Cloud 完全托管 | GitHub 上的 mcp-clickhouse |
| 传输方式 | Streamable HTTP (https://mcp.clickhouse.cloud/mcp) |
本地 stdio |
| 适用范围 | ClickHouse Cloud 服务 | 任何 ClickHouse instance (自托管或 Cloud) |
| 身份验证 | 使用你的 Cloud credentials 进行 OAuth 2.0 身份验证 | 环境变量 |
| 工具 | 13 个工具，涵盖查询、schema 探索、服务管理、备份、ClickPipes 和计费 | 3 个工具：run_select_query、list_databases、list_tables |
| 设置 | 无需安装。将你的 MCP 客户端 指向该端点并完成身份验证即可。 | 在本地安装并运行 server |
远程 MCP 服务器为 ClickHouse Cloud 提供最完整的集成能力，包括服务管理、备份监控、ClickPipe 可见性和计费数据，且无需管理任何基础设施。 如需用于自托管 ClickHouse instance，请参阅开源 MCP 服务器 指南。
启用远程 MCP 服务器
远程 MCP 服务器必须按服务分别启用，启用后才能接受连接。 在 ClickHouse Cloud 控制台中，打开你的服务，点击 Connect 按钮，选择 MCP，然后将其启用。 如需查看带截图的详细步骤，请参阅设置指南。
端点
启用后，可通过以下地址访问远程 MCP 服务器：
https://mcp.clickhouse.cloud/mcp身份验证
对远程 MCP 服务器的所有访问均通过 OAuth 2.0 进行身份验证。 当 MCP 客户端首次连接时，会启动 OAuth 流程，并打开浏览器窗口，让用户使用其 ClickHouse Cloud 凭据登录。 访问范围仅限于该已通过身份验证的用户有权访问的组织和服务。无需额外配置 API 密钥。
安全性
远程 MCP 服务器提供的所有工具均为只读。每个工具在其 MCP 元数据中都标注了 readOnlyHint: true。没有任何工具可以修改数据、更改服务配置或执行任何破坏性操作。
可用工具
远程 MCP 服务器提供了 13 个工具，分为以下几类。
查询与 schema 探索
这些工具允许智能体发现有哪些可用数据，并运行分析查询。
| 工具 | 描述 | 参数 |
|---|---|---|
run_select_query |
对 ClickHouse 服务执行只读 SELECT 查询。 | query：有效的 ClickHouse SQL SELECT 查询；serviceId |
list_databases |
列出 ClickHouse 服务中所有可用的数据库。 | serviceId |
list_tables |
列出数据库中的所有表，包括列定义。 | serviceId；database；可选 like 或 notLike (用于过滤表名的 SQL LIKE 模式) |
组织
| Tool | 描述 | 参数 |
|---|---|---|
get_organizations |
获取经身份验证用户可访问的所有 ClickHouse Cloud 组织。 | 无 |
get_organization_details |
返回单个组织的详细信息。 | organizationId |
服务
| Tool | Description | Parameters |
|---|---|---|
get_services_list |
列出 ClickHouse Cloud 组织中的所有服务。 | organizationId |
get_service_details |
返回特定服务的详细信息。 | organizationId; serviceId |
备份
| 工具 | 说明 | 参数 |
|---|---|---|
list_service_backups |
列出某个 service 的所有备份，最新的排在最前面。 | organizationId; serviceId |
get_service_backup_details |
返回单个备份的详细信息。 | organizationId; serviceId; backupId |
get_service_backup_configuration |
返回某个 service 的备份配置 (计划和保留设置) 。 | organizationId; serviceId |
ClickPipes
| 工具 | 描述 | 参数 |
|---|---|---|
list_clickpipes |
列出某个服务已配置的所有 ClickPipes。 | organizationId; serviceId |
get_clickpipe |
返回指定 ClickPipe 的详细信息。 | organizationId; serviceId; clickPipeId |
计费
| 工具 | 说明 | 参数 |
|---|---|---|
get_organization_cost |
获取组织的计费和使用成本数据。返回总计以及按天统计的各实体成本记录。 | organizationId；可选 from_date 和 to_date (YYYY-MM-DD，最长 31 天) |
快速入门
有关如何启用远程 MCP 服务器并将其连接到 MCP 客户端的分步说明，请参阅设置指南。