前置准备
- 装了 Claude Desktop / Cursor / VS Code 其中至少一个
- 按要装的 Server 要求装好运行时（大多数需要 Node.js 或 Python，个别要额外依赖）
- 准备好 API Key 等凭据（如 GitHub token），配置时要用
Claude Desktop
图形化操作：
- 打开 Claude Desktop → 设置（Settings）
- 进入 开发者（Developer） → 点击 编辑配置（Edit Config）
- 在
claude_desktop_config.json的mcpServers字段下添加服务器：
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "你的token" }
}
}
}
保存后重启 Claude Desktop，左侧工具列表就会出现新工具。具体命令/字段以你要装的 Server 的 README 为准。
Cursor
- 打开 Cursor 命令面板（
Ctrl+Shift+P/Cmd+Shift+P） - 输入并选择 Cursor Settings > MCP
- 点击 Add New MCP Server，选择类型（stdio 或 SSE），填命令与参数
VS Code
- 安装 MCP Client 扩展（或使用自带 MCP 支持的 Copilot 相关扩展）
- 在扩展设置中用 JSON 配置
mcpServers，格式与 Claude Desktop 一致 - 重载窗口生效
各客户端配置界面随版本可能变化，以官方文档为准；Server 的具体命令始终看它自己的 README。
常见报错排查
| 报错 | 原因 | 解决 |
|---|---|---|
| command not found | Node/Python 未装或不在 PATH | 安装运行时并重启客户端 |
| 401 / 403 | API 凭据无效或过期 | 重新生成 token，检查 env 配置 |
| Connection refused | SSE 服务器地址错误/未启动 | 核对 URL 与端口，确认服务在线 |
| Tool not found | 没重启客户端导致配置未加载 | 保存配置后完全重启 |
安全提醒
- token 只存在本地配置文件，别提交进代码仓库（记得加
.gitignore） - 只装官方或高星可信的 Server，来历不明的 Server 可能窃取你的数据
- 高权限 Server（能删文件、跑命令的）谨慎授予