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 服务器
- 进入 MCP 页,点右上角「新增服务器」。
- 填写「名称」(显示名,必填)。
- 选择传输类型:「stdio · 本地命令」或「http · 远程 HTTP」。
- 填写「命令 / URL」(必填):stdio 填启动命令,http 填服务地址。
- 可选填「环境变量 / Headers」,每行一条,格式为
KEY=VALUE。 - 点「校验并启用」,平台会保存配置并尝试连接校验。
启用或停用 MCP 服务器
找到对应服务器卡片,切换右上角的开关。
- 启用时平台会自动尝试启动(stdio)或建立连接(http)。
- 停用时平台会停止该服务器进程,GM 不再使用其工具。
编辑 MCP 服务器
点卡片右下角的编辑按钮,可修改名称、传输类型、命令/URL、环境变量或 Headers,修改后点「保存」。
删除 MCP 服务器
点卡片右下角的删除按钮,确认后该配置会被永久移除,不可撤销。
查看运行日志
点卡片右下角的日志按钮,查看该服务器的运行时状态(进程 pid、最近 stderr 输出)。可点「导出」将日志下载为文本文件。管理员权限可见完整 stderr;普通用户可能只看到状态摘要。
批量校验
点页面右上角的「校验」按钮,平台会对所有已启用的服务器逐一发起连接校验,完成后以 toast 显示成功/失败数量。
常见问题
GM 没有调用 MCP 工具?
确认:① 对应服务器开关已打开;② 卡片状态显示「已连接」而非「未连接」;③ 当前使用的模型支持工具调用能力(部分轻量模型不支持);④ stdio 模式下本机已安装所需命令(如 uvx)且可执行。
添加后状态一直显示「未连接」? stdio 模式:检查命令能否在终端直接运行;http 模式:确认目标地址可从服务器侧访问且未被防火墙拦截。可点「校验」按钮重试,也可查看日志获取具体错误信息。
环境变量怎么填?
每行一条,格式 KEY=VALUE,例如:
API_KEY=sk-xxxxxBASE_URL=https://api.example.comhttp 模式下可在「Headers」字段以 JSON 格式填写请求头,例如 {"Authorization":"Bearer xxx"}。