slack

Slack MCP サーバー

Slack ワークスペースと連携するための Model Context Protocol（MCP）サーバーです。このサーバーは、Slack のメッセージの読み取りと書き込み、スレッドの管理、メッセージへのリアクションに使えるツールを提供します。

機能

• チャンネルの一覧表示 - アクセス可能なすべてのパブリックチャンネルとプライベートチャンネルを表示します
• チャンネルの読み取り - チャンネル情報と最近のメッセージを取得します
• スレッドの読み取り - スレッド形式の会話全体を取得します
• メッセージの投稿 - チャンネルに新しいメッセージを送信します
• スレッドへの返信 - スレッド形式の会話を続けます
• メッセージの更新 - 投稿済みのメッセージを編集します
• メッセージへのリアクション - メッセージに絵文字のリアクションを追加します
• スニペットのアップロード - テキストをファイルスニペットとしてアップロードします（メッセージの上限を超える長文向け）

セットアップ

前提条件

• アプリを作成する管理者権限がある Slack ワークスペース
• Slack Bot Token（以下の手順を参照）

環境変数

変数	必須	説明	デフォルト
SLACK_BOT_TOKEN	はい	Slack Bot User 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 セットアップ手順に従ってください。

手動セットアップ

ターミナルで npx コマンドを実行できるよう、マシンに Node を用意する必要があります。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