用途:帮助把外部服务(数据库、API、文件系统等)通过 MCP 以结构化工具形式接入 Claude Code 插件,将外部能力暴露为插件内可用工具。
主要能力与服务器类型:支持 stdio(本地子进程,经 stdin/stdout 通信,适合本地工具、自定义服务器、NPM 包);SSE(连接托管服务器,支持 OAuth,适合云服务);HTTP(REST 类 MCP 服务器,令牌认证,无状态交互);WebSocket(ws/wss,实时双向通信、流式数据)。
配置方式:推荐在插件根目录创建 .mcp.json,也可在 plugin.json 的 mcpServers 字段内联。配置支持环境变量展开,路径应使用 ${CLAUDE_PLUGIN_ROOT},用户环境变量如 ${API_KEY}、${DB_URL} 可注入 command/args/env 或 headers。
工具命名与使用:工具自动加前缀,格式为 mcp__plugin_<plugin-name>_<server-name>__<tool-name>;可在命令 frontmatter 的 allowed-tools 中预先放行指定工具(建议具体而非通配)。
认证与生命周期:OAuth 由 Claude Code 自动处理,令牌类通过 headers 传入。服务器随插件启用启动,首次工具调用前建立连接,配置变更需重启。
限制与注意:应使用 HTTPS/WSS;不要把令牌硬编码或提交到 git;仅放行必要工具;需处理连接失败、工具调用错误与配置错误;需在 README 记录必需环境变量。可用 claude --debug 调试、用 /mcp 查看服务器与工具。详细参考文件与示例配置在资料中列出,具体实现细节暂未提供。