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

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

Google Chat + Cursor

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 — Cursor にコネクタを追加

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

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Google Chat のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

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

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

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