Skip to content

MCP 工具

在 MCP 工具模块中,您可以集中管理所有 MCP(Model Context Protocol)服务器与工具,支持自定义添加、注册表导入和社区导入等多种接入方式,完成连接配置、工具同步、健康监控以及社区共享。

MCP 工具页面包含两个并列页签:

  • 导入的服务:管理当前租户已接入的 MCP 服务,在此配置、监控和维护您的 MCP 服务。
  • 发布的服务:管理当前租户发布到社区的 MCP 服务,支持浏览、编辑和取消发布。

➕ 添加 MCP 服务

点击页面上的"添加 MCP 服务"按钮,打开添加弹窗。弹窗提供三个页签,对应不同的接入来源。

自定义添加

"自定义添加"页签支持手动配置 MCP 服务,分为两种传输类型。

通过 URL 添加

适用于已有独立部署的 MCP 服务(支持 HTTP / SSE 协议),通过输入端点 URL 直接接入。

  1. 在"本地添加"页签中,传输类型选择"URL"
  2. 填写服务信息:
    • 服务名称(必填):为 MCP 服务设置一个易于识别的名称
    • 服务 URL(必填):输入 MCP 服务的端点地址
    • 描述:可选,填写服务的用途说明
    • Authorization Token:可选,若服务需要认证,在此填入 Bearer Token
  3. 点击"确定"完成添加,系统会自动连接服务并获取可用工具列表

通过容器配置添加

适用于需要本地容器化运行的 MCP 服务(如通过 npx 启动的服务),系统会根据您提供的 JSON 配置自动创建并管理容器。

  1. 在"本地添加"页签中,传输类型选择"容器"
  2. 填写容器配置信息:
    • 服务名称(必填):为 MCP 服务设置一个易于识别的名称
    • 描述:可选,填写服务的用途说明
    • 容器配置 JSON(必填):按标准 MCP 配置格式填写,例如:
      json
      {
        "mcpServers": {
          "service-name": {
            "args": ["mcp-package-name@version"],
            "command": "npx",
            "env": {
                 "API_KEY": "xxxx"
            }
          }
        }
      }
    • 端口号:填写容器服务暴露的端口,系统会自动检测端口冲突并提示可用端口
  3. 点击"确定",系统将解析 JSON 配置、创建容器并完成服务注册

从 MCP Registry 导入

Nexent 集成了 MCP Registry,您可以浏览并一键导入社区维护的 MCP 服务。

  1. 切换到"外部市场"页签
  2. 浏览可用的 MCP 服务列表,支持按名称或标签搜索
  3. 点击目标服务,查看服务详情(描述、版本、所需参数等)
  4. 配置必填参数(如 API Key 等环境变量)
  5. 点击"导入",系统会自动安装并配置该 MCP 服务

从社区导入

浏览其他用户在 Nexent 平台内发布的 MCP 服务,快速导入使用。

  1. 切换到"社区市场"页签
  2. 浏览社区已发布的 MCP 服务,支持按名称、标签或传输协议筛选
  3. 点击目标服务查看详情,点击"导入"即可添加到您的服务列表中

📋 导入的服务

"导入的服务"页签以卡片形式展示当前租户所有已接入的 MCP 服务,您可以在此查看、编辑、监控和发布。

查看与筛选

每张服务卡片展示以下信息:

  • 服务名称与描述
  • 来源标识(本地 / 注册表 / 社区)
  • 启用 / 禁用开关
  • 标签

您可以使用顶部的筛选栏,按来源传输类型标签进行过滤,也可以通过搜索框按名称快速定位服务。

编辑服务详情

点击任意服务卡片,打开详情弹窗,可以进行以下操作:

  • 编辑基本信息:修改服务名称、描述、URL、Authorization Token 和标签
  • 启用 / 禁用服务:通过开关控制服务的启用状态,禁用后该服务的工具将不会出现在智能体工具选择中
  • 删除服务:移除 MCP 服务记录,容器化服务会同步清理容器资源

查看工具列表

在服务详情弹窗中,点击"工具列表"按钮,可以查看该 MCP 服务提供的所有工具。

健康检查

点击详情弹窗中的"健康检查"按钮,系统会对 MCP 服务发起连接测试并返回当前状态:

  • 正常:服务可正常连接
  • 异常:服务无法连接或响应异常
  • 未检测:尚未进行健康检查

容器管理

对于容器化部署的 MCP 服务,详情弹窗中还提供以下操作:

  • 查看容器日志:实时查看运行中容器的输出日志,方便排查问题
  • 查看容器配置:查看创建容器时使用的配置 JSON

发布到社区

在服务详情弹窗中,点击"发布到社区"按钮:

  1. 确认或修改发布信息(名称、描述、标签等)
  2. 点击"确认发布",该服务将发布到社区
  3. 发布后其他用户可在添加服务的"社区市场"页签中浏览和导入

🌐 发布的服务

"发布的服务"页签展示您自己发布到社区的所有 MCP 服务,您可以在此集中管理已发布的内容。

每张卡片展示服务名称、描述、版本和标签,支持按名称、标签和传输协议进行筛选。

点击服务卡片可查看详细信息,您可以:

  • 编辑发布的服务:修改已发布服务的名称、描述和标签
  • 删除发布的服务:将服务从社区撤回,不再对其他用户可见

🔗 与智能体协作

添加 MCP 服务后,其提供的工具会自动同步到智能体的工具选择列表中。在 智能体开发 页面配置智能体时:

  1. 在"选择智能体的工具"页签下,找到对应 MCP 服务分组
  2. 点击工具名称即可启用该工具
  3. 可点击 ⚙️ 查看工具描述并进行参数配置

🚀 下一步

完成 MCP 服务配置后,建议您:

  1. 智能体开发 - 将 MCP 工具配置给智能体使用
  2. 智能体空间 - 查看智能体与 MCP 的协作关系
  3. 开始问答 - 在对话中体验智能体调用 MCP 工具的效果

如果您在使用过程中遇到任何问题,请参考我们的 常见问题 或在 GitHub Discussions 中进行提问获取支持。