使用指南2026 年 11 月 1 日

如何把 Skills 与 MCP Server 接入好易智能体？

使用指南 / USER GUIDE

把 Skills 与 MCP Server 接入好易智能体，只有一处落点——智能体 Agent 节点的「资源」。两者作用不同：Skills 把一套稳定的任务方法与步骤封装成能力包，MCP Server 把外部系统的能力接成智能体可调用的工具。接入顺序也不同：MCP Server 必须先在「MCP」分区创建、通过校验并打开启用开关，之后节点里才选得到；Skills 则在「Skills」分区新建后，直接在节点的「选择资源」里勾选。

好易智算（Haoee）是 AI 服务要素平台。把模型、智能体、数据与能力集合组织成可以创建、运行、发布、运营和持续演进的 AI 服务。其中，数据与能力集合在目前阶段 AI 的基础概念上集中体现为知识库、Skills、MCP Server。

01 先分清 Skills 与 MCP Server

两者不是替代关系：一个装「方法」，一个接「工具」。

对比项	Skills	MCP Server
本质	把稳定方法与处理步骤封装成可复用能力	把外部系统能力接成智能体可调用的工具
形态	一个能力包（含清单与脚本）	一个服务（含地址与传输方式）
典型用途	表格分析：固定字段识别、筛选、统计、输出的步骤	文件识别：提供读取文件、返回解析结果的工具
接入前置	新建后打开启用开关	创建 → 校验 → 启用，缺一不可

02 在 MCP 分区创建 MCP Server

工作台顶部这排「智能体／知识库／Skills／MCP」是同一套资源的四个分区，MCP Server 在「MCP」里建，不在独立菜单里。

工作台顶部四个分区：智能体、知识库、Skills、MCP

图 1 · Skills 与 MCP 是同一排里的两个分区

切到「MCP」分区，右上角是「+ 添加 MCP」；旁边的「管理」用于批量维护。

MCP 分区列表，右上为添加 MCP，卡片上有校验状态与启用开关

图 2 · 右上「+ 添加 MCP」；卡片上同时有校验徽章与启用开关

点「+ 添加 MCP」打开「创建MCP server」弹窗，只有三个字段：名称（30 字以内）、描述（200 字以内）、MCP 配置 JSON（4000 字以内）。配置 JSON 支持的传输类型只有两种：Streamable HTTP 与 SSE。

创建 MCP server 弹窗：名称、描述、MCP 配置 JSON，底部有保存与校验并保存

图 3 · 三个字段：名称、描述、MCP 配置 JSON

配置 JSON 是一个 mcpServers 对象，里面只放一个服务：

{
  "mcpServers": {
    "服务名": {
      "url": "https://服务地址/mcp",
      "headers": { "Authorization": "Bearer 你的令牌" }
    }
  }
}

不需要鉴权的服务，把 headers 去掉即可。地址与鉴权方式以服务提供方给出的配置为准，不要自行拼造。

03 校验并启用

弹窗底部两个按钮的区别很关键：

保存：只落库，不做校验，列表里显示「未校验」
校验并保存：保存的同时做一次连通校验，通过后显示「校验通过」

同一个列表里已校验通过与未校验两种状态

图 4 · A 已校验通过，B 未校验

校验通过后，还要把卡片右侧的开关打开，服务才算启用。顺序不能反：只开了开关、没校验，节点里照样调不通。

04 把 MCP Server 绑到 Agent 节点

回到智能体编排页，单击画布上的 Agent 节点，左侧出现该节点的配置，找到「资源」并点添加（+），打开「选择资源」弹窗。弹窗里分 Skills／MCP／知识库三类，切到「MCP」，在一个服务上点「选择」，再点「确定」。

选择资源弹窗：Skills、MCP、知识库三个页签

图 5 · 「选择资源」弹窗，切到 MCP 页签按服务勾选

弹窗顶部可以按「全部／非授权资源／授权资源」筛选。跨空间授权给你的资源，就在「授权资源」里。

05 新建 Skill 并绑定

Skills 的入口在顶部「Skills」分区，右上角「新建」。

Skills 分区列表，右上为新建按钮，卡片带启用开关

图 6 · Skills 分区：新建入口与启用开关

能力包要包含一份清单文件 SKILL.md，写明名称、说明与入口命令，脚本放在包里；格式支持 .zip 与 .skill。

平台侧限制：zip 不超过 10MB，包内文件不超过 200 个，单文件解压后不超过 20MB，累计解压不超过 50MB。

建好之后回到节点，「资源」→「选择资源」→ 切到「Skills」→「选择」→「确定」，与 MCP Server 完全同一条路径。区别只有一点：Skills 没有「校验」这一步，卡片上的开关就是启用与停用。

06 常见问题

Q：MCP Server 保存了，但智能体的资源里选不到？ 先看徽章：显示「未校验」，说明当时只点了「保存」；显示「校验通过」但开关是灰的，说明还没启用。补齐这两步再回节点选。

Q：支持 STDIO 类型吗？ 创建弹窗只标注 Streamable HTTP 与 SSE 两种传输类型。

Q：Skills 与 MCP Server 能绑在同一个节点上吗？ 能。在「选择资源」里它们是并列的三类中的两类，作用不同，互不替代。

Q：一个 MCP 服务里有多个工具，要逐个授权吗？ 不用。「选择资源」里按服务勾选，一个服务一条。

Q：Skill 包超过 10MB 怎么办？ 拆包。zip 上限 10MB，包内文件数与累计解压体积也都有上限。

Q：绑完资源要不要重新发布？ 要。编排改动要保存并发布，线上生效的是发布后的版本。