Claude 插件 MCP 集成指南
为 Claude Code 插件配置 MCP 服务器，连接外部服务并调用其工具。
文档明确建议使用环境变量、HTTPS/WSS、最小化工具白名单并避免提交凭据，且README提醒用户审查插件和MCP风险；但缺少系统化的数据流披露、用户确认、回滚/撤销方案和依赖锁定，示例中的npx -y及动态认证脚本也扩大了供应链与执行风险，因此扣分。
结构完整，包含配置、生命周期、错误处理、排错和测试清单；但存在启动时自动连接与按需连接的表述不一致，OAuth、HTTP、WebSocket能力等关键断言未由本地测试或提交的覆盖性测试验证，异常路径仍较概括，故静态评分受限。
frontmatter给出了较明确的触发短语，内容覆盖stdio、SSE、HTTP和WebSocket及多种场景；但非适用范围、版本兼容边界和语义误触发条件不充分，没有中文支持说明，也未证明在中国大陆网络环境下核心远程服务可达，因此扣分。
信息分层、示例和引用文件较充足，含版本号0.1.0；仓库提供Apache-2.0、官方归属和维护工作流证据。但该技能没有变更日志、兼容性矩阵、明确维护责任或更新路径，README要求由使用者补充环境变量文档，故未满分。
对开发者从选择传输类型到配置、认证、工具授权、错误处理和测试提供了可直接参考的模板，能覆盖核心集成任务；但配置语义和平台行为未在本文件中得到执行验证，示例可能需要按实际Claude Code版本或服务端调整，仍需较多人工审查，故受静态上限和不确定性扣分。
证据包括版本化技能文本、示例、引用文档及仓库CI，其中CI仅检查仓库内部分MCP URL存活，未覆盖该技能的关键配置和工具调用路径；没有第三方执行报告或独立复现结果，因此仅给有限静态可审计分。
- 文档中的OAuth自动处理、HTTP/SSE/WebSocket支持、工具命名和连接生命周期等断言应以目标Claude Code版本的官方文档和实际测试复核。
- 使用npx -y、未固定版本的包、python模块和headersHelper前，应固定依赖、审查来源并限制命令、环境变量、文件系统和网络权限。
- 远程MCP服务可能涉及敏感数据和跨境网络可达性；部署前应确认数据流、OAuth范围、服务端可信度、地区访问性以及写入/删除操作的用户确认和恢复方案。
它能做什么 & 适用场景
这是 anthropics/claude-plugins-official 仓库中 plugin-dev 插件的一项技能，专门指导在 Claude Code 插件内集成 Model Context Protocol 服务器。内容覆盖 .mcp.json 和 plugin.json 两种配置方式，以及 stdio、SSE、HTTP 和 WebSocket 服务器类型。它还说明环境变量、OAuth 和令牌认证、MCP 工具命名、生命周期、权限控制、错误处理、调试和本地测试流程。适合需要让插件访问数据库、API、文件系统或云服务的开发者。
指导用户在插件根目录创建 .mcp.json，或在 plugin.json 中配置 mcpServers；为本地进程和远程 MCP 服务器提供 command、args、env、url、headers 等配置示例；解释 ${CLAUDE_PLUGIN_ROOT} 和用户环境变量的替换；说明如何在命令或代理中预授权 MCP 工具；提供 OAuth、令牌认证、连接失败和工具调用错误的处理建议；指导使用 /mcp 查看服务器，并用 claude --debug 检查连接、工具发现和认证日志。
- 开发 Claude Code 插件并需要连接本地文件系统、数据库或自定义 MCP 服务器的用户。
- 需要通过 SSE 接入支持 OAuth 的 Asana、GitHub 等托管服务的插件开发者。
- 需要通过 HTTP 和令牌认证连接 REST API 型 MCP 后端的团队。
- 需要在同一插件中组合 GitHub、Jira 等多个外部服务的开发者。
- 希望在发布插件前验证配置、工具发现、认证和错误处理的维护者。
优缺点一览
- 覆盖四种 MCP 服务器传输方式及对应使用场景。
- 提供可直接参考的 .mcp.json 和 plugin.json 配置示例。
- 包含认证、工具权限、生命周期、错误处理、性能和调试建议。
- 明确推荐使用 ${CLAUDE_PLUGIN_ROOT} 和环境变量以提高配置可移植性。
- 内容面向 Claude Code 插件，迁移到其他客户端需要适配插件和命令相关部分。
- 技能本身不提供 MCP 服务器、外部服务账号或测试环境。
- 源材料未列出自动化测试套件，也未证明特定服务器或平台的实际兼容性。
- 远程服务连接、OAuth、令牌和环境变量仍需用户自行配置与维护。
如何安装
该技能位于 https://github.com/anthropics/claude-plugins-official 的 plugins/plugin-dev/skills/mcp-integration/SKILL.md。README 说明插件可通过 Claude Code 插件市场安装，可运行：/plugin install plugin-dev@claude-plugins-official。源材料未说明单独安装此技能或其依赖的额外命令。
如何使用
在需要添加或配置 MCP 时触发，例如："add MCP server"、"integrate MCP"、"configure MCP in plugin"、"use .mcp.json" 或 "set up Model Context Protocol"。随后按技能指导选择 stdio、SSE、HTTP 或 WebSocket，配置服务器，记录环境变量，使用 /mcp 验证，并在相关命令中预授权具体 MCP 工具。源材料未提供独立的运行入口或自动化脚本。