Slack

by korotovsky
Verified
MIT License
18
  • Apple
  • Linux

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Mentioned as an option for exposing the MCP server to the internet with TLS encryption for the SSE transport method.

  • Allows interaction with Slack Workspaces, providing tools to retrieve channel histories and list available channels without requiring admin permissions or bot approvals.

Slack MCP サーバー

Slackワークスペース用のモデルコンテキストプロトコル(MCP)サーバー。この統合は、StdioとSSEの両方のトランスポートとプロキシ設定をサポートし、ワークスペース管理者による権限やボットの作成・承認は必要ありません😏。

機能デモ

ツール

  1. conversationsHistory
  • チャネルIDでチャネルからメッセージを取得する
  • 必要な入力:
    • channel_id (文字列): チャネルのID(形式:Cxxxxxxxxxx)
    • limit (数値、デフォルト: 28): 取得するメッセージの制限
  • 戻り値: タイムスタンプ、ユーザーID、テキストコンテンツを含むメッセージのリスト
  1. channelsList
  • チャンネルのリストを取得する
  • 必要な入力:
    • channelTypes (配列): 可能なチャネルタイプ。許可される値: 'mpim'、'im'、'public_channel'、'private_channel'。
    • sort (文字列): 並べ替えの種類。使用できる値: 'popularity' - 各チャンネルのメンバー/参加者数で並べ替えます。
  • 戻り値: チャンネルのリスト

セットアップガイド

1. 認証の設定

ブラウザで Slack を開いてログインします。

SLACK_MCP_XOXC_TOKEN検索

  • ブラウザの開発者コンソールを開きます。
  • Firefoxでは、メニューバーのTools -> Browser Tools -> Web Developer tools
  • Chromeでは、URLバーの右側にある「3つの点」ボタンをクリックし、 More Tools -> Developer Toolsを選択します。
  • コンソールタブに切り替えます。
  • 「貼り付けを許可する」と入力して、Enter キーを押します。
  • 次のスニペットを貼り付けて、ENTER キーを押して実行します: JSON.parse(localStorage.localConfig_v2).teams[document.location.pathname.match(/^\/client\/([A-Z0-9]+)/)[1]].token

トークンの値は実行されたコマンドの直後に印刷されます ( xoxc-で始まります)。とりあえずどこかに保存してください。

SLACK_MCP_XOXD_TOKEN検索

  • 「アプリケーション」タブに切り替えて、左側のナビゲーション ペインで「Cookie」を選択します。
  • dという名前のクッキーを見つけてください。そうです、文字dだけです。
  • この Cookie の値をダブルクリックします。
  • Ctrl+C または Cmd+C を押して、その値をクリップボードにコピーします。
  • 後で使用するために保存します。

2. インストール

次のいずれかのインストール方法を選択します。

2.1. ドッカー

すべての環境変数の詳細については、 「環境変数」を参照してください。

export SLACK_MCP_XOXC_TOKEN=xoxc-... export SLACK_MCP_XOXD_TOKEN=xoxd-... docker pull ghcr.io/korotovsky/slack-mcp-server:latest docker run -i --rm \ -e SLACK_MCP_XOXC_TOKEN \ -e SLACK_MCP_XOXD_TOKEN \ slack-mcp-server --transport stdio

2.2. Docker Compose

wget -O docker-compose.yml https://github.com/korotovsky/slack-mcp-server/releases/latest/download/docker-compose.yml wget -O .env https://github.com/korotovsky/slack-mcp-server/releases/latest/download/.env.dist nano .env # Edit .env file with your tokens from step 1 of the setup guide docker-compose up -d

2.2.1 TLSとインターネットへの公開

SSE に HTTPS を設定する必要がある理由はいくつかあります。

  • mcp-remote https スキームのみを処理できます。
  • 一般的に、インターネットに公開されるすべてのサービスに TLS を使用することをお勧めします。

ngrokを使うこともできます:

ngrok http 3001

