Cloud 中的远程 MCP - ClickHouse Documentation

并非所有用户都通过 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 客户端的分步说明，请参阅设置指南。

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

​启用远程 MCP 服务器

​端点

​身份验证

​安全性

​可用工具

​查询与 schema 探索

​组织

​服务

​备份

​ClickPipes

​计费

​快速入门