Slack MCP Server

Slack MCP サーバー

Slack API 用の MCP サーバーです。Claude が Slack ワークスペースとやり取りできるようにします。

ツール

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
   • 戻り値：ユーザーの詳細なプロフィール情報

セットアップ

1. Slack App を作成します：

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

2. Bot Token Scopes を設定します： 「OAuth & Permissions」に移動し、次のスコープを追加します：

   • channels:history - 公開チャンネルのメッセージやその他のコンテンツを表示する
   • channels:read - チャンネルの基本情報を表示する
   • chat:write - アプリとしてメッセージを送信する
   • reactions:write - メッセージに絵文字リアクションを追加する
   • users:read - ユーザーとその基本情報を表示する

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

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

4. こちらのガイドに従って、チーム ID（Tで始まる）を取得します

Claude Desktop での使用方法

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

npx

{
  "mcpServers": {
    "slack": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token",
        "SLACK_TEAM_ID": "T01234567"
      }
    }
  }
}

docker

{
  "mcpServers": {
    "slack": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SLACK_BOT_TOKEN",
        "-e",
        "SLACK_TEAM_ID",
        "mcp/slack"
      ],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-bot-token",
        "SLACK_TEAM_ID": "T01234567"
      }
    }
  }
}

トラブルシューティング

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

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

ビルド

Docker ビルド：

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

ライセンス

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