メインコンテンツまでスキップ

Slack MCP

ステータス

Owner: TBD · Status: draft · 正式な情報源: flezi.app.frontend.main/src/components/mcp-servers/slack/, flezi.app.api.backend/app/integrations/slack/

対象ユーザー​

Organization で Slack MCP を有効にする管理者、および自分の user 権限で Agent に Slack 上の操作を行わせたいメンバー。

仕組み​

Slack connector は hosted MCP endpoint と、Slack の user-centric OAuth を使用します。

MCP endpoint: https://mcp.slack.com/mcp
Authorization: https://slack.com/oauth/v2_user/authorize
Token endpoint: https://slack.com/api/oauth.v2.user.access

この flow は OAuth 2.0 PKCE を使用します。Flezi Galaxy は connector + user の組み合わせごとに token を保存し、user token を bot token に置き換えることはありません。

管理者向けの設定​

  1. Slack app を作成または開き、Slack MCP Server capability を有効にします。

  2. Organization で使用する tools に必要な user scopes を追加します。

  3. 次の Redirect URL を正確に登録します。

    https://<api-host>/api/v1/integrations/slack/callback

    Backend が connector status で返す URI を使用してください。<api-host> は API host であり、SPA の origin とは限りません。

  4. Slack MCP setup タブで Slack Client ID と Slack Client Secret を入力します。Secret は server にだけ保存され、status response に返されることはありません。

  5. Workspace のポリシーで必要な場合は、Slack の workspace admin に integration を承認してもらいます。

app credentials の管理には System Admin、Org Admin または Workspace Admin が必要です。Client ID は先に保存できますが、server-side の Client Secret が利用可能になるまで authorize flow は実行されません。

アカウントの接続​

  1. MCP Servers を開き、Slack connector を選択します。
  2. Account & OAuth タブで、要求された user scopes を確認します。
  3. Sign in with Slack をクリックし、権限を承認します。
  4. Workspace、Slack user ID、Connected status を確認します。
  5. Test Connection を実行して tools を検出します。

各メンバーは個別に authorize する必要があります。自分のアカウントを disconnect しても、その connector に対する自分の token だけが削除されます。

Tools と scopes​

Tools Explorer に表示される tools は、endpoint と Slack が付与した scopes によって異なります。一般的には次のグループがあります。

  • message や thread の検索と読み取り。
  • channel と conversation の一覧表示。
  • channel または thread への message 送信。
  • app に該当する scope が付与されている場合の users、files、canvases、lists へのアクセス。

Organization の要件に必要な最小限の scopes を使用してください。Backend では SLACK-OAUTH-SCOPES によって scopes を上書きできます。

トラブルシューティング​

  • Client Secret required: setup タブで secret を入力します。Slack の code exchange には server-side secret が必要です。
  • Needs OAuth: Test Connection の前に、現在のアカウントを authorize します。
  • Bot token rejected: この connector には user OAuth flow で取得した user token が必要で、xoxb- bot token は使用できません。
  • 403 または Tools が不足している: user scopes、Slack MCP Server capability、workspace admin による承認を確認します。
  • OAuth から UI に戻っても Connected にならない: callback Backend から oauth_result=success が返った場合だけ成功です。mcp_connected=1 だけでは不十分です。

関連ページ​