Slack MCP Server

什么是 Slack MCP Server？

Slack MCP Server（korotovsky/slack-mcp-server）是一个开源的 Slack MCP 服务器，让 Claude、Cursor 等 MCP 客户端可以读取频道、线程和私信，搜索消息并整理未读消息。它在本地运行，支持 OAuth、Bot 或浏览器会话令牌。

它是采用 MIT 许可证的社区项目，并非 Slack 官方产品。发送消息、添加表情回应等写入操作默认关闭，需要显式开启。如果你想使用 Slack 官方托管的端点，请参阅下文的对比部分。

如何使用 Slack MCP Server？

你需要安装带 npx 的 Node.js（或 Docker），以及一组 Slack 凭据。服务器只需要以下任意一种；如果同时设置了多种，优先级为 xoxp > xoxb > xoxc/xoxd：

• 用户 OAuth 令牌（xoxp-...）：通过 SLACK_MCP_XOXP_TOKEN 设置。在 api.slack.com/apps 创建应用，添加 channels:history、channels:read、groups:history、im:history、mpim:history、users:read、search:read 以及（用于发消息的）chat:write 等用户令牌权限范围，安装应用后复制 User OAuth Token。
• Bot 令牌（xoxb-...）：通过 SLACK_MCP_XOXB_TOKEN 设置。Bot 只能看到它被邀请加入的频道，并且无法使用消息搜索。
• 浏览器会话令牌：通过 SLACK_MCP_XOXC_TOKEN 和 SLACK_MCP_XOXD_TOKEN 设置（“隐身模式”）。xoxc- 令牌来自 Slack 网页版的本地存储，xoxd- 是名为 d 的 Cookie 的值。这种方式无需安装应用，但这些令牌代表你的完整会话。

Claude Desktop

将服务器添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "slack-mcp-server@latest", "--transport", "stdio"],
      "env": {
        "SLACK_MCP_XOXP_TOKEN": "xoxp-..."
      }
    }
  }
}

根据认证方式，把 env 部分换成 SLACK_MCP_XOXB_TOKEN，或换成 SLACK_MCP_XOXC_TOKEN 加 SLACK_MCP_XOXD_TOKEN。Claude Desktop 用户也可以从项目的 GitHub Releases 下载 .dxt 扩展，在 Settings → Extensions 中安装并填写令牌字段。

Claude Code

使用相同的命令和环境变量：

claude mcp add slack -e SLACK_MCP_XOXP_TOKEN=xoxp-... -- npx -y slack-mcp-server@latest --transport stdio

Cursor

README 为 xoxc/xoxd、xoxp 和 xoxb 三种方式提供了 Cursor 一键安装链接，安装后请替换占位令牌。你也可以把上面的 JSON 配置粘贴到 Cursor 的 MCP 设置中。

Docker

docker run -i --rm -e SLACK_MCP_XOXP_TOKEN ghcr.io/korotovsky/slack-mcp-server:latest --transport stdio

如需使用 SSE，请把服务器部署在可通过 HTTPS 访问的地方，用 SLACK_MCP_API_KEY 保护，并让 Claude Desktop 通过 mcp-remote 携带 Authorization: Bearer 请求头连接。

Slack MCP Server 的主要功能

• 三种认证模式：用户 OAuth（xoxp）、Bot（xoxb）和浏览器会话“隐身”令牌（xoxc/xoxd）
• 频道和线程历史，可按时间（1d、7d、30d）或消息数量智能限制，并支持游标分页
• 除 ID 外，还可按名称（#general、@username_dm）查找频道和私信
• 全工作区消息搜索，支持频道、用户、日期和仅线程等过滤条件
• 跨频道整理未读消息，优先级为私信 > Slack Connect 合作伙伴频道 > 内部频道
• 安全的默认设置：写入工具未开启时不会注册，并支持按频道的允许列表
• 企业版 Slack 选项（SLACK_MCP_USER_AGENT、SLACK_MCP_CUSTOM_TLS）、GovSlack 模式（SLACK_MCP_GOVSLACK）和代理支持
• 本地用户和频道缓存，以及 slack://<workspace>/channels 和 slack://<workspace>/users 两个 CSV 资源

