扩展与配置

连接与使用 MCP 工具

添加远程或本地 MCP 服务,检查连接与工具索引,再在任务中使用。

需要连接外部工具的桌面端用户约 7 分钟阅读
操作入口
设置 → MCP Servers;工作区更多工具 → MCP 工具
完成结果
服务显示已连接,工具索引中能找到目标工具,并完成一次小范围调用。
本篇目录

1. 准备服务信息

先确认服务提供方支持的传输方式,并准备可访问的测试服务。远程服务需要 MCP URL 与所需请求头;本地服务需要启动命令、参数及运行环境。普通网页地址不能当作 MCP 服务地址。市场提供的扩展也可从「设置 → 扩展市场 → MCP」查看说明并安装。

市场可安装提供远程 HTTP 连接或固定 npm 配置的 MCP。需要自行部署的服务会列出安装条件,不是所有市场条目都支持一键安装;访问和安装资源下载由服务端统一处理,受管理员配置的来源与下载开关控制。

1. 准备服务信息参考表
方式需要准备
远程 HTTP服务 URL、必要的 Headers;如需 OAuth,准备服务方给出的授权参数。
本地进程(stdio)本机命令、每行一个的参数、可选环境变量与工作目录。

2. 添加并保存连接配置

  1. 进入「设置 → MCP Servers」,点击「+ 添加」,填写便于辨认的服务名称并选择传输方式。
  2. 使用远程 HTTP 时填写你自己的测试服务 URL;Headers 每行填写 KEY=VALUE。使用本地进程时填写命令,参数每行一个,环境变量每行 KEY=VALUE。
  3. 点击「添加」。本地进程会显示启动确认,核对命令与参数后继续。
  4. 确认服务已启用,再点击面板顶部「保存配置」。出现「未保存」时,新增或修改尚未完成同步。

3. 确认连接和工具已经就绪

保存后点击「刷新状态」,检查服务是否显示「已连接」以及工具数量。连接仍在建立时可稍后刷新;仅看到服务名称不代表工具已可调用。需要 OAuth 的服务可在对应服务中填写授权地址、令牌地址、客户端 ID 和权限范围,打开浏览器完成授权后再检查状态。

码哥 MCP 设置界面,展示团队文档服务的连接配置与可用工具
MCP Servers 实际设置页:查看服务的已连接状态、工具数量与运行时索引,并通过刷新状态复核。画面中的团队文档服务与地址为演示配置。 真实产品界面 · 演示数据
  1. 从工作区「更多工具」打开「MCP 工具」,在 Servers 页查看服务状态与工具明细。
  2. 切换「工具」页按服务、名称或描述过滤;也可在「搜索」页用自然语言找工具。
  3. 发送一个范围清楚的测试任务,指明要使用的服务与预期结果,核对实际工具调用和返回内容。

4. 连接失败时按顺序检查

  • 配置未生效:先确认已点顶部「保存配置」,再刷新运行状态。
  • 远程连接失败:核对 MCP URL、网络、请求头和授权是否有效;普通接口可访问不等于 MCP 握手成功。
  • 本地进程失败:先在本机确认命令及依赖存在,逐项检查参数、环境变量与工作目录。
  • 连接正常但找不到工具:查看服务工具数量与工具详情,确认该服务确实提供目标能力。
  • 暂时不用某个服务:关闭启用状态并保存;需要移除时删除配置后再次保存。