跳转到内容

MCP 工具

「MCP」页管理你配置的 MCP(Model Context Protocol)服务器。MCP 是一种让 GM 调用外部工具的标准协议,支持接入本地命令行程序或远程 HTTP 服务,为 GM 增加读取文件、查询 API、执行搜索等自定义能力。

入口:左侧导航栏「MCP」(路由:#mcp);移动端从「能力与反馈」顶部标签页切换至「MCP」。


关键概念

传输类型

每个 MCP 服务器需选择一种传输方式:

  • stdio · 本地命令:在当前机器上启动一个子进程,通过标准输入/输出通信。命令行格式如 uvx my-mcp 或完整的 shell 命令。
  • http · 远程 HTTP:连接远端已运行的 MCP HTTP 服务,填入完整 URL(例如 https://host:port)。

运行状态

卡片底部状态标签有三种:

  • 已连接:服务器已启用且平台确认正在运行。
  • 未连接:服务器已启用但当前无法连接(进程未启动或网络不通)。
  • 未启用:服务器已配置但开关处于关闭状态,GM 不会调用。

常见任务

添加 MCP 服务器

  1. 进入 MCP 页,点右上角「新增服务器」。
  2. 填写「名称」(显示名,必填)。
  3. 选择传输类型:「stdio · 本地命令」或「http · 远程 HTTP」。
  4. 填写「命令 / URL」(必填):stdio 填启动命令,http 填服务地址。
  5. 可选填「环境变量 / Headers」,每行一条,格式为 KEY=VALUE
  6. 点「校验并启用」,平台会保存配置并尝试连接校验。

启用或停用 MCP 服务器

找到对应服务器卡片,切换右上角的开关。

  • 启用时平台会自动尝试启动(stdio)或建立连接(http)。
  • 停用时平台会停止该服务器进程,GM 不再使用其工具。

编辑 MCP 服务器

点卡片右下角的编辑按钮,可修改名称、传输类型、命令/URL、环境变量或 Headers,修改后点「保存」。

删除 MCP 服务器

点卡片右下角的删除按钮,确认后该配置会被永久移除,不可撤销。

查看运行日志

点卡片右下角的日志按钮,查看该服务器的运行时状态(进程 pid、最近 stderr 输出)。可点「导出」将日志下载为文本文件。管理员权限可见完整 stderr;普通用户可能只看到状态摘要。

批量校验

点页面右上角的「校验」按钮,平台会对所有已启用的服务器逐一发起连接校验,完成后以 toast 显示成功/失败数量。


常见问题

GM 没有调用 MCP 工具? 确认:① 对应服务器开关已打开;② 卡片状态显示「已连接」而非「未连接」;③ 当前使用的模型支持工具调用能力(部分轻量模型不支持);④ stdio 模式下本机已安装所需命令(如 uvx)且可执行。

添加后状态一直显示「未连接」? stdio 模式:检查命令能否在终端直接运行;http 模式:确认目标地址可从服务器侧访问且未被防火墙拦截。可点「校验」按钮重试,也可查看日志获取具体错误信息。

环境变量怎么填? 每行一条,格式 KEY=VALUE,例如:

API_KEY=sk-xxxxx
BASE_URL=https://api.example.com

http 模式下可在「Headers」字段以 JSON 格式填写请求头,例如 {"Authorization":"Bearer xxx"}


相关