Setup Guide

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个人访问令牌

生成令牌：

1. GitHub→ 设置 → 开发人员设置
2. 个人访问令牌 → 代币（经典）
3. 生成新令牌 → 生成新令牌（经典）
4. 下一个 仅限必需权限 检查（最低安全权限）：

- repo （全部） - workflow - gist - user

⚠️ 注意: delete_repo, admin:enterprise 不要选择等危险权限！

1. 生成令牌 →复制令牌

设置：

GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

2.📝 Notion集成令牌

创建集成：

1. 概念开发者 连接
2. +新集成 单击
3. 名字 输入→ 提交
4. 内部集成令牌 复制（secret_以开始）

连接工作空间：

1. 要使用的Notion页面右上角 ⋯ 单击
2. 添加连接 →选择创建的集成

设置：

NOTION_API_KEY: "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

3.💬 Slack机器人令牌

创建应用程序：

1. 松弛API → 创建新应用程序
2. 从头开始 →设置应用程序名称/工作空间

设置方法：

1. OAuth和权限 进入菜单

Scopes部分：

1. Bot令牌范围在中 添加OAuth作用域 单击
2. 以下权限 逐个 添加：

- channels:read → 添加 单击 - channels:history → 添加 单击 - groups:read → 添加 单击 - groups:history → 添加 单击 - chat:write → 添加 单击 - users:read → 添加 单击 - reactions:read → 添加 单击

OAuth令牌섹션:

1. Install to\[工作空间名称\] 点击按钮→ 允许
2. Bot用户OAuth令牌 复制（xoxb-以开始）

确认团队ID：

1. 在Web浏览器中连接Slackworkspace
2. 在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令牌：

1. 登录Make.com→点击右上角配置文件
2. API → MCP服务器 选项卡
3. 生成新令牌 →输入代币名
4. 代币, 区域 确认

设置：

URL: "https:///mcp/api/v1/u//sse"
예시: "https://us1.make.com/mcp/api/v1/u/abc123token/sse"

5.🔥 Firecrawl API密钥

API密钥发放：

1. 萤火虫 注册/登录
2. 仪表板→ API密钥 菜单
3. 创建API密钥 →复制密钥

设置：

FIRECRAWL_API_KEY: "fc-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

6.🔍 困惑API密钥

API密钥发放：

1. 困惑度 登录
2. 设置 → API → 生成
3. 复制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": ""
      }
    }
  }
}

🔧 设置完成后

1. 重新启动Claude Desktop
2. 在新聊天中测试“显示工具列表”或MCP服务器功能
3. 验证每个服务器上的工具是否正常显示

💡 选择性使用

• 删除所有不需要的服务器
• SLACK_CHANNEL_IDS可选（可删除）
• Make URL替换为完整URL

🔒 安全注意事项

GitHub토큰:

• 最小权限原则：仅授予所需权限
• 禁止危险权限: delete_repo, admin:enterprise 等不要选择
• 令牌周期性更新：定期创建新令牌以确保安全性

其他API密钥：

• 作为环境变量进行管理：不要直接输入代码
• 访问权限限制：仅设置所需范围
• 定期检查：立即删除未使用的令牌

🎯 支持的功能

GitHub

• 创建/管理存储库
• 问题/PR管理
• 代码搜索
• 上载/修改文件

概念

• 创建/修改页面
• 数据库查询
• 块操作
• 管理评论

Slack

• 发送和接收消息
• 渠道管理
• 添加反应
• 查看用户信息

制造

• 自动化工作流
• 服务集成

萤火虫

• 滚动网页
• 结构化数据提取
• 批量网站分析

困惑度

• 基于AI的Web搜索
• 实时信息查询

🐛 故障排除

常见问题：

1. 无法识别MCP服务器：需要重新启动Claude Desktop
2. 令牌错误：验证API密钥的有效性和权限
3. 解析JSON错误：语法检查和转义字符检查

特定于服务器的故障排除：

• GitHub：添加令牌权限不足时所需的scope
• 概念：验证Integration是否已连接到页面
• Slack：确认Bot已安装在工作空间中

______________________________________________________________________

🚀 现在，在Claude Desktop中安全高效地使用所有MCP服务器！

如果有问题或需要进一步帮助，请创建问题。