Slack Mcp Server

    

   

Slack MCP 服务

不必阅读 Slack，也能了解最新动态。

未读消息、话题串和搜索结果，都会进入 Agent 的上下文，并沿用你当前的会话。

完成设置，然后在客户端中注册。

npx -y @jtalk22/slack-mcp --setup

claude mcp add slack -- npx -y @jtalk22/slack-mcp

检查凭据的存储位置和存放时长，或者以只读模式运行，让 Agent 可以读取 Slack，但绝不会发帖。

npx -y @jtalk22/slack-mcp --doctor --security

npx -y @jtalk22/slack-mcp --read-only

在 Enterprise Grid 上，Slack 可能会终止它检测到自动化操作的会话。请改用 Slack 官方 MCP 服务。

Claude Code Claude Desktop Cursor Copilot Windsurf Gemini CLI Codex CLI 任何 stdio MCP 客户端

5.1 版更新内容 · ▶ 三分钟看完一整个早晨 · 交互式演示 · 设置指南

如果你的工作区使用 Slack 免费版

根据 Slack 于 2026-10-07 发布的套餐和定价信息核对。

免费工作区保留 90 天的消息历史记录，允许集成 10 个应用，并且只能使用 Slack 的基础 AI。人们真正想要的 AI 功能——跨工作区 AI 搜索、频道摘要、让 Slackbot 充当 Agent、AI 工作流生成——从 Business+ 套餐开始提供，按年付费时每位用户每月 15 美元（月付为 18 美元）。Pro 套餐每月 7.25 美元，可享无限历史记录和无限应用，但不包括高级 AI。因此，一个有 10 人的免费工作区，如果想拥有一个能回答有关自身 Slack 内容的问题的 AI，每年需要支付 1,800 美元；而更便宜的升级套餐无法满足这一需求。

这个软件包能让该工作区免费获得一个基于同一 Slack 的 Agent，并使用成员已经付费的 AI 订阅。它的工作方式有以下三点：

• 它不会安装 Slack 应用，因此不会占用 10 个应用名额。 如果你的工作区已经达到上限，这就是唯一剩下的集成添加方式。
• 它不需要管理员批准，因为它不是需要任何人批准的应用。它通过你自己的浏览器会话读取 Slack，访问权限与你现有的完全一致，不会更多。
• 它可以导出你仍能看到的内容。 在免费套餐中，超过 90 天的历史记录将无法再访问——Slack 自带的免费导出功能仅涵盖公开频道，且仅限管理员使用，因此不包括私信和私密频道。slack_get_full_conversation 会在这些内容仍处于可访问时间范围内时，将其连同线程一并导出。它无法找回已经超出范围的内容；没有任何工具能做到。

对于 Slack 自身的 AI 无法服务的工作区，通过浏览器会话访问并不是需要道歉的权宜之计，而是唯一可行的途径。

连接 Slack 的两种方式

Slack 官方 MCP 服务是一个由工作区管理员批准和管理的应用。当你的组织需要经过批准的集成时，请使用它。这个服务则使用 Chrome 中现有的浏览器会话，因此无需安装应用，也无需请求管理员批准；它可作为本地命令供任何 stdio MCP 客户端运行。它以你的身份操作，访问权限与你完全一致。

安装

推荐使用 Node 22 或 24。支持 Node 20+，并已通过 CI 测试。

npx -y @jtalk22/slack-mcp --setup

建议使用持久化 CLI：npm install -g @jtalk22/slack-mcp，然后运行 slack-mcp --setup。

然后：

1. 复制运行结束时 --setup 输出的 stdio 命令。
2. 将其粘贴到客户端，或运行它输出的 claude mcp add 命令。
3. 完全重启客户端。
4. 让 Agent 运行 slack_health_check。
5. 如果响应中出现工作区名称，说明连接已建立。

各客户端的配置键请参阅设置指南。

所有地方都使用相同的服务命令：

{
  "command": "npx",
  "args": ["-y", "@jtalk22/slack-mcp"]
}

在 macOS 上，设置过程可以从 Chrome 提取信息，并持久化所选的存储后端。在其他平台上，请通过客户端的环境配置提供 SLACK_TOKEN 和 SLACK_COOKIE。Docker、HTTP 和详细的客户端示例请参阅 docs/SETUP.md 和 docs/DEPLOYMENT-MODES.md。

20 个工具：读取、操作、自动化

读取频道、私信、线程并进行搜索；通过回复、添加回应或更改已读状态执行操作；在本地运行补齐进度和类型化工作流。目前提供 20 个工具：13 个只读操作、4 个写入路径工具（每个工具都带有 MCP 破坏性注释，客户端可据此限制对工作区的写入），以及 3 个本地工作流工具。其中一个读取工具是 slack_session_report，它不会从 Slack 读取任何内容，而是以计数形式返回此进程执行过的操作。每个工具都在此处执行工作——读取 Slack 或本地状态——没有任何工具只是占位符，也无需为其付费。4 个读取工具支持 include_rich_message_fields: true，以显示附件、区块、文件、回应和元数据。完整的输入和响应契约请参阅 docs/API.md。

