Google Workspace MCP
Owner: TBD · Status: draft · 正式な情報源: flezi.app.frontend.main/src/components/mcp-servers/google/, flezi.app.api.backend/app/integrations/google/
対象ユーザー
Organization の OAuth を設定する管理者、および自分の Google Account の権限で Agent に Gmail、Google Calendar、Google Drive を利用させたいメンバー。
仕組み
Google Workspace connector は OAuth 2.0 + PKCE を使用します。OAuth app credentials は Organization レベルで管理され、access token は connector + user の組み合わせごとに保存・使用されます。connector を共有されたメンバーも、自分の Google Account を認証する必要があります。
他のユーザーの token.json をアップロードしたり、共有したりしないでください。トークンは特定のアカウントと connector に対して発行されます。自分のアカウントを disconnect しても、他のメンバーのアカウントは切断されません。
管理者向けの設定
-
Google Cloud Console で Web application タイプの OAuth Client を作成します。
-
Google connector の App Credentials 画面で
client_secret.jsonをアップロードするか、deployment の手順に従って credentials を設定します。 -
Backend/UI の status response から Authorized Redirect URI を取得し、Google Cloud Console にその URI を正確に登録します。URI の形式は次のとおりです。
https://<api-host>/api/v1/integrations/google/callback<api-host>は API host であり、SPA の既定の host ではありません。2 つの host が異なる場合、ブラウザーの origin から callback を推測しないでください。 -
他のメンバーが利用する必要がある場合は、Workspace または Organization に connector を共有します。
app credentials の書き込みには System Admin、Org Admin または Workspace Admin が必要です。通常のメンバーは status の確認、アカウントの authorize、共有された Tools の利用だけができます。
個人アカウントの接続
- MCP Servers を開き、Google connector を選択します。
- Account & OAuth タブを選択します。
- Sign in with Google をクリックし、表示された scopes を承認します。
- Flezi Galaxy に戻り、Connected の status を確認して Test Connection を実行します。
- token の期限切れや権限の変更があった場合は、Re-authenticate Account を使用できます。
選択中の connector に token.json を直接アップロードすることもできます。ファイルは有効な JSON で、token または access_token を含む必要があります。この方法でも token は現在の user ごとに保存され、共有 credential にはなりません。
Tools
組み込みの Google Workspace connector には、現在 7 個の tools が登録されています。
- Gmail:
gmail_search,gmail_read_message。 - Calendar:
calendar_list_events,calendar_get_event,calendar_create_event。 - Drive:
drive_search,drive_read_file。
主な上限は、Gmail の検索が最大 25 件、Calendar が最大 100 イベント、Drive が最大 100 ファイル、直接読み取るコンテンツが最大 100,000 文字です。Drive で直接読み取れないファイルの場合は、可能であれば metadata と web URL が返されます。
Backend は Chat や People など、他の hosted Google MCP endpoint 用の scopes にも対応付けられます。ただし、それらの tools が組み込みの flezi-mcp service に含まれることを意味するものではありません。対象 connector の Tools Explorer を確認してください。
切断とトラブルシューティング
- Needs OAuth: テストする前に、現在のアカウントを authorize します。
- 401: access token の期限が切れているか無効です。再認証してください。
- 403: scope が不足しているか、Google Cloud Console で API が有効になっていません。
- Tools が表示されない: provider、MCP URL、account status を確認してから、Test Connection を再実行します。
- OAuth から戻っても Connected にならない: Backend から
oauth_result=successが返った場合だけ、callback の成功が確認されます。