MCP Connector と Google/Slack 連携
ステータス
Owner: TBD · ステータス: draft · 正式な情報源: flezi.app.frontend.main/src/pages/McpServers.tsx, src/components/mcp-servers/
対象ユーザー
Model Context Protocol (MCP) を通じて Agent を外部ツールに接続したい管理者とメンバー向けです。アプリケーション上の画面名は MCP Connector です。
できること
- Streamable HTTP、SSE (legacy)、STDIO で Connector を追加できます。
- Test Connection を実行してハンドシェイクと Tools 一覧の検出を行えます。
- Connector を Agent に追加し、Workspace 単位または個別ユーザーへの直接付与で共有し、ユーザーごとの OAuth 権限を管理できます。Organization 全体での MCP 共有はまだ検証されていません。
- 組み込みの Google Workspace および Slack provider を OAuth 2.0 PKCE で接続できます。
Transport とステータス
| Transport / ステータス | 意味 |
|---|---|
| Streamable HTTP | 最新の MCP HTTP 向けのデフォルト Transport です。 |
| SSE (legacy) | このプロトコルを引き続きサポートする旧サーバー向けの SSE Transport です。 |
| STDIO | サービスの runtime 環境で command を使って MCP process を実行します。Command はインストール済みで、service runtime から executable を検索できなければなりません。 |
| Connected | 接続に成功し、Tools の検出が完了した状態です。 |
| Needs OAuth | Test または Tools の読み込み前にアカウントの権限付与が必要な状態です。メンバーごとに異なる場合があります。 |
| Error / Disconnected | 直近の接続に失敗した、または Connector が未接続の状態です。Card のエラーを確認して再試行してください。 |
Connector の追加
- Sidebar で MCP Servers を選択し、Add MCP Connector をクリックします。
- 表示名、URL/command、Transport を入力します。
- Streamable HTTP: MCP URL を使用します。
/api/v1/...のような通常の REST URL は入力しないでください。 - SSE (legacy): MCP server の SSE endpoint を使用します。
- STDIO: command と arguments を入力します。
${ENV_VAR}を使用できます。Command/arguments は shell token として分割されますが、shell 経由では実行されません。
- Streamable HTTP: MCP URL を使用します。
- Test Connection をクリックします。システムが Tools を検出します。30 秒以内に Tools 一覧を返さない server は、Run を無期限に待機させずエラーになります。
- Tools 一覧を確認して Save をクリックします。
- Agent Builder で、共有済みまたは自分の Connector を選択して Agent に bind します。
OAuth Connector
Needs OAuth の Connector では、Test Connection の前に Connect OAuth または Sign in with Google/Slack を完了してください。各ユーザーが個別に authorize する必要があり、あなたの token が他のメンバーと共有されることはありません。
Google Workspace と Slack
- Google Workspace MCP: Google Cloud OAuth App を設定するか、現在のアカウント用に
token.jsonを upload します。Tools は選択した Connector に応じて Gmail、Calendar、Drive を提供します。 - Slack MCP: Organization レベルで Slack Client ID/Client Secret を設定し、個人の Slack アカウントを authorize します。User token の代わりに bot token を使用しないでください。
よくある問題
- STDIO command not found: image または service host に package/executable をインストールします。対話型 terminal だけでなく、service runtime が使用 する PATH を確認してください。
- Needs OAuth: Account & OAuth タブを開き、アカウントを authorize してから再度 test します。共有された Connector でもメンバーごとに authorize が必要です。
- Test timeout: URL、transport、server の状態を確認します。Runtime の discovery 制限は 30 秒です。
- OAuth 後も Connected にならない: Backend が返す
oauth_result=successだけが成功を示します。mcp_connected=1だけでは不十分です。