接入 MCP 服务并验证工具可用
通过 IDE 管理入口连接服务，确认工具列表，再执行一次小范围只读检查。
资料核验 / 更新于 · 8 分钟阅读
本次练习范围
连接一个外部服务，验证 Agent 能读取其中一项明确的信息。建议使用测试账号或示例项目，不要求购买特定服务；优先选择你已在使用、且能核对官方 MCP 配置说明的服务商。
1. 打开 IDE 的 MCP 管理入口
根据官方 MCP 文档，在 IDE Agent 面板点击 … → MCP Servers，选择支持的服务，按提示完成安装和认证。
自定义接入可通过 Manage MCP Servers → View raw config 查看配置。严格采用服务商提供的字段：本地进程与远程服务的连接方式不同。保留已有配置条目，不要直接覆盖整个文件。
在商店查找支持的接入，或进入 Manage MCP Servers 管理。图中的服务商来自官方示例，本教程不要求使用其中某一家。
官方示例截图（原图未修改） · 来源：Google Codelabs · CC BY 4.0 · 点击图片放大
选对连接方式
| 接入方式 | 先确认什么 | 故障常出现在哪里 |
|---|---|---|
| 商店支持的集成 | 服务商、账号、安装说明 | 登录与配置步骤。 |
| 本地 MCP 进程 | 所需运行时、程序路径、启动参数 | 进程启动或环境配置。 |
| 远程 MCP 地址 | 服务商提供的准确地址与认证方式 | 网络连接、会话或资源权限。 |
本地方式会在当前电脑启动进程，远程方式则连接外部服务。不要把启动命令填入网址字段，也不要假定所有服务都采用相同的认证字段。本教程以所选服务商当前的配置说明为准，不提供可能误导使用的“万能配置”。
编辑原始配置前，先私下保留现有设置副本。一次只添加一个服务，保存并刷新管理界面，检查工具是否出现后，再考虑下一个接入。
2. 选择一个容易核对的目标
准备一条你已知内容的测试工单、测试表的字段列表，或一篇文档，并记录其标识符。账号权限限定在练习需要的范围内，凭据不要粘贴到提示词或提交进代码仓库。
连接后检查工具列表。配置文件保存成功，不等于服务已经认证成功，也不等于它提供了本次需要的工具。
写一份不含密钥的连接记录
可以按下面的格式记录，凭据只留在对应配置或认证界面：
服务商或服务名称：[名称]
连接方式：[本地进程或远程地址]
测试工作区或项目：[标识符]
已知测试对象：[标识符]
预期标题或状态：[已在服务界面核对的值]
可用只读工具：[连接后实际显示的名称]工具名应以已安装服务实际返回的列表为准。相似服务可能提供不同工具，从别的教程抄一个名称并不能证明它存在。如果没有适合读取测试对象的工具，先解决能力不匹配，再继续验证。
3. 执行一次只读验证
根据所选服务和测试数据，修改以下本站练习提示词：
通过已连接的 MCP 服务检查下面指定的测试对象。
先说明哪个可用的只读工具适合本次任务。
只读取这一个对象，概括它的标题和当前状态。
报告使用的工具与对象标识符，方便我对照核验。
不要创建、更新、删除、部署或发送任何内容。
工具不可用或权限失败时，说明实际失败原因，不要猜测结果。
测试对象：[替换为测试对象的标识符]打开服务自身的界面，对照结果是否一致。先证明连接可用、作用范围正确，再把它用于更大的开发任务。
4. 按层排查故障
| 现象 | 优先检查 |
|---|---|
| 配置无法加载 | JSON 格式和服务商要求的字段 |
| 本地服务启动失败 | 运行环境是否安装、程序路径是否正确 |
| 已显示工具但请求失败 | 登录状态和资源访问权限 |
| 找不到需要的工具 | 服务能力和已启用的工具列表 |
| Agent 没有调用工具就回答 | 要求指出工具及实际返回的对象 |
确定故障发生在哪一层后再处理，不要不断重复安装。如果服务商更新了接入方式，应采用其当前说明，而不是照搬旧配置。
分清三种“成功”
- 配置加载成功： 管理界面识别了这个服务条目。
- 工具发现成功： 服务提供了适合本任务的工具。
- 数据读取正确： 实际调用返回了预期账号或项目里的指定对象。
三个条件都满足，才算完成本次连接验证。结果为空时，先比对对象标识符和项目范围；权限错误时，先在服务自身界面确认当前账号能访问那个具体对象。
验证通过后，可以继续尝试：
使用刚才已验证的只读工具，读取测试工单。
概括复现步骤，并指出哪些本地源码文件值得进一步检查。
不要修改工单或代码。
把服务返回的事实与建议调查的原因分开说明。这样可以把外部信息接到开发任务中，同时保持结果容易核对。实验配置失败需要移除时，只删除对应条目，保留其他已经可用的接入。
完成标准
你能明确指出：连接了哪个服务、调用了哪个工具、返回了哪个测试对象、使用了什么权限。验证通过后，再把一次只读查询加入实际任务，例如写查询前先核对表结构。
返回教程中心查看完整学习路径。