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

   • 返されるもの: 詳細なユーザープロフィール情報

Related MCP server: Slack Search MCP Server

設定

1. Slack アプリを作成する:

   • Slackアプリページにアクセスしてください

   • 「新しいアプリを作成」をクリックします

   • 「最初から」を選択

   • アプリに名前を付けてワークスペースを選択します

2. ボット トークン スコープを構成する:「OAuth と権限」に移動し、次のスコープを追加します。

   • channels:history - パブリックチャンネルのメッセージやその他のコンテンツを表示する

   • channels:read - 基本的なチャンネル情報を表示する

   • chat:write - アプリとしてメッセージを送信する

   • reactions:write - メッセージに絵文字反応を追加する

   • users:read - ユーザーとその基本情報を表示する

   • users.profile:read - ユーザーの詳細なプロフィールを表示する

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

   • 「ワークスペースにインストール」をクリックしてアプリを承認します

   • 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",
        "SLACK_CHANNEL_IDS": "C01234567, C76543210"
      }
    }
  }
}

ドッカー

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

VS Codeでの使用

簡単にインストールするには、以下のいずれかのインストールボタンをクリックしてください...

手動でインストールする場合は、VS Code のユーザー設定 (JSON) ファイルに次の JSON ブロックを追加します。Ctrl Ctrl + Shift + Pを押してPreferences: Open Settings (JSON)と入力すると、このブロックを追加できます。

オプションとして、ワークスペース内の.vscode/mcp.jsonというファイルに追加することもできます。これにより、他のユーザーと設定を共有できるようになります。

.vscode/mcp.jsonファイルではmcpキーは必要ないことに注意してください。

NPX

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "slack_bot_token",
        "description": "Slack Bot Token (starts with xoxb-)",
        "password": true
      },
      {
        "type": "promptString",
        "id": "slack_team_id",
        "description": "Slack Team ID (starts with T)"
      }
    ],
    "servers": {
      "slack": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-slack"],
        "env": {
          "SLACK_BOT_TOKEN": "${input:slack_bot_token}",
          "SLACK_TEAM_ID": "${input:slack_team_id}"
        }
      }
    }
  }
}

ドッカー

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "slack_bot_token",
        "description": "Slack Bot Token (starts with xoxb-)",
        "password": true
      },
      {
        "type": "promptString",
        "id": "slack_team_id",
        "description": "Slack Team ID (starts with T)"
      }
    ],
    "servers": {
      "slack": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "mcp/slack"],
        "env": {
          "SLACK_BOT_TOKEN": "${input:slack_bot_token}",
          "SLACK_TEAM_ID": "${input:slack_team_id}"
        }
      }
    }
  }
}

環境変数

1. SLACK_BOT_TOKEN : 必須。xoxb- xoxb-始まるボットユーザーのOAuthトークン。

2. SLACK_TEAM_ID : 必須。T T始まるSlackワークスペースID。

3. SLACK_CHANNEL_IDS : オプション。チャンネルアクセスを制限するためのチャンネルIDのカンマ区切りリスト（例："C01234567, C76543210"）。設定されていない場合は、すべてのパブリックチャンネルがリストされます。

トラブルシューティング

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

1. 必要なスコープがすべてSlackアプリに追加されます

2. アプリがワークスペースに正しくインストールされている

3. トークンとワークスペースIDが構成に正しくコピーされました

4. アプリはアクセスする必要があるチャンネルに追加されました

建てる

Docker ビルド:

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

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。