SuperAPI AI 工具集

MCP Integration

智能体与模型

查看项目

更新于 10-16 08:45

技能介绍

用途:为 Claude Code 插件接入 Model Context Protocol(MCP),把外部服务(数据库、API、文件系统等)的能力以结构化工具形式暴露给插件使用。

主要能力:连接外部服务;单个服务可提供 10 个以上相关工具;处理 OAuth 及复杂认证流程;随插件打包 MCP 服务器实现自动配置。

配置方式:方式一为在插件根目录创建 .mcp.json(推荐,关注点分离、便于维护、适合多服务器);方式二为在 plugin.json 中添加 mcpServers 字段(适合简单单服务器插件)。

服务器类型:stdio(本地子进程,适合本地工具与自定义服务器,经 stdin/stdout 通信,Claude Code 退出时终止);SSE(托管服务器,支持 OAuth,适合云服务);HTTP(REST 风格,令牌认证);ws(WebSocket,实时双向通信)。配置支持环境变量替换,路径应使用 ${CLAUDE_PLUGIN_ROOT} 以保证可移植性。

工具命名:格式为 mcp__plugin_<plugin-name>_<server-name>__<tool-name>,可在命令 frontmatter 的 allowed-tools 中预授权,建议只允许具体工具而非通配符。

使用方式:插件启用时 MCP 服务器自动启动,首次使用工具前建立连接,配置变更需重启;用 /mcp 命令查看服务器,用 claude --debug 排查连接与认证问题。

适用场景:简单工具包装、自主智能体多步工作流、跨多服务插件。

限制与安全:应使用 HTTPS/WSS,令牌用环境变量而非硬编码,不提交凭据到 git,需在 README 记录所需环境变量,并处理连接失败、工具调用错误与配置错误。具体收费、价格与平台支持范围资料未提供。