主题
MCP 服务
本章回答：MCP 服务是什么，以及 lite 版和标准版分别怎么把 MCP 用起来。
MCP（Model Context Protocol）服务是一种标准化的能力接入方式，通过它可以把外部工具 / 服务以「工具集」的形式提供给智能体调用，扩展智能体的能力边界。
MCP 接入点统一由 资源管理 → MCP 服务 创建和维护（配置接入名称、类型、服务地址、认证密钥等）。在产品配置中，lite 版和标准版使用 MCP 的方式不同：
| 版本 | 使用方式 | 粒度 |
|---|---|---|
| lite 版 | 在默认智能体的「MCP 服务」区域整体挂载一个 MCP 接入点 | 服务级 |
| 标准版 | 在「自定义提示词型技能」内部关联具体的 MCP 工具（Tool） | 工具级 |
1. lite 版：挂载 MCP 服务
⚠ 「MCP 服务」挂载区域为 lite 版专属；标准版不在此处挂载，而是走下方的「技能内关联 MCP」。
1.1 能力说明
- 在产品配置的「MCP 服务」区域，只做「挂载启用」——把已创建的 MCP 接入点关联到当前产品的默认智能体；
- 挂载后，智能体即可在对话中调用该 MCP 服务暴露的工具。
配置入口： 产品管理 → 点击目标产品卡片（lite 版）进入产品配置 → 编辑默认智能体 → MCP 服务区域
1.2 操作方式
- 进入「产品管理」→ 点击目标 lite 版产品卡片进入产品配置 → 编辑默认智能体；
- 找到「MCP 服务」区域；
- 点击「+ 添加 MCP 服务」，从已创建的 MCP 接入点中选择需要的服务添加进来；
- 如需移除，点击对应 MCP 服务卡片上的删除按钮即可。
⚠ 若列表中没有可选的 MCP 服务，请先到 资源管理 → MCP 服务 创建 MCP 接入点。
1.3 注意事项
- 先创建、再挂载：MCP 接入点必须在资源管理中先创建，才能在产品配置中被选择；
- 状态需可用：只有状态正常、工具已成功拉取的 MCP 接入点才能被智能体调用；
- 按需挂载：仅挂载当前产品确实需要的 MCP 服务，避免无关工具干扰意图判断。
2. 标准版：在自定义技能里关联 MCP 工具
标准版没有独立的「MCP 服务」挂载区域，而是在「自定义提示词型技能」内部关联具体的 MCP 工具，让技能在提示词驱动下调用这些工具，粒度更细。
入口：产品管理 → 点击目标产品卡片（标准版）→ 产品配置 → 编辑智能体 → 技能区域
2.1 添加自定义技能的两种方式
标准版智能体「技能」区域提供两级添加入口：「+ 添加系统技能」与「+ 添加自定义技能」。点击「+ 添加自定义技能」后，出现两个平级入口：
| 入口 | 说明 |
|---|---|
| 空白新建 | 直接新建一个自定义技能，右侧弹出技能配置抽屉，从零填写 |
| 从模版新建 | 从技能模版中选择一个模版，在当前产品下生成一份独立副本，基于模版内容预填后再编辑（与技能库中的原模版互不影响） |
💡 「从模版新建」仅在技能库中已存在自定义技能模版时出现；若技能库为空（尚未创建任何自定义技能模版），则只显示「空白新建」一个入口。
2.2 选择技能类型
点击「空白新建」后，右侧弹出技能配置抽屉，首先选择技能类型：
| 技能类型 | 说明 | 是否支持关联 MCP |
|---|---|---|
| 自定义提示词型 | 平台内置大模型按提示词生成回复 | 支持「关联 MCP」 |
| 第三方服务型 | 转发到外部 Agent 的 API，由 Agent 直接返回结果 | 不涉及关联 MCP |
自定义技能的完整字段、意图识别配置等详见 资源管理 · 自定义技能。
2.3 关联 MCP
「关联 MCP」仅在自定义提示词型下出现。点击「请选择需要关联的 MCP 服务…」下拉框，在弹出的列表中勾选需要的 MCP 服务或其下的具体工具（Tool）即可：
- 可勾选整个 MCP 服务（自动选中它下面的全部工具），也可以展开后只勾选需要的单个工具；
- 已选的工具会以标签形式展示，点标签上的
✕即可移除； - 当前仅支持云端 MCP 服务返回的内容。
⚠ 只有在 资源管理 → MCP 服务 中标记为「公开」的服务及工具，才会出现在这里可供选择。
💡 若资源管理中没有创建 MCP 服务，或已创建但未标记「公开」，此下拉框会显示「暂无数据」——请先到 资源管理 → MCP 服务 创建并公开对应服务。
2.4 变量插入
点击提示词编辑区的「变量」图标，弹窗左侧可切换「系统变量」与「工具变量」两个页签：
| 变量类型 | 说明 |
|---|---|
| 系统变量 | 平台内置的运行时变量，如长期记忆 ${memoBaseContent}、系统时间 ${systemTime}、设备地点 ${location}，勾选后自动插入占位符 |
| 工具变量 | 已在「关联 MCP」中勾选的工具对应的返回值占位符，形如 $[MCP服务名/工具名]，勾选后插入提示词中，一次插入一个 |
💡 工具变量与「关联 MCP」的选择结果同步： 「工具变量」页签仅列出已在「关联 MCP」中勾选的工具，二者保持同步；若未勾选任何工具，该页签内容为空。
「工具变量」页签顶部提供「搜索服务或工具名」输入框，方便快速检索需要插入的工具变量。
3. Q&A
Q：lite 版和标准版用 MCP 有什么区别？ A：lite 版是把整个 MCP 接入点直接挂到默认智能体上（服务级）；标准版是在「自定义提示词型技能」内部关联具体的 MCP 工具（工具级），粒度更细。
Q：为什么下拉/列表里看不到我创建的 MCP 服务？ A：标准版只显示在 资源管理 → MCP 服务 中标记为「公开」且状态正常的服务及工具；lite 版则需先在资源管理中创建好 MCP 接入点。
Q：第三方服务型能关联 MCP 吗？ A：不能。「关联 MCP」与「工具变量」仅在自定义提示词型下提供。
下一步
- 创建与管理 MCP 接入点 → MCP 服务（资源管理）
- 创建与管理技能模版 → 技能库（模版库）
- 自定义技能详细字段 → 自定义技能
- 配置技能 → 技能配置
- 回到产品配置总览 → 产品管理