Come collegare Google Chat a Microsoft Copilot via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Google Chat, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Google Chat + Microsoft Copilot

Fai lavorare la tua AI in Google Chat a tuo nome: trova spazi, chat di gruppo e messaggi diretti, leggi e cerca messaggi e thread, vedi membri, reazioni e allegati, segui cosa è cambiato in uno spazio, pubblica messaggi e risposte, modifica i tuoi messaggi e reagisci. Account Google Workspace, accesso OAuth; l'eliminazione di messaggi e reazioni è disattivata all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

Step 1 — Ottieni le credenziali

La configurazione richiede circa 15 minuti. Ti serve un account Google Workspace (Business, Enterprise o Education): l'accesso utente della Google Chat API non funziona con gli account Gmail personali.

1. Apri https://console.cloud.google.com, scegli o crea un progetto, poi vai su APIs & Services → Library e attiva la Google Chat API.
2. Configura la Chat app, che Google richiede per le chiamate alla Chat API fatte per conto di un utente: apri APIs & Services → Enabled APIs → Google Chat API → Configuration (https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat). Compila App name (ad esempio AnythingMCP), Avatar URL (un qualsiasi link HTTPS a un PNG o JPEG quadrato) e Description, lascia spente le Interactive features e clicca Save. Senza questo passo la pubblicazione fallisce con "Google Chat app not found".
3. Apri APIs & Services → OAuth consent screen e scegli Internal (Google Workspace). Un'app External con stato di pubblicazione Testing perde il refresh token dopo 7 giorni.
4. Apri APIs & Services → Credentials → Create credentials → OAuth client ID, scegli il tipo di applicazione Web application e aggiungi il redirect URI autorizzato <your AnythingMCP URL>/api/mcp-oauth/callback, su AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback.
5. Incolla il client ID in GOOGLE_CLIENT_ID e il client secret in GOOGLE_CLIENT_SECRET, poi installa il connettore.
6. Nella pagina del connettore clicca Authorize with Provider e accedi con l'account Google Workspace con cui l'AI deve agire. Il refresh token viene salvato cifrato e gli access token si rinnovano da soli.
7. Esegui google_chat_list_spaces: elenca gli spazi, le chat di gruppo e i messaggi diretti dell'account collegato.

Un solo client Google per tutti i connettori Google: lo stesso progetto Cloud e lo stesso client OAuth possono servire ogni connettore Google (Gmail, Calendar, Drive, Sheets, Docs, Chat e altri). Attiva ogni API in quel progetto, riusa GOOGLE_CLIENT_ID e GOOGLE_CLIENT_SECRET e autorizza ogni connettore una volta; ognuno chiede solo i propri scope.

A nome di chi scrive: il connettore legge, pubblica e modifica come l'utente collegato, esattamente come se scrivesse lui, e vede solo gli spazi di cui quell'utente fa parte. L'AI dovrebbe chiederti conferma prima di pubblicare a tuo nome.

Scope: chat.spaces.readonly (vedere gli spazi), chat.messages (leggere, pubblicare, modificare ed eliminare i tuoi messaggi e reazioni) e chat.memberships.readonly (vedere i membri). Per una configurazione in sola lettura cambia chat.messages in https://www.googleapis.com/auth/chat.messages.readonly nelle impostazioni OAuth del connettore, autorizza di nuovo e disattiva google_chat_create_message, google_chat_reply_in_thread, google_chat_update_message e google_chat_add_reaction.

Cosa legge: ogni spazio, chat di gruppo e messaggio diretto di cui fai parte (google_chat_list_spaces, filtrato per spaceType SPACE, GROUP_CHAT o DIRECT_MESSAGE), gli spazi con nome cercati per nome (google_chat_search_spaces, ad esempio display_name:"Marketing" AND space_type = "SPACE"), il messaggio diretto già esistente con una persona (google_chat_find_direct_message), i dettagli e i membri di uno spazio. I messaggi di uno spazio, dal più vecchio o dal più recente con order_by create_time desc, filtrati per data (create_time > "2026-10-01T00:00:00Z") o su un singolo thread. Una ricerca per parole chiave in tutti gli spazi e messaggi diretti, dal più recente, con condizioni come sender.name = "users/[email protected]", createTime >= "2026-10-01T00:00:00Z", annotations.user_mentions.user.name:me (messaggi che ti menzionano), attachment:*, has_link() o is_unread(). Le reazioni a un messaggio, gli allegati di un messaggio e il registro delle modifiche di uno spazio degli ultimi 28 giorni: messaggi nuovi, modificati ed eliminati, reazioni, iscrizioni e modifiche allo spazio (google_chat_list_space_events, il filtro deve indicare almeno un tipo di evento come google.workspace.chat.message.v1.created).

