用途：在 Claude Code 插件中配置 MCP（Model Context Protocol）服务器，把外部服务能力以工具形式暴露给插件，适用于添加 MCP 配置、选择传输类型或排查 MCP 工具发现问题。
主要能力：提供两种配置方式——在插件根目录创建 .mcp.json（推荐，适合多服务器或复杂配置），或在 plugin.json 中添加 mcpServers 字段（适合单服务器简单插件）。支持四种服务器类型：stdio（本地子进程，经 stdin/stdout 通信，由 Claude Code 管理生命周期）、SSE（托管云服务，自动处理 OAuth）、HTTP（REST 端点，令牌认证，无状态）、WebSocket（持久连接，低延迟推送，ws/wss）。
用法要点：配置支持变量替换，${CLAUDE_PLUGIN_ROOT} 解析为插件安装目录，路径应使用它而非硬编码绝对路径；env 块可引用用户 shell 环境变量。MCP 工具注册时自动加前缀，格式为 mcp__plugin_<plugin-name>_<server-name>__<tool-name>，例如 mcp__plugin_asana_asana__asana_create_task；可在技能或命令 frontmatter 中用 allowed-tools 预允许特定工具，避免使用通配符。认证方式包括 OAuth（SSE/HTTP，首次使用时提示）、令牌（headers 块，用环境变量）、本地进程环境变量。
测试与限制：服务器随插件加载启动，连接在首次使用工具前建立；可用 claude --plugin-dir ./my-plugin 本地安装，运行 /mcp 验证服务器，claude --debug 检查连接与工具发现。常见问题包括服务器未连接、工具不可用、认证失败。安全上要求远程连接使用 HTTPS/WSS，令牌存于环境变量，预允许具体工具，并在 README 记录所需环境变量。
相关任务路由：从零构建 FastMCP 服务器用 /fastmcp-creator，编写 CLI 客户端用 /fastmcp-client-cli，终端检查调试用 /mcp-cli，编写 pytest 测试用 /fastmcp-python-tests，通用 Python 开发用 /python-engineering:orchestrate。