MCP 経由で Google Chat を ChatGPT に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Google Chat をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Google Chat + ChatGPT

Google Chat で AI があなたとして作業します：スペース、グループチャット、ダイレクトメッセージを探し、メッセージとスレッドを読んで検索し、メンバー、リアクション、添付ファイルを確認し、スペースの変更を追い、メッセージや返信を投稿し、自分のメッセージを編集してリアクションします。Google Workspace アカウント、OAuth サインイン。メッセージとリアクションの削除はインストール時にオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

ステップ 1 — 認証情報を取得

設定は約 15 分です。Google Workspace アカウント（Business、Enterprise、Education）が必要です。Google Chat API のユーザーアクセスは個人の Gmail アカウントでは使えません。

1. https://console.cloud.google.com を開き、プロジェクトを選ぶか作成して、APIs & Services → Library で Google Chat API を有効にします。
2. ユーザーの代わりに Chat API を呼び出すために Google が必須としている Chat アプリを設定します。APIs & Services → Enabled APIs → Google Chat API → Configuration（https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat）を開き、**App name**（例: AnythingMCP）、Avatar URL（正方形の PNG または JPEG への任意の HTTPS リンク）、Description を入力し、Interactive features はオフのまま Save をクリックします。この手順を省くと、投稿が "Google Chat app not found" で失敗します。
3. APIs & Services → OAuth consent screen を開き、Internal（Google Workspace）を選びます。公開ステータスが Testing の External アプリは、7 日後にリフレッシュトークンを失います。
4. APIs & Services → Credentials → Create credentials → OAuth client ID を開き、アプリケーションの種類に Web application を選んで、承認済みのリダイレクト URI に <your AnythingMCP URL>/api/mcp-oauth/callback を、AnythingMCP Cloud では https://cloud.anythingmcp.com/api/mcp-oauth/callback を追加します。
5. クライアント ID を GOOGLE_CLIENT_ID に、クライアントシークレットを GOOGLE_CLIENT_SECRET に貼り付けて、コネクタをインストールします。
6. コネクタのページで Authorize with Provider をクリックし、AI に代わりに操作させる Google Workspace アカウントでサインインします。リフレッシュトークンは暗号化して保存され、アクセストークンは自動的に更新されます。
7. google_chat_list_spaces を実行します。サインインしたアカウントのスペース、グループチャット、ダイレクトメッセージが一覧されます。

すべての Google コネクタで 1 つの Google クライアント: 同じ Cloud プロジェクトと OAuth クライアントで、すべての Google コネクタ（Gmail、Calendar、Drive、Sheets、Docs、Chat など）を使えます。そのプロジェクトで各 API を有効にし、GOOGLE_CLIENT_ID と GOOGLE_CLIENT_SECRET を再利用して、各コネクタを一度ずつ認可します。各コネクタは自分のスコープだけを要求します。

誰の名前で書くか: コネクタはサインインしたユーザーとして読み取り、投稿、編集を行い、本人が入力したのと同じに見えます。見えるのはそのユーザーが参加しているスペースだけです。あなたの名前で投稿する前に、AI はあなたに確認するべきです。

スコープ: chat.spaces.readonly（スペースの閲覧）、chat.messages（自分のメッセージとリアクションの閲覧、投稿、編集、削除）、chat.memberships.readonly（メンバーの閲覧）。読み取り専用にするには、コネクタの OAuth 設定で chat.messages を https://www.googleapis.com/auth/chat.messages.readonly に変えて再認可し、google_chat_create_message、google_chat_reply_in_thread、google_chat_update_message、google_chat_add_reaction をオフにします。

読み取れるデータ: 参加しているすべてのスペース、グループチャット、ダイレクトメッセージ（google_chat_list_spaces、spaceType の SPACE、GROUP_CHAT、DIRECT_MESSAGE で絞り込み）、名前による名前付きスペースの検索（google_chat_search_spaces、例: display_name:"Marketing" AND space_type = "SPACE"）、特定の相手との既存のダイレクトメッセージ（google_chat_find_direct_message）、スペースの詳細とメンバー。スペースのメッセージを古い順に、または order_by create_time desc で新しい順に読み、日時（create_time > "2026-10-01T00:00:00Z"）や 1 つのスレッドで絞り込めます。すべてのスペースとダイレクトメッセージを対象にしたキーワード検索は新しい順で、sender.name = "users/[email protected]"、createTime >= "2026-10-01T00:00:00Z"、annotations.user_mentions.user.name:me（自分へのメンション）、attachment:*、has_link()、is_unread() などの条件が使えます。メッセージへのリアクション、メッセージの添付ファイル、過去 28 日間のスペースの変更履歴（新規、変更、削除されたメッセージ、リアクション、メンバーシップ、スペースの変更）も読めます。google_chat_list_space_events のフィルタには google.workspace.chat.message.v1.created のようなイベントタイプを少なくとも 1 つ指定します。

