插件与 MCP | LanSphere 使用手册

插件与 MCP

插件与 MCP 服务是蓝域(LanSphere)扩展能力的两大入口:插件为平台补充模型与工具,MCP 服务则让应用以标准协议调用外部系统的能力。借助两者,你编排的工作流、对话流与智能体可以连接大模型供应商、企业内部系统以及蓝信的协作能力。

本文介绍插件商店与系统插件的使用、自定义工具的创建、MCP 服务的接入与配置,以及平台预置的蓝信 MCP 工具集,适合开发人员与管理员阅读。

私有化部署说明

蓝域为私有化独立部署。插件商店提供的是官方维护的插件安装包,不连接外部社区市场;常用的模型插件与工具插件已内置,开箱即用。

插件商店

入口:左侧菜单 →「插件管理」→「从插件商店安装」。

插件分类

商店中的插件分为四类:

类型 说明
模型 接入大模型供应商,为应用与知识库提供模型能力
工具 提供可被工作流、智能体调用的具体功能
Agent 策略 面向智能体的策略类插件
扩展 其他平台能力扩展

浏览与详情

插件卡片包含图标、标题、开发商、描述与类型。点击卡片可打开详情弹窗,查看版本、开发商与富文本详细介绍。

安装与更新

插件按钮有三种状态:

  • 安装插件:尚未安装,点击即可安装。
  • 已安装:当前版本已就绪。
  • 更新插件:检测到新版本时显示,同时在「插件管理」页出现「新版本」标识,可一键「更新至 vX」。

权限

  • 商店浏览与安装:开发人员及以上角色。
  • 插件删除与 API Key 授权配置:管理员或所有者。

系统插件配置

已安装的插件在「插件管理」中进行启用、禁用与配置。以模型插件为例:

  1. 打开对应模型插件的配置页。
  2. 填写该供应商的 API Key。
  3. 启用所需的模型。

配置完成后,模型即可在「模型列表」与应用编排中选用。

自定义工具

当系统插件无法满足需求时,你可以将内部或第三方 API 封装为自定义工具,供工作流与智能体调用。

创建流程

  1. 基础信息:填写名称、类型与描述。
  2. 输入 / 输出参数:定义工具的入参与出参。
  3. 调用逻辑:配置 API 地址、请求方式与参数映射。
  4. 测试并保存:测试通过后保存,工具即可被调用。

列表支持「我创建的」筛选,便于定位本人创建的工具。

删除规则

  • 你可删除本人创建的工具,删除前需二次风险确认:工具被引用会导致关联应用异常。
  • 非本人创建的工具隐藏编辑入口;已删除工具的前端引用处会显示失效提示。

MCP 服务

MCP(Model Context Protocol)是让应用以标准协议调用外部系统能力的接口规范。通过 MCP 服务,你可以把外部系统封装为工具,在工作流与智能体中统一调用,而无需关心各系统接口细节。

入口:左侧菜单 →「MCP 服务」(该入口仅开发人员及以上角色可见)。

添加 MCP 服务

  1. 服务地址:填写 MCP 服务的访问地址。
  2. 授权配置:OAuth 动态客户端注册开关默认开启;如关闭,需将 OAuth 重定向 URL 配置为 /console/api/mcp/oauth/callback
  3. 请求头配置:按需添加自定义 HTTP Header,可配置多条。
  4. 基础配置:超时时间与 SSE 读取超时时间,不填则使用系统默认。

保存后服务即出现在列表中,支持「我创建的」筛选。

权限

  • 开发人员可创建 MCP 服务,并删除本人创建的服务。
  • 管理员可删除所有 MCP 服务。

蓝信 MCP 工具集

平台预置了蓝信 MCP 工具集,直接打通蓝信的协作能力,应用无需额外开发即可发消息、管群组、查通讯录、排日程、开会议、传文件。这是蓝域作为蓝信旗下平台的差异化能力,全部工具如下:

分组 工具
消息 发送私聊消息、发送群聊消息、发送应用通知消息、获取消息记录、撤回消息
群组 创建群、获取群详情、获取群成员、更新群成员
通讯录 获取人员基本信息、搜索人员
日程 获取主日历、创建日程、查询日程、更新日程、获取日程列表
视频会议 创建会议、拉取进行中与已预约会议列表、历史会议列表、会议录像列表及下载链接
媒体文件 上传媒体文件、下载媒体文件、获取下载路径

借助这组工具,你可以轻松实现诸如「定时汇总数据后推送到项目群」「按姓名找人并发送通知」「查询日程后自动创建会议」等政企办公场景,应用与组织协作流程天然衔接。

在工作流与智能体中使用 MCP 工具

MCP 服务添加完成后,即可在两类应用中调用其工具。

在工作流中调用

  1. 打开目标工作流的编排画布。
  2. 添加工具类节点,在四类工具中选择「MCP」。
  3. 在弹出的工具列表中选择目标服务与具体工具,完成节点配置。

工作流中的 MCP 调用是确定性的:流程运行到该节点时按配置执行,适合固定编排的自动化场景。

在智能体中调用

  1. 进入目标智能体的「应用开发 → 工具配置」。
  2. 选择「MCP 服务」分类,勾选所需服务与工具。
  3. 保存后,大模型将按用户意图自动决策调用时机。

智能体中的 MCP 调用是自主决策的:是否调用、调用哪个工具由大模型根据对话内容判断,适合开放式任务。

提示:「MCP 服务」菜单与智能体入口仅开发人员及以上角色可见;权限相关说明详见《成员与权限》。

相关阅读

  • 《SKILL 技能》:将 MCP 服务工具包装为技能,供智能体标准化复用。
  • 《工作流》:工具类节点与画布操作。
  • 《成员与权限》:插件安装删除与 API Key 配置的角色要求。