slack-patron-mcp
Provides tools to list channels, retrieve channel messages with time range and pagination, and get thread replies from a Slack workspace via the slack-patron API.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@slack-patron-mcpget the last 10 messages in #random"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
slack-patron-mcp
slack-patron (https://github.com/tsg-ut/slack-patron) のSlackメッセージ履歴APIをClaudeから利用するためのリモートMCPサーバー。
概要
トランスポート: Streamable HTTP (stateless)
認証: Bearer token (MCP_SERVER_AUTH_TOKEN)、および OAuth 2.1 (with PKCE)(Claude.ai カスタムコネクタ接続用)
上流API:
SLACK_PATRON_BASE_URL環境変数で設定
Related MCP server: Tarantella Slack MCP Server
利用可能なツール
ツール名 | 説明 |
| ワークスペースの全チャンネル一覧を取得 |
| ワークスペースの全ユーザー一覧を取得 |
| 特定ユーザーの詳細情報を取得 (ID またはユーザー名/表示名で検索) |
| チャンネルのメッセージ履歴を取得 (時刻範囲・ページネーション対応、添付ファイルは末尾に注記) |
| チャンネルのメッセージ履歴を生JSON形式で取得 |
| スレッドの返信一覧を取得 (添付ファイルは末尾に注記) |
| スレッドの返信一覧を生JSON形式で取得 |
| ElasticSearchクエリ文字列構文でメッセージを検索 |
| SlackにアップロードされたファイルをダウンロードしてコンテンツをSlack API経由で取得 |
get_user_info パラメータ
パラメータ | 型 | 必須 | 説明 |
| string | ✓ | Slack ユーザーID (例: U01234567) またはユーザー名/表示名 (例: taro, @taro) |
get_channel_messages パラメータ
パラメータ | 型 | 必須 | 説明 |
| string | ✓ | チャンネルID (C01234567) またはチャンネル名 (general, #general) |
| number | - | 取得件数 (1-200, デフォルト50) |
| string | - | 開始タイムスタンプ (例: 1700000000.000000) |
| string | - | 終了タイムスタンプ |
| string | - | ページネーションカーソル (前回レスポンスから取得) |
get_thread_replies パラメータ
パラメータ | 型 | 必須 | 説明 |
| string | ✓ | チャンネルID |
| string | ✓ | 親メッセージのタイムスタンプ |
| number | - | 取得件数 (1-200, デフォルト50) |
| string | - | ページネーションカーソル |
get_channel_messages / get_thread_replies は、メッセージに添付ファイルがある場合、行の末尾に注記を追加します。全ファイルが画像の場合は 添付画像あり、それ以外を含む場合は 添付ファイルあり と表示されます。
[2023-11-14T22:13:20.000Z] <U001>: look at this [添付画像あり(2件): https://example.com/example.jpg / fileId:F01234567, https://example.com/example2.png / fileId:F09876543]search_messages パラメータ
パラメータ | 型 | 必須 | 説明 |
| string | ✓ | ElasticSearchクエリ文字列。例: |
| number | - | 取得件数 (1-100, デフォルト20) |
| string | - | ページネーションカーソル (前回レスポンスから取得) |
download_file パラメータ
パラメータ | 型 | 必須 | 説明 |
| string | ✓ | Slack ファイルID (例: F1234567890) |
テキストファイル (text/*, application/json 等) はプレーンテキストとして返します。バイナリファイルはBase64エンコードして返します。5 MB を超えるファイルはダウンロードせず、メタデータのみ返します。
セットアップ
必要な環境変数
変数名 | 説明 |
| Claudeがこのサーバーに接続する際のBearerトークン |
| slack-patronの上流APIへのBearerトークン |
| slack-patron上流APIのベースURL (末尾スラッシュなし) |
| Slack APIトークン ( |
| ユーザーID→表示名マッピングのJSONファイルパス (省略時はIDをそのまま表示) |
| サーバーポート (デフォルト: 29112) |
ローカル開発
# 依存関係インストール
npm install
# 環境変数設定
cp .env.example .env
# .env を編集して実際の値を設定
# 開発サーバー起動 (ホットリロード付き)
npm run dev
# ビルド
npm run build
# テスト
npm testNginx設定
# 設定ファイルをコピー (nginx/ ディレクトリは .gitignore 対象のため各自作成)
sudo cp nginx/your-vhost-config /etc/nginx/sites-available/
# シンボリックリンク作成
sudo ln -s /etc/nginx/sites-available/your-vhost-config \
/etc/nginx/sites-enabled/your-vhost-config
# 設定確認と再読み込み
sudo nginx -t && sudo systemctl reload nginxClaude.ai / Claude Code コネクタ登録方法
1. Claude.ai (Web UI) で登録する場合 (OAuth 2.1)
Claude.ai (Enterprise または Pro) のカスタムコネクタとして登録する手順は以下の通りです。
1-1. コネクタの追加
Claude.ai の管理画面(「Organization Settings」 > 「Connectors」等)で、「Add custom connector」 を選択します。
サーバーのベースURL(例:
https://your-server.example.com)を入力します。※ Claude.ai からアクセスできるよう、公開URLであり HTTPS で保護されている必要があります。
認証方法(Authentication)として 「OAuth 2.0」 を選択します。
1-2. クライアント情報の設定
Client ID / Client Secret: 任意のダミーの文字列を入力します(例: Client IDに
claude-clientなど)。※ 本サーバーはシングルユーザー向けであるため、厳格な Client ID 制限は行わず、PKCE検証と設定されたパスワードによる認証のみで動作します。
メタデータの自動検出により、サーバーから提供される各種認証・トークンエンドポイント (
/.well-known/oauth-authorization-serverなど) が自動的に適用されます。
1-3. 同意画面での認可
コネクタを有効化する際、Claude から本サーバーの認可画面(
/oauth/authorize)にリダイレクトされます。パスワード入力欄が表示されるため、サーバーの環境変数
MCP_SERVER_AUTH_TOKENに設定されている Bearer Token (パスワード) を入力し、「アクセスを認可する」 ボタンをクリックします。認証に成功すると、自動的に Claude 側にリダイレクトされ、接続が完了します。以降、1年間有効な JWT アクセストークンが Claude に払い出され、本サーバーへの通信が認証されます。
2. Claude Code で登録する場合 (固定Bearerトークン)
Claude Code などの CLI ツールでは、ヘッダーに直接固定トークンを設定して接続できます。
~/.claude/settings.json に以下のように設定してください。
{
"mcpServers": {
"slack-patron": {
"type": "http",
"url": "https://your-server.example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_SERVER_AUTH_TOKEN"
}
}
}
}動作確認 curl コマンド
MCP の Streamable HTTP トランスポートでは Accept: application/json, text/event-stream ヘッダーが必須です (Claude クライアントは自動付与するが、curl では明示指定が必要)。
export TOKEN="your-mcp-server-auth-token"
export BASE="https://your-server.example.com"
# MCP リクエスト共通ヘッダー
MCP_HEADERS=('-H' 'Content-Type: application/json' '-H' 'Accept: application/json, text/event-stream')
# ヘルスチェック (認証不要)
curl "${BASE}/health"
# 認証失敗の確認
curl -X POST "${BASE}/mcp" \
"${MCP_HEADERS[@]}" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# → 401 Unauthorized
# ツール一覧
curl -X POST "${BASE}/mcp" \
-H "Authorization: Bearer ${TOKEN}" \
"${MCP_HEADERS[@]}" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# チャンネル一覧取得
curl -X POST "${BASE}/mcp" \
-H "Authorization: Bearer ${TOKEN}" \
"${MCP_HEADERS[@]}" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_channels","arguments":{}}}'
# メッセージ取得 (チャンネル名指定)
curl -X POST "${BASE}/mcp" \
-H "Authorization: Bearer ${TOKEN}" \
"${MCP_HEADERS[@]}" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_channel_messages","arguments":{"channel":"general","limit":10}}}'
# スレッド返信取得
curl -X POST "${BASE}/mcp" \
-H "Authorization: Bearer ${TOKEN}" \
"${MCP_HEADERS[@]}" \
-d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"get_thread_replies","arguments":{"channel":"C01234567","thread_ts":"1700000000.123456"}}}'セキュリティ
全シークレットは環境変数経由で管理 (コードにハードコードしない)
MCP認証はBearerトークン + タイミング安全比較 (
crypto.timingSafeEqual)ログにトークンやメッセージ内容を出力しない
上流APIエラー時はHTTPステータスコードのみ通知 (スタックトレース非公開)
slack-patronへのリクエストは常に
limitを指定し大量取得を防止書き込み系操作は一切実装しない (読み取り専用)
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/hakatashi/slack-patron-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server