AI 助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
扣子 3.0 都有什么新特性?
扣子和扣子编程有什么区别?
扣子如何收费?
文档反馈
快速开始
使用扣子
工作方式
Agent 装备
和扣子一起工作
开发扩展能力
管理与设置

MCP

什么是 MCP?

MCP(Model Context Protocol,模型上下文协议)是一种连接 Agent 与外部工具或服务的开放协议。为 Agent 添加 MCP 后,Agent 可以根据你的要求调用 MCP 提供的工具,完成查询信息、管理文件、操作第三方服务等任务。

例如,为 Agent 添加扣子文档 MCP 后,你可以让 Agent 查找、读取并整理扣子官方产品文档。

安全提示

警告

MCP 服务由相应服务提供方提供和维护,其服务可用性、返回内容及数据处理方式由服务提供方负责,扣子仅提供相关服务的接入能力,不参与第三方 MCP 服务的实际运营,也无法控制其服务可用性、运行状态、返回内容及数据处理行为。

使用过程中,第三方 MCP 可能根据你的操作和授权,接收你发送给 Agent 的相关内容,并调用相应的第三方服务。添加或使用 MCP 前,请确认服务来源可信,充分了解相关服务的数据处理规则,并仔细核对授权范围和配置信息。

限制说明

  • 目前支持 Streamable HTTP 和 SSE 协议,暂不支持 STDIO 协议。
  • 仅网页和桌面端支持创建自定义 MCP;移动端可以查看和使用已经添加的 MCP。
  • 为 Agent 启用多个 MCP,可能影响工具选择和回复效果,并增加 Token 和积分消耗。建议每个 Agent 最多启用 10 个 MCP。详细说明可参考常见问题

示例:连接并使用扣子文档 MCP

下面以扣子官方文档 MCP 为例,介绍如何为 Agent 添加 MCP 并在对话中使用。扣子官方文档 MCP Server 是扣子提供的开发者专用知识库服务,为 Agent 添加扣子文档 MCP 之后,Agent 可以查看、检索最新的扣子官方文档,帮助用户快速了解产品功能和使用方法。

  1. 获取扣子文档 MCP Server 地址。
    扣子官方文档的 MCP Server 的 HTTP URL 和 JSON 地址固定为:
    {
      "mcpServers": {
        "扣子": {
          "url": "https://docs.coze.cn/topic-api/mcp"
        }
      }
    }
    
    你也可以在扣子文档中心任意页面顶部展开折叠菜单,选择复制 MCP 配置
  2. 连接 MCP。
    打开你和扣子 Agent 的对话页面,将 MCP 配置粘贴到输入框,并请扣子 Agent 帮你连接并安装。
    例如发送以下指令:
    帮我连接并添加扣子产品文档 MCP
    {
      "mcpServers": {
        "扣子": {
          "url": "https://docs.coze.cn/topic-api/mcp"
        }
      }
    }
    
  3. 验证 MCP。
    进入已添加该 MCP 的 Agent 对话,发送一条指令,验证 MCP 是否可用。
    使用扣子文档 MCP 查找产品文档,总结一下会议旁听的功能怎么用?
    

添加 MCP

从扣子 MCP 商店添加 MCP

你可以从公共商店或当前企业、团队的 MCP 商店查找并添加 MCP。公共商店会展示 MCP 的介绍、可用工具和服务信息;企业或团队商店展示管理员或成员上架的 MCP。

  1. 下载并安装扣子桌面端,或访问扣子网页端
  2. 查找 MCP。
    从左侧导航栏进入扩展 > MCP,浏览列表或搜索 MCP。你可以打开 MCP 详情页,查看可用工具、鉴权方式、连接信息和安全提示。
  3. 连接 MCP。
    1. 单击 MCP 右侧的 +,或在详情页单击连接
    2. (可选)根据页面提示完成第三方授权或填写连接凭证。
      无需鉴权的 MCP 可以直接添加。
  4. 添加给 Agent。
    根据页面提示,选择一个或多个 Agent,然后确认添加。你也可以暂时跳过,MCP 会先保存到我的 MCP,后续你可以在这里按需为各个 Agent 添加这个 MCP。
  5. 验证 MCP。
    连接完成后,向 Agent 发送一条指令,验证 MCP 是否可用。

添加自定义 MCP

如果商店中没有需要的服务,你可以在桌面端或网页端使用 MCP JSON 添加自定义 MCP。添加前,请从可信来源获取完整配置,并确认其中的服务地址、命令和凭证安全。

  1. 准备 MCP JSON。
    一个 MCP JSON 可以包含一个或多个 MCP Server。系统会分别识别其中的 Server,分别连接和添加 MCP。
  2. 粘贴配置。
    从扣子左侧导航栏进入扩展 > MCP,在页面右上角单击添加自定义 MCP,然后粘贴完整的 MCP JSON。
  3. 设置 MCP 名称,并选择添加到我的 MCP
    MCP 配置识别通过后,你可以确认或修改自动识别的名称。确认后将保存到「我的 MCP」,不会默认自动添加到 Agent 或上架企业商店。
  4. 添加并绑定 Agent。
    进入我的 > 我的 MCP,点击指定的 MCP,展开 Agent 列表单击添加,将 MCP 添加给需要使用它的 Agent。
    你也可以从 Agent 设置页添加,或者在 Agent 对话中安装,MCP 会默认绑定当前 Agent。例如将扣子文档的 MCP 配置发送给扣子 Agent,用自然语言让它连接并安装。
    Image

