SuperAPI AI 工具集

connect-mcp-server

智能体与模型

查看项目

更新于 10-16 11:39

技能介绍

用途

本技能用于把 MCP(Model Context Protocol,模型上下文协议)服务器连接到 Claude Code,从而接入 GitHub、Notion、数据库、项目管理工具以及自定义 API 等外部服务。

主要能力

  • 支持三种传输方式:HTTP(远程,推荐)、stdio(本地)、SSE(已废弃,建议迁移到 HTTP)。
  • 提供 Local(默认)、project(.mcp.json,可经 git 共享)、user(跨项目)三种配置作用域。
  • 支持手动编写 .mcp.json 配置文件,包含 HTTP 与 stdio 两种服务器配置示例。
  • 支持环境变量展开:${VAR} 与 ${VAR:-default},可用于命令路径、参数、环境设置和 HTTP 头。
  • 支持 OAuth 2.0 认证(通过 /mcp 触发浏览器登录,令牌自动刷新)以及 API Token 认证(header 或环境变量方式)。
  • 提供服务器管理命令:claude mcp list、claude mcp get <name>、claude mcp remove <name>、claude mcp reset-project-choices。
  • 支持通过 @ 引用资源、通过 /mcp__servername__promptname 调用提示。
  • 可配置输出上限与超时:MAX_MCP_OUTPUT_TOKENS、MCP_TIMEOUT。
  • 提供企业集中配置与管理(managed-mcp.json、allowlist/denylist)。

使用方式

基本流程为:确定目标服务 → 选择传输方式 → 收集凭据 → 选择作用域 → 用 claude mcp add 添加 → 用 /mcp 认证 → 测试连接 → 使用资源与提示。

添加 HTTP 服务器:

claude mcp add --transport http <name> <url>

添加 stdio 服务器(注意 -- 分隔符,npx 需加 -y):

claude mcp add --transport stdio <name> <command> [args...]

带认证头:

claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token-here"

指定项目作用域会生成 .mcp.json:

claude mcp add --transport http github https://mcp.github.com --scope project

资源与提示调用格式:

@server:protocol://resource/path
/mcp__servername__promptname [arguments]

适用场景

  • 将 Claude Code 与 GitHub、Notion、Slack、Google Drive、Sentry、Linear 等服务集成。
  • 接入本地文件系统、PostgreSQL、MongoDB、Redis、AWS、Airtable、Brave Search、Git 等服务器。
  • 团队通过项目作用域共享集成配置,或个人跨项目统一配置。
  • 企业由管理员集中下发 MCP 配置与允许/拒绝列表。

限制与注意事项

  • 文档包含安全警告:使用第三方 MCP 服务器需自行承担风险,Anthropic 未验证所有服务器的正确性与安全性。
  • 拉取不可信内容的服务器可能带来提示注入风险,建议使用可信来源、限制权限并定期审查。
  • 凭据管理建议使用环境变量,避免将令牌硬编码或提交到 git。
  • 默认输出限制为 1 万 token 警告阈值、2.5 万 token 上限;MCP 服务器启动超时默认 5 秒。
  • 文档在“Troubleshooting”处结束,未提供后续故障排查内容。
  • 关于收费、价格、具体平台支持范围等事实,资料中暂未提供。