Slack MCP Server 工具

• 读取会话：conversations_history 和 conversations_replies 获取频道或私信消息以及完整线程；channels_list 列出公开频道、私有频道、私信和群组私信。
• 搜索：conversations_search_messages 按条件搜索消息，或根据 Slack 消息链接定位单条消息；users_search 按姓名、邮箱或显示名称查找用户。
• 未读消息：conversations_unreads 高效汇总未读消息，conversations_mark 将频道标记为已读（需设置 SLACK_MCP_MARK_TOOL 才会启用）。
• 写入：conversations_add_message、reactions_add 和 reactions_remove 需通过 SLACK_MCP_ADD_MESSAGE_TOOL 和 SLACK_MCP_REACTION_TOOL 主动开启。
• 用户组：usergroups_list、usergroups_create、usergroups_update、usergroups_users_update 和 usergroups_me 用于管理用户组（需要 usergroups:read/usergroups:write 权限范围）。
• 稍后查看：saved_list、saved_update 和 saved_clear_completed 操作“Save for Later”中的条目，需要浏览器会话令牌。

SLACK_MCP_ENABLED_TOOLS 可以限制客户端能看到哪些工具。

Slack MCP Server 的使用场景

• 频道摘要：“总结 #incidents 过去 7 天发生了什么，并列出未完成的待办事项。”
• 早间整理：“显示我未读的私信和 @提及，按重要程度排序。”
• 查找决策：“搜索我们确定 Q3 发布日期的那个线程，并引用最后一条消息。”
• 起草并发布：“把发布说明发到 #announcements”，同时把发消息权限限制在该频道 ID。
• 查找同事：“找到数据团队的 Dana，显示她的职位和私信频道。”

Slack MCP Server 与替代方案对比

• Slack 官方 MCP 服务器：Slack 在 https://mcp.slack.com/mcp 托管了自己的服务器（Streamable HTTP，OAuth）。文档见 docs.slack.dev，可用于 Claude.ai、Claude Code、Cursor、Perplexity 等合作客户端。自定义客户端必须基于内部应用或已在应用目录发布的 Slack 应用。如果管理员希望使用经过审批、由 Slack 管理的集成，选择它。
• 已归档的参考服务器：MCP 项目最初的 Slack 服务器已移至 modelcontextprotocol/servers-archived，不再维护。
• 这个社区版 Slack MCP 服务器更适合需要本地控制、无需安装应用的浏览器令牌认证、未读整理、企业版/GovSlack 选项或精细工具允许列表的场景。

其他聊天平台可参阅 Discord MCP Server。

Slack MCP Server 常见问题排查

• 没有搜索功能：Bot 令牌（xoxb）无法调用 search.messages，因此 conversations_search_messages 不可用。请改用 xoxp 或 xoxc/xoxd 令牌。
• #频道 或 @用户 名称无法解析：用户和频道缓存尚未建立。没有缓存时，channels_list 无法工作，按名称查找也会失败。请等待缓存建立，或检查 SLACK_MCP_USERS_CACHE/SLACK_MCP_CHANNELS_CACHE 路径。
• 企业版工作区拒绝浏览器令牌：将 SLACK_MCP_USER_AGENT 设置为你提取令牌时所用浏览器的 User-Agent，并开启 SLACK_MCP_CUSTOM_TLS。
• DXT 扩展在 Claude Desktop 中无法启动：文档建议关闭 Claude Desktop 内置的 Node，改用本机的 Node。
• 看不到发消息工具：写入工具默认不注册。将 SLACK_MCP_ADD_MESSAGE_TOOL 设为 true 或以逗号分隔的频道 ID 列表。可用 tail -n 20 -f ~/Library/Logs/Claude/mcp*.log 查看日志。