同一个二进制文件支持 MCP 2026-07-28 和所有 2025 版修订：通过 stdio 协商版本，在 HTTP 中按请求保持无状态（没有 Mcp-Session-Id；GET/DELETE 返回 405）。这项声明由测试验证，而非仅仅写在文档里：test/mcp-era.test.js 使用真实 SDK 客户端，针对两个版本调用真实入口。

减少公布的工具数量。 服务公布的每个工具都会在每轮对话中、你提出任何问题之前，将其架构发送给模型。SLACK_MCP_TOOLS=essentials 会公布 6 个工具（未读消息、历史记录、搜索、线程、用户查找、发送）；SLACK_MCP_TOOLS=read 会公布 13 个只读操作；--tools=slack_x,slack_y 则指定一组工具。默认公布全部 20 个。筛选只会改变公布的内容，不会改变可调用的内容。

类型化工作流：Slack 输入，JSON 输出

将工作流类型与频道、优先关注人员、保留期限和周期绑定。随后，slack_catch_me_up 会在本地读取指定范围，并将依据交给你的 Agent：哪些讨论串尚未得到回复以及已持续多久，优先关注人员说了什么或被在哪些消息中提及，以及哪些对话确实有了进展。它负责收集信息；你的 Agent 则依据下方的约定撰写摘要。

这条路径中没有服务端模型，因为不需要——调用此服务的客户端本身就是语言模型。托管版则提供需要服务端支持的功能：即使你的笔记本电脑关机，也能按计划运行相同的跟进流程。

npx -y @jtalk22/slack-mcp --apply-template oncall-handoff --channels C012345,C067890

安全与来源

此服务返回的每条消息都会作为文本进入模型的上下文，与您自己的指令并列。Slack 是一个共享总线：频道中可能有来自其他工作区的 Slack Connect 参与者、访客，以及转发完全来自 Slack 外部内容的应用；而且，同一套工具既能读取，也能写入。这种读写并存的情况值得明确指出其风险。

• 凭据文件仅限所有者访问；仅使用 Keychain 的模式可让明文凭据不落盘。
• 遇到未知存储模式和无效配置时，配置会采取默认拒绝策略。
• 写入操作是原子的，共享凭据状态会受到进程锁保护。
• 本地 Web 服务器绑定到 localhost；工作区写入工具带有破坏性操作标注。
• 每次发布都通过 CI 发布，并带有 npm 来源证明。

npx -y @jtalk22/slack-mcp --read-only          # or SLACK_MCP_READ_ONLY=1

验证发行包

npm audit signatures

结果干净意味着你安装的软件包由此代码库的发行工作流构建并签名。将 Slack 会话交给它之前，请先阅读代码。完整政策见：SECURITY.md。

工作原理

这些工具由五个部分支撑：从 Chrome 提取数据、凭据存储、读取、写入，以及带类型的工作流输出。所有部分都是此代码库中的纯 JavaScript。

凭据

服务会按以下顺序检查，并使用找到的第一项。

会话凭据会过期，具体有效期不定：2026-07-04 写入的凭据到 2026-10-07 仍然有效。slack_token_status 会显示凭据的使用时长。如果 Slack 拒绝凭据（invalid_auth、not_authed、token_expired、token_revoked、account_inactive 或 HTTP 401），请运行 npx -y @jtalk22/slack-mcp --setup。在 macOS 上，slack_refresh_tokens 或 --refresh-tokens 可以在不离开客户端的情况下刷新凭据；docs/SETUP.md 中的可选 LaunchAgent 可让闲置安装保持正常运行。

{
  "mcpServers": {
    "slack-work": {
      "command": "npx",
      "args": ["-y", "@jtalk22/slack-mcp"],
      "env": { "SLACK_MCP_PROFILE": "work" }
    },
    "slack-personal": {
      "command": "npx",
      "args": ["-y", "@jtalk22/slack-mcp"],
      "env": { "SLACK_MCP_PROFILE": "personal" }
    }
  }
}

本地与托管服务

此软件包在你的设备上运行，只与 Slack 通信，并采用 MIT 许可证免费提供。托管版本则按计划运行，因此即使笔记本电脑关机，你也能及时收到简报：

• 按计划并根据你的时区补齐内容；
• 根据你保存的工作流配置文件生成简报；
• 在团队内共享配置文件；
• 发送至 Slack 或签名 Webhook。

无需托管版本也可以使用此软件包。

托管服务定价 →

文档

设置 · API · 架构 · 兼容性 · 部署模式 · 使用示例 · 故障排除 · 路线图

贡献

欢迎提交 PR。请阅读 CONTRIBUTING.md，并在提交前对修改过的 JavaScript 运行 node --check。

许可证

MIT — 详见 LICENSE。

免责声明

本项目与 Slack Technologies, Inc. 无关联。此服务使用浏览器会话凭据。运行前，请查看工作区的可接受使用政策。