JoyInside 产品使用文档

主题

MCP 服务 ​

MCP 服务是产品（lite 版）默认智能体可挂载的底层能力资源:所有 MCP 接入点必须先在这里创建,后续才能在 产品配置的 MCP 服务区域 挂载启用。

本章介绍如何创建和管理 MCP 接入点。

1. 什么是 MCP 服务 ​

MCP（Model Context Protocol） 是一种标准化协议,用于把外部工具 / 服务以「工具集」的形式提供给大模型调用。在平台内,一个 MCP 服务 描述了一个可连接的 MCP 服务端,平台连接成功后会自动拉取该服务暴露的工具列表,供智能体在对话中调用。

  • MCP 服务 ↔ 产品是 N : N 关系:一个MCP服务可被多个 lite 版产品挂载复用;一个产品可挂载多个 MCP 服务。

2. 新建 MCP 接入 ​

进入【资源管理 > MCP 服务】,点击【创建 MCP 接入】,弹窗中填写以下字段:

2.1 字段说明 ​

字段必填说明举例
MCP 接入名称必填内部识别用的名称天气查询服务
MCP 类型必选服务端支持的传输协议,二选一:Streamable HTTP / SSESSE
MCP 服务地址必填MCP 服务端的可访问地址https://localhost:3000/sse
认证密钥选填若服务端需要鉴权,填写对应密钥;无鉴权可不填-
描述选填补充说明该服务的用途提供实时天气查询工具

⚠ MCP 类型需与服务端一致:Streamable HTTP 与 SSE 是两种不同的传输方式,填写错误会导致连接失败、工具无法拉取。

3. 接入点列表 ​

创建后的 MCP 接入点在列表页统一管理,列表字段包括:

字段说明
MCP 服务接入点名称
描述创建时填写的描述
状态连接状态(是否可用)
工具从服务端拉取到的工具数量 / 列表
公开是否公开给其他成员使用
编辑时间最近一次修改时间

4. 注意事项 ​

  • 先创建、再挂载:MCP 接入点在此创建后,才能在 产品配置的 MCP 服务区域 中被选择挂载;
  • 状态需正常:只有连接成功、工具已成功拉取的接入点才能被智能体正常调用;若状态异常,请检查服务地址、类型与认证密钥是否正确;
  • 仅 lite 版可用:MCP 服务目前用于 lite 版产品的能力扩展,标准版通过技能 / 指令体系扩展能力。

下一步 ​