在对话中使用 MCP

将 MCP 添加给 Agent 后,你只需在对话中说明要完成的任务,Agent 会根据你的意图自动选择并调用合适的 MCP。你也可以在指令中明确指定要使用的 MCP,帮助 Agent 更准确地选择工具。

示例:

使用扣子官方文档 MCP,查找会议旁听的相关文档,并总结具体使用步骤。

管理我的 MCP

进入我的 MCP,可以查看当前账号已经添加的 MCP,并管理它们与 Agent 的关系。

操作 说明

为 Agent 添加已连接的 MCP

将同一个 MCP 添加给一个或多个 Agent,无需重复保存鉴权凭证。

进入我的 > 我的 MCP,点击指定的 MCP,展开 Agent 列表单击添加

启用或停用 MCP

控制指定 Agent 是否加载该 MCP。修改从下一轮对话开始生效。

在 Agent 的设置 > 扩展能力 > MCP 页面中,开启或关闭某个 MCP 的开关。

为 Agent 移除 MCP

仅解除 MCP 与该 Agent 的绑定,不删除 MCP,也不影响其他 Agent。

进入我的 > 我的 MCP,点击指定的 MCP,展开 Agent 列表单击移除

删除 MCP

从当前账号删除 MCP,同时会解除它与你所有 Agent 的绑定。已上架到企业或团队商店的自定义 MCP,需要先下架。

进入我的 > 我的 MCP,点击指定的 MCP,单击 ··· > 删除 MCP

将自定义 MCP 上架到企业/团队商店

你可以将自己创建的自定义 MCP 提交到当前企业或团队的 MCP 商店,供其他成员安装。仅 MCP 的创建者可以提交;提交和上架管理仅支持 PC 端。

  1. 发起上架。
    1. 进入扩展 > 我的 > 我的 MCP,找到要上架的自定义 MCP。
    2. 单击 ··· > 上架到企业/团队 MCP 商店
  2. 填写上架信息。
    填写 MCP 图标和名称,检查 MCP JSON,并选择需要成员安装时自行填写的字段。
  3. (可选)提交审核。
    确认服务来源和配置安全后提交审核。如果企业或团队开启了 MCP 审核,需要等待管理员审核通过。默认情况下未开启审核,MCP 会直接上架。
  4. 管理已上架的 MCP。
    我的 MCP 中打开该 MCP 的菜单,进入企业或团队上架管理。你可以查看详情、更新信息或下架 MCP。
    下架后,新成员不能再安装;已经安装的成员仍可继续使用。删除已上架的 MCP 前,必须先将它下架。

热门 MCP 推荐

MCP 适用场景
麦当劳 麦当劳中国远程服务,支持门店与营养查询、点餐下单、优惠券、活动日历、积分商城及主题活动预约。
Notion Notion 托管 MCP 服务,用于搜索、读取和维护工作空间页面、数据库、评论与附件。
同花顺 iFinD·基金 提供基金筛选、基本资料、行情业绩、持有人、组合配置及管理人数据查询。
GitHub GitHub MCP 服务,为智能助手开放仓库、议题、拉取请求与代码协作能力。
滴滴出行 滴滴 MCP 服务,提供叫车预估、订单处理、司机位置、地点搜索与多方式路线规划。
百度地图 提供地理编码、地点检索、路线规划、天气和路况等地图能力。
天眼查 提供企业主体识别、工商画像、集团关系、风险合规、知识产权及经营信息查询。
百度网盘 让智能助手查询、整理、搜索、上传和分享百度网盘文件。
法研·法规知识库 法研开放平台法规知识库 MCP 服务,支持按法律名称、条号或自然语言精准及并发检索法条。

常见问题

为什么已经添加 MCP,Agent 仍然不能使用?

添加到我的 MCP不等于已经添加给 Agent。请进入我的 MCP或 Agent 设置页,确认 MCP 已与目标 Agent 绑定并启用。如果已经绑定,再检查连接状态和第三方服务权限。

为什么 MCP 显示“需重新连接”?

通常是连接凭证失效,或 MCP 的服务配置、鉴权方式发生了变化。单击重新连接,按照提示重新授权或填写凭证即可。原有 Agent 绑定关系会保留。

从 Agent 移除 MCP 和删除 MCP 有什么区别?

从 Agent 移除只会解除该 Agent 的绑定,不影响其他 Agent。删除 MCP 会从当前账号删除该 MCP,并解除它与你所有 Agent 的绑定。

企业或团队商店中的 MCP 下架后还能使用吗?

已经安装的成员可以继续使用,新成员不能再安装。

为什么不建议给一个 Agent 启用过多 MCP?

建议每个 Agent 最多启用 10 个 MCP。你也可以在对话前启用当前任务需要的 MCP,原因有两点:

  • MCP 太多,更难选择合适的工具。每个 MCP 都会向 Agent 提供一组工具。启用的 MCP 越多,Agent 需要判断的工具就越多,可能选错工具或降低回复效果。
  • MCP 列表占用更多上下文。​MCP 提供的工具名称、说明和参数等信息会作为上下文提供给模型。工具越多,占用的上下文越多,可能增加 Token 和积分消耗。

建议只启用当前任务需要的 MCP,不使用时可以先停用。