用途:在 Claude Code 插件中集成 MCP,把数据库、API、文件系统等外部服务能力暴露为工具,供命令与智能体调用。
主要能力:支持两种打包方式——插件根目录的 .mcp.json(推荐,便于维护与多服务器)或在 plugin.json 中内联 mcpServers 字段。支持四种传输类型:stdio(本地子进程,适合本地工具与自定义服务器)、SSE(托管服务,支持 OAuth)、HTTP(REST 接口,令牌认证)、WebSocket(实时双向通信)。配置支持环境变量替换,如 ${CLAUDE_PLUGIN_ROOT} 与 ${VAR:-default},可用于 command、args、env、url、headers。MCP 工具自动加前缀,格式为 mcp__plugin_<插件名>_<服务器名>__<工具名>;资源可用 @server:protocol://path 引用;服务器提示词会以 /mcp__servername__promptname 形式出现。工具较多时自动启用 Tool Search,可用 ENABLE_TOOL_SEARCH 控制。
使用方式:创建 .mcp.json 或内联配置后启用插件,服务器自动启动;用 /mcp 查看服务器,用 claude --debug 排查连接问题。CLI 命令包括 claude mcp add --transport stdio/http、claude mcp list、claude mcp get、claude mcp remove、claude mcp add-json、claude mcp add-from-claude-desktop、claude mcp serve。
适用场景:为插件接入外部服务、多服务器工作流、OAuth 或令牌认证、实时数据流。
限制:MCP 输出有大小限制(警告 10000 tokens,默认上限 25000 tokens,超出截断,可用 MAX_MCP_OUTPUT_TOKENS 调整);配置变更需重启;企业可通过 managed-mcp.json 或允许/拒绝列表管控。安全上应使用 HTTPS/WSS、用环境变量管理令牌、避免通配符预授权。其余细节暂未提供。