書き込める操作: スペース、グループチャット、ダイレクトメッセージへのメッセージ投稿（スレッド形式のスペースでは新しいスレッドを始めます）、メッセージの thread.name で指定した既存スレッドへの返信、自分のメッセージのテキストの置き換え（他の人には編集済みと表示されます）、絵文字リアクションの追加。request_id を渡すと、再試行した投稿が二重になりません。

インストール時はオフ: google_chat_delete_message と google_chat_delete_reaction です。削除したメッセージは元に戻せないため、チームに必要なときに管理者がオンにします。

データ形式: Chat はリソースをパスで表します。スペースは spaces/AAAAMpdlehY、メッセージは spaces/AAAAMpdlehY/messages/ZJ7sqN6qlYk.ZJ7sqN6qlYk、スレッドは spaces/AAAAMpdlehY/threads/FHT5Rc21TfA、人は users/123456789 です。ツールは space_id（spaces/ の後ろの部分）と message_id（/messages/ の後ろの部分）を別々に受け取り、thread_name と user は完全な名前で受け取ります。フィルタと google_chat_find_direct_message では users/[email protected] のようにメールアドレスも使えます。送信者とメンバーは通常表示名なしで返るため、AI は ID かメールで人を照合します。時刻は UTC の RFC 3339（2026-10-29T14:05:31.123Z）です。カードの内容は応答に含まれません。メッセージ本文では *太字*、_斜体_、~取り消し線~、バッククォートで囲んだインラインコード、<https://example.com|label> 形式のリンク、<users/123456789> や <users/all> によるメンションが使え、1 件は最大 32,000 バイトです。アップロードされた添付ファイルは 10 MB までダウンロードできます。Google ドライブのファイル（source が DRIVE_FILE）は、driveDataRef.driveFileId を使って Google Drive コネクタで読みます。

ページングと制限: 続きがある間、応答には nextPageToken が含まれます。AI はそれを page_token に入れて同じツールを呼び直します。google_chat_list_messages は既定で 1 ページ 25 件です。Google Chat の上限はプロジェクトあたり毎分約 3,000 回の読み取り、スペースあたり毎秒約 1 件のメッセージです。制限に達すると 429 RESOURCE_EXHAUSTED が返るので、待ってから再試行します。メッセージ検索は Chat アプリからのメッセージとミュートしたスペースを対象外にしますが、google_chat_list_messages ではそれらも読めます。

よくあるエラー: 401 は認可の期限切れか取り消しです。もう一度 Authorize with Provider をクリックします。403 PERMISSION_DENIED は、Chat API が有効でない、スコープが足りない、Google Workspace アカウントではない、またはそのスペースでその操作（他の人のメッセージの編集など）が許可されていないことを意味します。404 NOT_FOUND は、スペースやメッセージの ID の誤り、参加していないスペース、または投稿時に手順 2 の Chat アプリが設定されていないことを意味します。google_chat_find_direct_message は、その相手とダイレクトメッセージをしたことがなければ 404 を返します。400 INVALID_ARGUMENT は Google が受け付けないフィルタです。引用符、演算子、フィールド名を確認してください。

このコネクタは、スペースの作成、メンバーの追加や削除、新しいダイレクトメッセージの開始、ファイルのアップロード、カードの送信、Chat アプリのボットとしての投稿、固定メッセージや既読状態の操作は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — ChatGPT にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

ChatGPT では、Web 版の Plugins ページから MCP サーバーをプラグインとして追加します。有料プランで利用でき、開発者モードはもう必要ありません。Business ワークスペースで追加できるのは管理者とオーナーだけです。Enterprise・Edu では、管理者が Create plugins with MCPs 権限を付与できます。

1. chatgpt.com/plugins を開き、Add をクリックして Add custom MCP server を選びます。
2. 名前を入力します（例: Name: Google Chat）。
3. Connection の Server URL に https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力し、Authentication は OAuth のままにします。
4. I understand and want to continue を選び、Create as a plugin をクリックします。ChatGPT に求められたら AnythingMCP にサインインし、アクセスを許可します。
5. 個人用プラグインから新しいプラグインをインストールし、チャットで @ を入力して選択します。

利用可能なツール

プロンプトの例

• 「今週 Marketing スペースで何が話し合われた？スレッドごとに 2 行でまとめて。」
• 「過去 3 日間の未読メッセージのうち、自分がメンションされているものを探して。」
• 「第 4 四半期の予算のスレッドに返信の下書きを作って、投稿する前に見せて。」
• 「[email protected] に、資料のレビュー準備ができたとダイレクトメッセージを送って。」
• 「10 月に Product スペースで共有されたファイルはどれ？」

FAQ

ChatGPT の無料プランでカスタム MCP サーバーは使えますか? OpenAI がカスタム MCP サーバーを案内しているのは有料プランだけで、Free プランは対象に含まれていません。

次のステップ

• コネクタのランディング
• Claude に接続
• Cursor に接続
• Gemini に接続
• Meta Muse に接続
• Microsoft Copilot に接続