SuperAPI AI 工具集

claude-code-mcp-setup

通用与其它

查看项目

更新于 10-16 05:50

技能介绍

用途:指导在 Claude Code CLI 中添加和配置 MCP(Model Context Protocol)服务器,适用于新增 MCP 服务器、配置远程 MCP(HTTP/SSE)、排查连接失败、理解传输类型以及设置 OAuth 认证服务器等场景。

主要能力与用法:通过 CLI 命令管理服务器。添加本地 stdio:claude mcp add <name> <command> [args...];添加远程 HTTP(支持 OAuth):claude mcp add --transport http <name> <url>;添加远程 SSE:claude mcp add --transport sse <name> <url>;带环境变量:claude mcp add <name> -e API_KEY=xxx -- <command> [args...];带自定义请求头:claude mcp add --transport http <name> <url> --header "Authorization: Bearer xxx"。查看已配置服务器用 claude mcp list,移除用 claude mcp remove <name>。

传输类型:stdio 用于本地 NPM 包与脚本;http 用于带 OAuth 的远程服务器;sse 用于 Server-Sent Events 服务器。示例包括 monday.com 远程 HTTP、GitHub 本地带令牌、Filesystem 本地以及自定义本地服务器。配置存储在用户级 ~/.claude.json 与项目级 .mcp.json(旧版),必要时可手动编写 mcpServers 配置。

排查:在 Claude Code 内运行 /mcp 查看状态,/doctor 获取详细诊断;可检查 ~/.claude.json 中的 mcpServers 并用 jq 校验 JSON 语法。常见问题包括配置 schema 不符(建议用 CLI 而非手改 JSON)、重连失败、OAuth 未触发、环境变量错误等。

限制:OAuth 服务器需重启 Claude Code 并运行 /mcp 触发浏览器授权;网络与弹窗拦截可能影响连接;具体版本行为与更多细节暂未提供。