次に、 mcp-remote引数にエンドポイントhttps://903d-xxx-xxxx-xxxx-10b4.ngrok-free.appを使用します。

3. 設定と使用方法

コマンドライン引数と環境変数を使用して MCP サーバーを構成できます。

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

stdioトランスポートを使用したオプション 1:

{ "mcpServers": { "slack": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "SLACK_MCP_XOXC_TOKEN=$SLACK_MCP_XOXC_TOKEN", "-e", "SLACK_MCP_XOXD_TOKEN=$SLACK_MCP_XOXD_TOKEN", "ghcr.io/korotovsky/slack-mcp-server", "mcp-server", "--transport", "stdio" ], "env": { "SLACK_MCP_XOXC_TOKEN": "xoxc-...", "SLACK_MCP_XOXD_TOKEN": "xoxd-..." } } } }

sseトランスポートを使用したオプション2:

2.2 の手順を完了し、 docker compose up -dを実行して MCP サーバーを起動するか、好みの方法で起動して構成します。

{ "mcpServers": { "slack": { "command": "npx", "args": [ "-y", "mcp-remote", "https://x.y.z.q:3001/sse", "--header", "Authorization: Bearer ${SLACK_MCP_SSE_API_KEY}" ], "env": { "SLACK_MCP_SSE_API_KEY": "my-$$e-$ecret" } } } }

Windows 上のsseトランスポートを使用したオプション 3:

2.2 の手順を完了し、 docker compose up -dを実行して MCP サーバーを起動するか、好みの方法で起動して構成します。

{ "mcpServers": { "slack": { "command": "C:\\Progra~1\\nodejs\\npx.cmd", "args": [ "-y", "mcp-remote", "https://x.y.z.q:3001/sse", "--header", "Authorization: Bearer ${SLACK_MCP_SSE_API_KEY}" ], "env": { "SLACK_MCP_SSE_API_KEY": "my-$$e-$ecret" } } } }

コンソール引数

口論必須 ?説明
--transportまたは-tはいMCP サーバーのトランスポートを選択します。可能な値はstdiosseです。

環境変数

変数必須 ?デフォルト説明
SLACK_MCP_XOXC_TOKENはいnil認証データ トークン フィールド、POST データ フィールド セットからのtoken ( xoxc-... )
SLACK_MCP_XOXD_TOKENはいnilクッキーdからの認証データ トークン ( xoxd-... )
SLACK_MCP_SERVER_PORTいいえ3001MCP サーバーが listen するポート
SLACK_MCP_SERVER_HOSTいいえ127.0.0.1MCP サーバーが listen するホスト
SLACK_MCP_SSE_API_KEYいいえniltransportsseの場合の認可ベアラートークン
SLACK_MCP_PROXYいいえnilMCP サーバーが使用するプロキシ URL
SLACK_MCP_SERVER_CAいいえnil信頼ストアの CA 証明書へのパス
SLACK_MCP_SERVER_CA_INSECUREいいえfalse安全でないリクエストはすべて信頼する(非推奨)

デバッグツール

# Run the inspector with stdio transport npx @modelcontextprotocol/inspector go run mcp/mcp-server.go --transport stdio # View logs tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

安全

  • APIトークンを共有しないでください
  • .env ファイルを安全かつプライベートに保つ

ライセンス

MITライセンス( LICENSEファイル参照)です。これはSlackの公式製品ではありません。

-
security - not tested
A
license - permissive license
-
quality - not tested

Slackワークスペース向けの最も強力なMCPサーバー。この統合は、StdioとSSEの両方のトランスポート、プロキシ設定をサポートし、ワークスペース管理者による権限やボットの作成・承認は必要ありません😏。

  1. Feature Demo
    1. Tools
      1. Setup Guide
        1. 1. Authentication Setup
        2. 2. Installation
        3. 3. Configuration and Usage
        4. Debugging Tools
      2. Security
        1. License
          ID: uy6bsglezr