MCP 连接与验证
只在任务确实需要外部工具时添加 MCP 服务，并以客户端连接测试和可见工具作为完成条件。
MCP、连接器和技能解决的问题不同：连接器强调对外部系统的授权状态；技能是一套可重复步骤；MCP 服务向 Agent 提供可以调用的工具。保存配置只说明客户端记住了它，不说明服务已经可用。
- 只使用可信服务方提供的 MCP 配置，并确认你有权连接其中的系统和数据。
- 配置必须是有效 JSON，顶层包含
mcpServers；不要把命令和全部参数塞进一个无法核对的字符串。 - 先删除示例中的真实 Token、客户地址或个人目录，再把配置用于演示或反馈。
- 打开客户端“设置”，在左侧选择“能力扩展”，找到“MCP 工具配置”。
- 选择“添加 MCP 服务”。有已检测 Agent 时，可以选择“从 JSON 导入”或“从 Agents 导入”；不确定时使用服务方给出的标准 JSON。
- 检查顶层
mcpServers、服务名称、传输方式、命令或 URL，以及必要参数。确认后导入。 - 添加后等待客户端自动检测；也可以在服务卡片上选择“检测 MCP 可用状态”。
- HTTP、SSE 或 Streamable HTTP 服务提示需要认证时，选择“登录”，完成授权后重新检测。
- 展开服务卡片，确认状态为“可用”，并能看到服务返回的工具列表。
- 新建会话后再使用新添加的 MCP。正在运行的会话继续使用创建时的 MCP 集合。
| 状态 | 含义 | 是否完成 |
|---|---|---|
| “未测试” | 配置已经保存，但还没有可用性证据 | 否 |
| “测试中” | 客户端正在启动或连接服务 | 等待 |
| “可用” | 已完成连接或握手，并取得工具信息 | 是 |
| “最近一次测试失败” | 命令、权限、网络、HTTP、RPC 或协议至少一项失败 | 否 |
| 需要认证 | 服务要求用户完成登录或授权 | 登录后重测 |
只有“可用”并且工具列表符合预期，才表示当前客户端真的可以使用该服务。
提示未找到命令或权限被拒绝
Section titled “提示未找到命令或权限被拒绝”确认命令来自可信安装，并按错误原文核对 Node、Bun、uv、Python 或其他运行时。不要从聊天记录执行来源不明的安装命令，也不要关闭系统安全能力。
提示超时、无法连接或 HTTP 错误
Section titled “提示超时、无法连接或 HTTP 错误”检查网络、服务地址和组织代理，保留完整状态码。不要用内部地址或真实凭据制作公开截图。
提示无法完成 MCP 握手
Section titled “提示无法完成 MCP 握手”这表示进程或端点存在，但协议没有完成。核对服务版本、传输方式和配置格式；配置“存在”不能替代重新检测。