Slack MCP Server

Slack MCP Server

https://github.com/modelcontextprotocol/servers/tree/0ad83e8dda5f3a46f0157c6f2c45e03f397d11a1/src/slack からフォークされています。

認証方式をボットトークンからユーザートークンに変更し、ダイレクトメッセージの読み取りやユーザーに代わってメッセージを送信するなど、より幅広いユースケースで MCP サーバーを利用できるようにしました。

Slack API 用の MCP サーバーで、Claude が Slack ワークスペースを操作できるようにします。

セットアップ

1. Slack アプリを作成します。

   • Slack Apps ページにアクセスします
   • 「Create New App」をクリックします
   • 「From scratch」を選択します
   • アプリに「Slack MCP Server」という名前を付け、ワークスペースを選択します

2. ユーザートークンのスコープを設定します。 「OAuth & Permissions」に移動し、ユーザートークンに次のスコープを追加します。

   • channels:history - パブリックチャンネルのメッセージやその他のコンテンツを表示する
   • channels:read - チャンネルの基本情報を表示する
   • chat:write - ユーザーとしてメッセージを送信する
   • reactions:write - メッセージに絵文字のリアクションを追加する
   • users:read - ユーザーとその基本情報を表示する
   • users.profile:read - ユーザーの詳細なプロフィールを表示する
   • groups:history - プライベートチャンネルのメッセージやその他のコンテンツを表示する
   • groups:read - チャンネルの基本情報を表示する
   • groups:write - プライベートチャンネルにメッセージを送信する
   • im:history - ダイレクトメッセージのメッセージやその他のコンテンツを表示する
   • im:read - ダイレクトメッセージの基本情報を表示する
   • im:write - ダイレクトメッセージにメッセージを送信する
   • mpim:history - 複数人のダイレクトメッセージのメッセージやその他のコンテンツを表示する
   • mpim:read - 複数人のダイレクトメッセージの基本情報を表示する
   • mpim:write - 複数人のダイレクトメッセージにメッセージを送信する

3. アプリをワークスペースにインストールします。

   • 「Install to Workspace」をクリックし、アプリを認証します
   • xoxp- で始まる「User OAuth Token」を保存します

4. npm install を実行して依存関係をインストールします。

ツール

1. slack_list_channels

   • ワークスペース内の公開チャンネルまたは事前定義されたチャンネルを一覧表示します
   • 任意の入力：
     • limit（数値、デフォルト：100、最大：200）：返すチャンネルの最大数
     • cursor（文字列）：次のページを取得するためのページネーションカーソル
   • 返り値：IDと情報を含むチャンネルの一覧

2. slack_post_message

   • Slack チャンネルに新しいメッセージを投稿します
   • 必須の入力：
     • channel_id（文字列）：投稿先チャンネルの ID
     • text（文字列）：投稿するメッセージのテキスト
   • 返り値：メッセージの投稿確認とタイムスタンプ

3. slack_reply_to_thread

   • 特定のメッセージスレッドに返信します
   • 必須の入力：
     • channel_id（文字列）：スレッドを含むチャンネル
     • thread_ts（文字列）：親メッセージのタイムスタンプ
     • text（文字列）：返信テキスト
   • 返り値：返信の確認とタイムスタンプ

4. slack_add_reaction

   • メッセージに絵文字リアクションを追加します
   • 必須の入力：
     • channel_id（文字列）：メッセージを含むチャンネル
     • timestamp（文字列）：リアクションを追加するメッセージのタイムスタンプ
     • reaction（文字列）：コロンなしの絵文字名
   • 返り値：リアクションの確認

5. slack_get_channel_history

   • チャンネルの最近のメッセージを取得します
   • 必須の入力：
     • channel_id（文字列）：チャンネルの ID
   • 任意の入力：
     • limit（数値、デフォルト：10）：取得するメッセージ数
   • 返り値：内容とメタデータを含むメッセージの一覧

6. slack_get_thread_replies

   • メッセージスレッド内のすべての返信を取得します
   • 必須の入力：
     • channel_id（文字列）：スレッドを含むチャンネル
     • thread_ts（文字列）：親メッセージのタイムスタンプ
   • 返り値：内容とメタデータを含む返信の一覧

7. slack_get_users

   • 基本的なプロフィール情報を含むワークスペースユーザーの一覧を取得します
   • 任意の入力：
     • cursor（文字列）：次のページを取得するためのページネーションカーソル
     • limit（数値、デフォルト：100、最大：200）：返すユーザーの最大数
   • 返り値：基本プロフィールを含むユーザーの一覧

8. slack_get_user_profile

   • 特定ユーザーの詳細なプロフィール情報を取得します
   • 必須の入力：
     • user_id（文字列）：ユーザーの ID
   • 返り値：詳細なユーザープロフィール情報

Claude Desktop での使用方法

以下を claude_desktop_config.json に追加します：

NPX

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_USER_TOKEN": "xoxp-your-user-token"
      }
    }
  }
}

docker

{
  "mcpServers": {
    "slack": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "SLACK_USER_TOKEN"],
      "env": {
        "SLACK_USER_TOKEN": "xoxp-your-bot-token"
      }
    }
  }
}

環境変数

1. SLACK_USER_TOKEN：必須。xoxp- で始まる Bot User OAuth Token です。

トラブルシューティング

権限エラーが発生した場合は、次の点を確認してください：

1. 必要なスコープがすべて Slack アプリに追加されていること
2. アプリがワークスペースに正しくインストールされていること
3. トークンとワークスペース ID が設定に正しくコピーされていること
4. アクセスが必要なチャンネルにアプリが追加されていること

ビルド

Docker ビルド：

docker build -t mcp/slack -f src/slack/Dockerfile .

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。つまり、MIT License の利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できます。詳しくは、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。