SuperAPI AI 工具集

mcp-integration

编程与开发

查看项目

更新于 10-16 08:40

技能介绍

用途:该技能用于把 Model Context Protocol(MCP)服务器接入 Claude Code 插件,从而将外部服务能力以工具形式暴露给 Claude Code 使用,适用于需要配置 MCP 服务器、设置认证或集成外部服务时。

主要能力与配置方式:支持两种配置途径。一是独立的 .mcp.json(推荐),在 mcpServers 下定义服务器;二是内联在 plugin.json 的 mcpServers 字段中。

服务器类型:stdio(本地进程,使用 command 与 args);HTTP(REST API,使用 url 与 headers);SSE(服务器发送事件,使用 url 与 headers);WebSocket(使用 wss 地址)。

环境变量与可移植性:配置中用 ${VAR_NAME} 引用动态值,如 API_KEY;使用 ${CLAUDE_PLUGIN_ROOT} 表示相对路径,例如 args 中的 ${CLAUDE_PLUGIN_ROOT}/server/index.js,以保证插件可移植。

安全建议:远程服务器必须使用 HTTPS/WSS,不要使用 HTTP;不要把令牌硬编码,改用环境变量;权限应预先允许具体工具而非通配符;在 README 中记录所需变量。

测试与工作流:通过 /mcp 命令验证配置,/mcp status 查看服务器状态。典型流程为:根据部署选择服务器类型、创建 .mcp.json、用 ${CLAUDE_PLUGIN_ROOT} 保证可移植性、记录环境变量、本地用 /mcp 测试、配置工具权限、处理认证与错误。

限制:资料未提供具体价格、平台兼容范围及更多故障排查细节,暂未提供。