MCP 连接

MCP 连接用于把一组已经定义好的远程工具交给多个助手。例如，工单系统提供“查工单、加备注、变更状态”三个工具，助手无需理解该系统的全部 HTTP API。

MCP 连接适用范围

情况	更合适的选择
服务方已提供 MCP，多个助手复用	MCP 连接
只有一个简单 HTTP 请求	技能中的 HTTP 请求
每位员工以本人身份操作	MCP 连接 + 使用者运行配置
所有使用者共用一个企业服务账号	MCP 连接 + 由企业维护者设置的助手默认配置值

连接与请求路径

助手 ──▶ 团子AI MCP 网关 ──注入当次凭据──▶ 远程 MCP 服务

连接支持 HTTP、Streamable HTTP 和 SSE 传输。服务地址、非敏感固定头和查询参数保存在连接定义中；Authorization、Cookie、X-Api-Key 等鉴权值必须通过运行配置提供。

连接预览用于检查服务可达性和工具结构，预览动作本身不会保存。保存后，连接定义和工具快照进入助手草稿；发布助手时，它们固定在助手发布版本中。真实任务仍通过 MCP 网关重新连接并注入当次有效凭据。

配置值轮换

密钥与连接定义、发布内容和对话分开保存。轮换后，后续请求立即使用新值；撤销后旧连接失效，不会沿用另一份凭据。

发布策略要求助手提供固定或可覆盖默认值时，发布前必须存在由企业维护者设置的有效默认配置值；由使用者自行提供的策略会在对话中显示配置卡。

权限与使用者身份

MCP 连接没有独立的资源权限。成员通过助手的使用权运行发布版本中的连接；编辑连接定义、工具快照或配置策略，需要该助手的更新权。网关检查地址、重定向和鉴权注入；远程服务的数据正确性和可用性由服务方负责。

预览成功，真实对话失败

常见原因是预览身份与实际使用者凭据不一致。排障时记录传输类型、服务错误码、配置值来源，以及是否发生重定向或超时。排障信息中禁止包含真实密钥。

文档站 MCP

团子AI文档站提供公开只读 MCP。支持 MCP 的客户端可以搜索官方文档、读取指定章节，并把对应网页作为答案来源。连接地址是当前文档站域名的 /mcp 路径，例如 https://docs.example.com/mcp。

该服务无需登录，只能读取已公开文档，不能修改产品数据或访问企业、个人知识库。服务提供以下工具：

• search_product_docs：按问题、文档集合、角色、产品领域或文档类型搜索章节；
• get_product_doc：按稳定文档 ID、slug 或章节 ID 读取 Markdown；
• list_product_docs：分页浏览公开文档目录。

资源包括 tuanzi-docs://index 和 tuanzi-docs://documents/{docId}。

工具结果包含网页地址、稳定文档与章节 ID、发布标识和语料哈希。客户端应引用网页；依据不足时明确说明无法确认。调用限制见《协议与资源限制》。