用途:在 Claude Code 插件中接入 MCP,把外部服务或 API 的能力注册为可调用工具,供命令和智能体使用。
主要能力:可从单一服务提供 10+ 相关工具;支持 OAuth 与复杂认证流程;可随插件打包 MCP 服务器实现自动配置。
配置方式:一是插件根目录创建专用 .mcp.json(推荐,便于维护与多服务器管理);二是在 plugin.json 内联 mcpServers 字段(适合简单单服务器插件)。
服务器类型:stdio 以本地子进程运行,适合本地工具与自定义服务器,通信走 stdin/stdout;SSE 连接托管服务器并支持 OAuth,适合云服务;HTTP 面向 REST 型服务器,用令牌认证;ws 用于实时双向通信。配置均支持环境变量替换,路径推荐使用 ${CLAUDE_PLUGIN_ROOT}。
工具命名:注册后自动加前缀,格式为 mcp__plugin_<plugin-name>_<server-name>__<tool-name>。可在命令 frontmatter 的 allowed-tools 中预授权具体工具,建议避免通配符。
生命周期:插件启用时启动服务器,首次使用前建立连接,配置更改后需重启;用 /mcp 查看服务器。
安全与调试:使用 HTTPS/WSS,令牌放环境变量并写入 README,不硬编码或提交凭据;用 /mcp 验证、claude --debug 排查连接与工具发现问题。
限制:资料未提供具体收费与价格信息;功能与行为以官方文档为准。