Claude Code MCP 集成
为 Claude Code 插件配置外部 MCP 服务与工具。
文档明确建议使用环境变量、HTTPS/WSS、最小化 allowed-tools，并禁止硬编码凭据；但对外部服务的数据流、权限边界、用户确认、撤销与回滚说明不完整，且 agent 被描述为可自主使用全部 MCP 工具，因此扣分。
配置示例、生命周期、错误处理和测试清单覆盖了常见路径；但静态材料未提供可执行测试，且“按需连接”与“插件启用时启动”等生命周期表述存在不一致，部分传输和配置行为未被证明，因此受静态上限约束并扣分。
名称、触发短语和 MCP 场景较明确，覆盖 stdio、SSE、HTTP 与 WebSocket；但非适用边界、版本兼容性和语义触发精度证据有限，文档仅英文，核心云端场景依赖海外服务，可能影响中国大陆可达性，因此扣分。
文档分层较清晰，包含概览、参考资料、示例、故障排查和工作流；但仅有 0.1.0 版本，没有变更日志、明确维护责任与更新路径，许可证信息由题设标为 unknown，且若干安装前提依赖 README 外部说明，因此扣分。
技能提供了可直接改写的配置片段、工具命名规则、安全建议和排错流程，能覆盖 MCP 集成核心任务；但没有文件内验证过的代表性结果，部分平台行为和示例服务可用性未经证明，仍需较多人工核验，因此未给满静态可得分。
源文件本身可审计，包含配置示例、检查清单和测试步骤；但没有提交的测试套件、CI 覆盖或第三方执行证据，关键行为主要是文档声明，因此仅给有限静态可验证分。
- 将 agent 的“全部 MCP 工具”访问视为高权限设计；发布前应限定工具集合，并为创建、更新、删除及外部写入操作增加明确确认和恢复方案。
- 需核实 Claude Code 当前版本是否支持文档所述 SSE、HTTP、WebSocket、headersHelper、生命周期和工具命名行为。
- 核心云端示例依赖海外域名；中国大陆用户可能遇到网络可达性、OAuth 回调或服务区域限制。
- 不要将调试日志、环境变量或错误输出中的令牌和敏感数据暴露给用户。
它能做什么 & 适用场景
该技能指导开发者把 Model Context Protocol（MCP）服务器集成到 Claude Code 插件中。内容涵盖 stdio、SSE、HTTP 和 WebSocket 四种连接方式，以及 OAuth、令牌和环境变量配置。它还说明如何使用 .mcp.json 或 plugin.json 配置服务器、在命令中允许 MCP 工具，并进行本地测试、调试和错误处理。适合需要让插件连接数据库、API、文件系统或云服务的 Claude Code 用户。
指导用户在插件根目录创建 .mcp.json，或在 plugin.json 中加入 mcpServers 配置；配置 command、args、env、url 和 headers 等字段；使用 ${CLAUDE_PLUGIN_ROOT} 和用户环境变量；根据 stdio、SSE、HTTP 或 WebSocket 选择服务器类型；在命令 frontmatter 中预授权具体 MCP 工具；通过 /mcp 查看服务器，并使用 claude --debug 检查连接、工具发现、认证和调用错误；提供连接失败、工具调用失败和配置错误的处理及验证清单。
- 插件开发者需要连接本地数据库、文件系统或自定义 MCP 服务器时，使用 stdio 配置本地进程。
- 需要把 Asana、GitHub 等托管服务接入插件，并通过 OAuth 登录时，使用 SSE 配置。
- 需要连接带 Bearer Token 的 REST API 或自定义 MCP 后端时，使用 HTTP 配置。
- 需要实时数据流、推送通知或低延迟双向通信时，使用 WebSocket 配置。
- 维护包含多个外部服务的插件，并希望限制命令可调用的 MCP 工具范围时，参考多服务器和权限配置模式。
优缺点一览
- 覆盖本地进程、托管服务、REST API 和实时 WebSocket 四类 MCP 连接方式。
- 包含 OAuth、环境变量令牌、工具命名、权限范围和错误处理建议。
- 提供从配置、测试到调试的完整实施流程，并强调使用 HTTPS/WSS 和避免提交凭据。
- 内容针对 Claude Code 插件机制，.mcp.json、plugin.json、/mcp 和 claude --debug 等做法不能直接视为通用 Agent Skills 流程。
- 源材料没有提供独立安装步骤、测试套件或实际可验证的示例项目。
- 技能没有说明许可证、费用或各类 MCP 服务器的具体兼容版本。
如何安装
该源材料没有提供此单个技能的独立安装命令。它位于 Claude Code 仓库的 plugins/plugin-dev/skills/mcp-integration/SKILL.md；仓库 README 说明可先安装 Claude Code，再进入项目目录运行 claude，但未说明如何单独安装或启用该技能。
如何使用
在 Claude Code 中提出类似“add MCP server”“integrate MCP”“configure MCP in plugin”或“use .mcp.json”的请求。实施时，在插件根目录创建 .mcp.json，选择 stdio、SSE、HTTP 或 ws 配置服务器，记录所需环境变量，在相关命令中预授权具体 mcp__plugin_... 工具，然后使用 /mcp 检查服务器并用 claude --debug 排查问题。