> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP 服务器

> 将第三方 MCP 服务器连接到 ClickHouse agent

[Beta 版功能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

Model Context Protocol (MCP) 是一种开放标准，用于向 AI 模型提供工具和数据源。将 MCP 服务器 连接到 ClickHouse agent 后，agent 就可以访问该 server 所公开的任何能力——无论是问题跟踪系统、可观测性 backend、内部 API、第三方 SaaS，还是任何其他带有 MCP 端点的服务。

## 添加 MCP 服务器

在智能体构建器中，打开 **MCP 服务器** 部分并点击 **Add server**。输入该 server 的 URL 和身份验证设置，然后选择希望此 agent 使用的该 server 工具。保存 agent。

你可以为一个 agent 添加多个 server。agent 调用的每个工具都会记录在会话中，以便用户查看 agent 执行了哪些操作。

## 传输

ClickHouse 智能体采用 Streamable HTTP——这是适用于生产环境的 MCP 传输方式。你连接的服务器必须能让 ClickHouse Cloud 通过 HTTP(S) 访问。

## 身份验证

MCP 服务器可能会要求提供凭据。ClickHouse 智能体支持：

* **Bearer 令牌** 和其他静态请求头 - 即你在配置服务器时提供的固定值。
* **OAuth 2.0** - 交互式流程。首次由你 (或任何有访问权限的用户) 调用服务器上的工具时，浏览器会打开登录窗口；令牌会自动管理和刷新。
* **按用户区分的凭据** - 服务器配置中的变量会从调用用户的 profile 中替换，因此每个用户都会使用自己的身份进行身份验证，而不是共用一个服务账号。

用户提供的凭据会加密存储，并且仅限输入这些凭据的用户使用。某个用户的凭据绝不会出现在另一位用户的智能体运行中。

## 限制

单次 agent 运行最多可引用 50 个不同的 MCP 服务器目标，并且每个请求最多可包含 100 个扩展工具配置。如需更多，应拆分为[子智能体](https://clickhouse.com/docs/zh/agents/builder/subagents.md)。
