MCP服务器设置指南🚀
这是一个完整的设置指南，可将模型上下文协议（MCP）服务器连接到Claude Desktop，以便与各种外部服务进行交互。
📋 支持的服务器
- GitHub -管理代码存储库
- 概念 -文档/数据库管理
- Slack -团队通信
- 制造 -自动化工作流
- 萤火虫 -Web滚动
- 困惑度 -AI搜索
🛠️ 首选项
Claude Desktop配置文件位置：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
🔑 设置每个服务器的身份验证
1.🐙 GitHub个人访问令牌
生成令牌：
- GitHub→ 设置 → 开发人员设置
- 个人访问令牌 → 代币（经典）
- 生成新令牌 → 生成新令牌（经典）
- 下一个 仅限必需权限 检查（最低安全权限）：
- repo （全部） - workflow - gist - user
⚠️ 注意:delete_repo,admin:enterprise不要选择等危险权限！
- 生成令牌 →复制令牌
设置：
GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"2.📝 Notion集成令牌
创建集成：
- 概念开发者 连接
- +新集成 单击
- 名字 输入→ 提交
- 内部集成令牌 复制（
secret_以开始）
连接工作空间：
- 要使用的Notion页面右上角 ⋯ 单击
- 添加连接 →选择创建的集成
设置：
NOTION_API_KEY: "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"3.💬 Slack机器人令牌
创建应用程序：
- 松弛API → 创建新应用程序
- 从头开始 →设置应用程序名称/工作空间
设置方法：
- OAuth和权限 进入菜单
Scopes部分：
- Bot令牌范围在中 添加OAuth作用域 单击
- 以下权限 逐个 添加：
- channels:read → 添加 单击 - channels:history → 添加 单击 - groups:read → 添加 单击 - groups:history → 添加 单击 - chat:write → 添加 单击 - users:read → 添加 单击 - reactions:read → 添加 单击
OAuth令牌섹션:
- Install to\[工作空间名称\] 点击按钮→ 允许
- Bot用户OAuth令牌 复制（
xoxb-以开始）
确认团队ID：
- 在Web浏览器中连接Slackworkspace
- 在URL中
T检查以开头的字符串
https://app.slack.com/client/T09049C5C9G/C09049C70LS
↑ 이 부분이 Team ID设置：
SLACK_BOT_TOKEN: "xoxb-xxxxxxxxxxxx-xxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx"
SLACK_TEAM_ID: "T01234567"
SLACK_CHANNEL_IDS: "C01234567,C76543210" (선택사항 - 특정 채널만 접근 제한)4.🔄 Make.com MCP代币
创建MCP令牌：
- 登录Make.com→点击右上角配置文件
- API → MCP服务器 选项卡
- 生成新令牌 →输入代币名
- 代币, 区域 确认
设置：
URL: "https:///mcp/api/v1/u//sse"
예시: "https://us1.make.com/mcp/api/v1/u/abc123token/sse"5.🔥 Firecrawl API密钥
API密钥发放：
- 萤火虫 注册/登录
- 仪表板→ API密钥 菜单
- 创建API密钥 →复制密钥
设置：
FIRECRAWL_API_KEY: "fc-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"6.🔍 困惑API密钥
API密钥发放：
- 困惑度 登录
- 设置 → API → 生成
- 复制API密钥
设置：
PERPLEXITY_API_KEY: "pplx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"📁 最终配置文件
下面的JSON claude_desktop_config.json粘贴到并替换每个令牌：
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": ""
}
},
"notionApi": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer \", \"Notion-Version\": \"2022-06-28\" }"
}
},
"slack": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-slack"],
"env": {
"SLACK_BOT_TOKEN": "",
"SLACK_TEAM_ID": "",
"SLACK_CHANNEL_IDS": ""
}
},
"make": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https:///mcp/api/v1/u//sse"
]
},
"mcp-server-firecrawl": {
"command": "npx",
"args": ["-y", "firecrawl-mcp"],
"env": {
"FIRECRAWL_API_KEY": ""
}
},
"perplexity": {
"command": "npx",
"args": ["-y", "server-perplexity-ask"],
"env": {
"PERPLEXITY_API_KEY": ""
}
}
}
}🔧 设置完成后
- 重新启动Claude Desktop
- 在新聊天中测试“显示工具列表”或MCP服务器功能
- 验证每个服务器上的工具是否正常显示
💡 选择性使用
- 删除所有不需要的服务器
SLACK_CHANNEL_IDS可选（可删除）- Make URL替换为完整URL
🔒 安全注意事项
GitHub토큰:
- 最小权限原则：仅授予所需权限
- 禁止危险权限:
delete_repo,admin:enterprise等不要选择 - 令牌周期性更新：定期创建新令牌以确保安全性
其他API密钥：
- 作为环境变量进行管理：不要直接输入代码
- 访问权限限制：仅设置所需范围
- 定期检查：立即删除未使用的令牌
🎯 支持的功能
GitHub
- 创建/管理存储库
- 问题/PR管理
- 代码搜索
- 上载/修改文件
概念
- 创建/修改页面
- 数据库查询
- 块操作
- 管理评论
Slack
- 发送和接收消息
- 渠道管理
- 添加反应
- 查看用户信息
制造
- 自动化工作流
- 服务集成
萤火虫
- 滚动网页
- 结构化数据提取
- 批量网站分析
困惑度
- 基于AI的Web搜索
- 实时信息查询
🐛 故障排除
常见问题：
- 无法识别MCP服务器：需要重新启动Claude Desktop
- 令牌错误：验证API密钥的有效性和权限
- 解析JSON错误：语法检查和转义字符检查
特定于服务器的故障排除：
- GitHub：添加令牌权限不足时所需的scope
- 概念：验证Integration是否已连接到页面
- Slack：确认Bot已安装在工作空间中
______________________________________________________________________
🚀 现在，在Claude Desktop中安全高效地使用所有MCP服务器！
如果有问题或需要进一步帮助，请创建问题。