Cosa scrive: pubblica un messaggio in uno spazio, una chat di gruppo o un messaggio diretto (in uno spazio con thread ne apre uno nuovo), risponde in un thread esistente indicato dal thread.name di un messaggio, sostituisce il testo dei tuoi messaggi (gli altri li vedono segnati come modificati) e aggiunge reazioni emoji. Con request_id un post ripetuto non compare due volte.

Disattivati all'installazione: google_chat_delete_message e google_chat_delete_reaction. Un messaggio eliminato non si può recuperare, quindi un admin li attiva quando il team ne ha bisogno.

Formati dei dati: Chat identifica tutto con percorsi: uno spazio è spaces/AAAAMpdlehY, un messaggio spaces/AAAAMpdlehY/messages/ZJ7sqN6qlYk.ZJ7sqN6qlYk, un thread spaces/AAAAMpdlehY/threads/FHT5Rc21TfA, una persona users/123456789. I tool prendono separatamente space_id (la parte dopo spaces/) e message_id (la parte dopo /messages/), mentre thread_name e user vanno per intero. Nei filtri e in google_chat_find_direct_message funziona anche un'email, come users/[email protected]. Mittenti e membri tornano di solito senza nome visualizzato, quindi l'AI riconosce le persone da ID o email. Gli orari sono RFC 3339 in UTC (2026-10-29T14:05:31.123Z). Il contenuto delle card resta fuori dalle risposte. Il testo dei messaggi supporta *grassetto*, _corsivo_, ~barrato~, codice inline tra backtick, link come <https://example.com|label> e menzioni come <users/123456789> o <users/all>; un messaggio contiene al massimo 32.000 byte. Gli allegati caricati si scaricano fino a 10 MB; i file di Google Drive (source DRIVE_FILE) si leggono con il connettore Google Drive tramite driveDataRef.driveFileId.

Paginazione e limiti: le risposte contengono nextPageToken finché ci sono altri risultati; l'AI richiama lo stesso tool con page_token. google_chat_list_messages restituisce di default 25 messaggi per pagina. Google Chat consente circa 3.000 letture al minuto per progetto e circa 1 messaggio al secondo per spazio; una chiamata limitata risponde 429 RESOURCE_EXHAUSTED: aspetta e riprova. La ricerca nei messaggi salta quelli delle Chat app e degli spazi silenziati; google_chat_list_messages li legge comunque.

Errori comuni: 401 significa che l'autorizzazione è scaduta o è stata revocata: clicca di nuovo Authorize with Provider. 403 PERMISSION_DENIED significa che la Chat API non è attiva, manca uno scope, l'account non è Google Workspace oppure non puoi farlo in quello spazio, ad esempio modificare il messaggio di un altro. 404 NOT_FOUND è un ID di spazio o messaggio sbagliato, uno spazio di cui non fai parte oppure, quando pubblichi, una Chat app non configurata al passo 2. google_chat_find_direct_message risponde 404 se con quella persona non hai mai avuto un messaggio diretto. 400 INVALID_ARGUMENT è un filtro che Google non accetta: controlla virgolette, operatori e nomi dei campi.

Il connettore non crea spazi, non aggiunge né rimuove membri, non apre nuovi messaggi diretti, non carica file, non invia card, non pubblica come bot di una Chat app e non gestisce messaggi fissati o stato di lettura.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Microsoft Copilot

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Google Chat.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

Tool disponibili

Esempi di prompt

• "Di cosa si è parlato questa settimana nello spazio Marketing? Riassumi ogni thread in due righe."
• "Trova i messaggi non letti degli ultimi tre giorni in cui vengo menzionato."
• "Scrivi una bozza di risposta nel thread sul budget del Q4 e fammela vedere prima di pubblicarla."
• "Manda un messaggio diretto a [email protected] per dirle che la presentazione è pronta per la revisione."
• "Quali file sono stati condivisi a ottobre nello spazio Prodotto?"

FAQ

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse