跳到主要内容

MCP 使用手册

本页总结 SkillFlaw 面向用户的 Model Context Protocol(MCP)使用方式。

结合产品结构与既有文档,SkillFlaw 参与 MCP 的方式主要有两类:

  • 作为 MCP Server
  • 在流程内部作为 MCP Client 使用外部 MCP 能力

页面示例

下图展示的是产品中的 MCP 页面。 页面中可以看到操作指引、MCP开发MCP广场 页签、筛选条件,以及新增 MCP 服务器资源的入口。

MCP 页面

新增 MCP 服务器弹窗

新增 MCP 服务器弹窗

在 MCP 页面点击 新增 MCP 服务器 后,可以打开新增弹窗。弹窗提供以下三类可见配置页签:

  • JSON
  • STDIO
  • Streamable HTTP/SSE

弹窗中可见的关键配置区域包括:

  • 资源范围
  • 访问类型
  • 状态
  • 名称
  • Logo
  • 备注

对于 JSON 导入方式,页面提示会沿用各服务器自身的连接配置,并统一应用当前选择的资源范围与启用状态。

MCP 服务器使用路径

较常见的产品路径,是把工作流暴露为 MCP 工具,供外部 MCP 客户端调用。

新增 MCP 服务器弹窗中直接可见的接入方式包括:

  • STDIO
  • Streamable HTTP/SSE
  • JSON 配置导入

用户操作主链路

从用户视角看,基本流程是:

  1. 准备一个可暴露为工具的工作流
  2. 确保流程中包含 Chat Output 组件
  3. 使用 SkillFlaw 提供的 MCP Server 端点
  4. 把 MCP 客户端连接到该端点
  5. 对暴露出的工具进行测试与调试

工具命名与说明

当用户把工作流暴露为 MCP 工具时,工具名称和说明就成为对外契约的一部分。 清晰的命名有助于外部 Agent 更准确地选择正确工具。

因此,用户需要把以下信息视为稳定接口的一部分:

  • 流程名称
  • 流程说明
  • 暴露动作的实际语义

测试与调试

当前推荐使用 MCP Inspector 或其他兼容 MCP 的客户端来测试。 这样用户可以:

  • 验证传输连接是否正常
  • 确认有哪些工具已注册
  • 测试请求与响应行为
  • 调试鉴权相关问题

认证边界

MCP 端点复用 SkillFlaw API 的认证边界。 如果系统开启了认证,用户需要使用认证会话或 SkillFlaw API Key 才能访问 MCP 端点。

相关页面