slack

Slack MCP 服务

用于与 Slack 工作区集成的模型上下文协议（MCP）服务。此服务提供读取和发送消息、管理线程以及对 Slack 消息添加回应的工具。

功能

• 列出频道 - 查看所有可访问的公开和私有频道
• 读取频道 - 获取频道信息和最近的消息
• 读取线程 - 获取完整的线程对话
• 发送消息 - 向频道发送新消息
• 回复线程 - 继续线程对话
• 更新消息 - 编辑之前发送的消息
• 回应消息 - 为消息添加表情符号回应
• 上传文本片段 - 将文本内容作为文件片段上传（适用于超过消息长度限制的内容）

设置

先决条件

• 拥有创建应用权限的 Slack 工作区
• Slack Bot Token（参见下方说明）

环境变量

变量	必需	描述	默认值
SLACK_BOT_TOKEN	是	Slack Bot 用户 OAuth Token	-
ENABLED_TOOLGROUPS	否	以逗号分隔的工具组列表	全部启用

获取 Bot Token

1. 前往 api.slack.com/apps
2. 创建新应用或选择现有应用
3. 前往 OAuth & Permissions
4. 添加以下 Bot Token Scopes：
   • channels:read - 查看频道基本信息
   • channels:history - 查看公开频道中的消息
   • groups:read - 查看私有频道
   • groups:history - 查看私有频道中的消息
   • chat:write - 发送消息
   • reactions:write - 添加回应
   • files:write - 上传文件和文本片段
5. 将应用安装到工作区
6. 复制 Bot User OAuth Token（以 xoxb- 开头）

Claude Desktop

请准备好 Slack Bot Token。

然后按照下方的设置说明进行操作。如果这是你首次使用 MCP 服务，请确保已安装 Claude Desktop 应用程序，并按照 官方 MCP 设置说明进行操作。

手动设置

需要在计算机上安装 Node，以便在终端中运行 npx 命令。如果尚未安装 Node，可以从 nodejs.org 安装。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Windows：%APPDATA%\Claude\claude_desktop_config.json

修改 claude_desktop_config.json 文件并添加以下内容：

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "slack-workspace-mcp-server"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token-here"
      }
    }
  }
}

重启 Claude Desktop，即可开始使用！

可用工具

只读工具

工具	描述
slack_get_channels	列出所有可访问的频道
slack_get_channel	获取频道信息和最近的消息
slack_get_thread	获取包含所有回复的线程

写入工具

工具	描述
slack_post_message	向频道发送新消息
slack_reply_to_thread	回复现有线程
slack_update_message	更新之前发送的消息
slack_react_to_message	为消息添加表情符号回应
slack_upload_snippet	将文本内容作为文件片段上传到频道

工具组

你可以使用 ENABLED_TOOLGROUPS 环境变量控制可用工具：

• readonly - 仅限读取操作（获取频道、消息和线程）
• write - 所有操作，包括发送消息和添加回应

示例：设置 ENABLED_TOOLGROUPS=readonly 可禁用所有写入操作。

Development

# Install dependencies
npm run install-all

# Run in development mode
npm run dev

# Run tests
npm test                  # Functional tests
npm run test:integration  # Integration tests
npm run test:manual       # Manual tests (requires real credentials)

# Build
npm run build

License

MIT