AI导哈

多协议服务器连接工具

Claude Desktop的多协议服务器连接工具，支持与GitHub、Notion、Slack等多种外部服务的交互，提供完整的设置指南和安全管理。

  • by 10000ssam
  • HTML
  • 本地部署
  • 更新于
在 GitHub 查看 1000ssam/mcp-server-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://<MAKE_ZONE>/mcp/api/v1/u/<MCP_TOKEN>/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": "<YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>"
      }
    },
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer <YOUR_NOTION_API_KEY>\", \"Notion-Version\": \"2022-06-28\" }"
      }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>",
        "SLACK_TEAM_ID": "<YOUR_SLACK_TEAM_ID>",
        "SLACK_CHANNEL_IDS": "<YOUR_SLACK_CHANNEL_IDS>"
      }
    },
    "make": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://<MAKE_ZONE>/mcp/api/v1/u/<MCP_TOKEN>/sse"
      ]
    },
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "<YOUR_FIRECRAWL_API_KEY>"
      }
    },
    "perplexity": {
      "command": "npx",
      "args": ["-y", "server-perplexity-ask"],
      "env": {
        "PERPLEXITY_API_KEY": "<YOUR_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服务器！

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

相关 MCP