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: Slack Feedback MCP Server

利用可能なツール

get_user_info パラメータ

get_channel_messages パラメータ

order はページ内の表示順のみを変更します。取得されるのは常に指定範囲の最新側から limit 件であり、cursor は常により古い方向へ進みます。そのため order: "asc" の場合、カーソルの案内文はメッセージ一覧の先頭に出力されます。

get_thread_replies パラメータ

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]

get_channel_messages は、メッセージに thread_ts がセットされている場合、行の末尾に注記を追加します。

• thread_ts が自身の ts と一致する場合 (スレッドの親メッセージ): [スレッドに返信があります / ts:...]

• thread_ts が自身の ts と一致しない場合 (チャンネルにもブロードキャストされたスレッド返信): [スレッドから公開されたメッセージです / thread_ts:...]

[2023-11-14T22:13:20.000Z] <U001>: first message [スレッドに返信があります / ts:1700000000.000000]
[2023-11-14T22:15:00.000Z] <U002>: broadcasted reply [スレッドから公開されたメッセージです / thread_ts:1700000000.000000]

post_message パラメータ

投稿前にメッセージはサニタイズされます。Slackのリンク記法 (<https://example.com> または <https://example.com|label>、http/https スキームのみ) だけはそのまま通し、それ以外の &、<、> はすべてエスケープされます。これにより <!channel>、<!here>、<@USER_ID>、<#CHANNEL_ID> のようなSlackマークアップは、Slack側でメンションやチャンネル参照として解釈されず、そのままリテラルなテキストとして表示されます (リンクのラベル部分に < や > を含めることもできないため、偽装リンクでマークアップを紛れ込ませることもできません)。

search_messages パラメータ

download_file パラメータ

テキストファイル (text/*, application/json 等) はプレーンテキストとして返します。バイナリファイルはBase64エンコードして返します。5 MB を超えるファイルはダウンロードせず、メタデータのみ返します。

セットアップ

必要な環境変数

ローカル開発

# 依存関係インストール
npm install

# 環境変数設定
cp .env.example .env
# .env を編集して実際の値を設定

# 開発サーバー起動 (ホットリロード付き)
npm run dev

# ビルド
npm run build

# テスト
npm test

Nginx設定

# 設定ファイルをコピー (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 nginx

Claude.ai / Claude Code コネクタ登録方法

1. Claude.ai (Web UI) で登録する場合 (OAuth 2.1)

Claude.ai (Enterprise または Pro) のカスタムコネクタとして登録する手順は以下の通りです。

1-1. コネクタの追加

1. Claude.ai の管理画面（「Organization Settings」 > 「Connectors」等）で、「Add custom connector」 を選択します。

2. サーバーのベースURL（例: https://your-server.example.com）を入力します。

   • ※ Claude.ai からアクセスできるよう、公開URLであり HTTPS で保護されている必要があります。

3. 認証方法（Authentication）として 「OAuth 2.0」 を選択します。

1-2. クライアント情報の設定

1. Client ID / Client Secret: 任意のダミーの文字列を入力します（例: Client IDに claude-client など）。

   • ※ 本サーバーはシングルユーザー向けであるため、厳格な Client ID 制限は行わず、PKCE検証と設定されたパスワードによる認証のみで動作します。

2. メタデータの自動検出により、サーバーから提供される各種認証・トークンエンドポイント (/.well-known/oauth-authorization-server など) が自動的に適用されます。

1-3. 同意画面での認可

1. コネクタを有効化する際、Claude から本サーバーの認可画面（/oauth/authorize）にリダイレクトされます。

2. パスワード入力欄が表示されるため、サーバーの環境変数 MCP_SERVER_AUTH_TOKEN に設定されている Bearer Token (パスワード) を入力し、「アクセスを認可する」 ボタンをクリックします。

3. 認証に成功すると、自動的に 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 を指定し大量取得を防止

• 書き込み系操作は一切実装しない (読み取り専用)