MCP 接入与工具治理

01MCP 解决什么问题

MCP 提供连接工具与数据源的标准方式。Claude Code 可以发现服务器公开的工具，再根据任务调用。它适合连接文档、内部服务和开发系统。

协议兼容不等于服务可信。服务器运行位置、工具权限、身份凭证和数据处理方式都需要独立评估。

02从一个只读场景开始

先选择来源明确、文档完整的服务器，按该服务器的官方配置指定传输方式与认证。接入后用 /mcp 查看连接状态和工具列表。

• 核对服务器来源、维护者、版本和所需权限。
• 测试一个只读查询，确认返回结果符合预期。
• 项目配置可以共享，凭证应从安全的运行环境注入。

claude mcp list
# 在 Claude Code 会话中查看服务器状态
/mcp

03工具不可用时怎么定位

先分清是服务器启动失败、认证过期、工具未发现，还是调用本身失败。查看服务器日志时遮盖凭证与业务数据，避免把整个请求直接贴到公共讨论。

把工具数量控制在真正需要的范围。重复、模糊命名的工具会增加选择成本，优先保留职责明确且输出稳定的工具。

04远程 HTTP 服务器的配置形式

下方展示命令结构，example.com 是占位域名，必须替换成服务器提供的真实 MCP 地址。只有在确定需要共享给项目成员时才使用 --scope project。

命令执行后检查项目配置 diff，再在会话中完成服务器需要的认证；不要因为服务器出现在列表里就认为全部工具已经可以调用。

claude mcp add --transport http --scope project team-docs https://mcp.example.com/mcp
claude mcp list

05用一个问题验证接入质量

选择答案已知的只读问题，例如读取测试文档的标题。检查工具是否调用了正确服务器、返回字段是否可解释，以及失败时是否给出了真实错误。

• 网络失败：确认地址、代理、证书和服务器状态。
• 认证失败：查看服务器的登录或令牌更新要求。
• 空结果：确认账户有目标资源权限。
• 写操作：在明确了解效果之前，不把它作为连通性测试。