> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/avanzate/integrazioni/model-context-protocol-mcp-su-aisuru/mcp-di-aisuru-quali-sono-e-come-si-attivano/22.-google-workspace-mcp-server.md).

# 22. Google Workspace MCP Server

Collegando Google Workspace al tuo agente, colleghi Docs, Sheets, Slides, Drive, Calendar e Gmail, sempre per conto dell'utente che accede con Google.

## Cosa può fare

* Crea e organizza file su Google Drive;
* Leggi e modifica Docs, Sheets e Slides;
* Crea e visualizza eventi di Google Calendar;
* Invia email con Gmail.

## Esempi

*"Crea un Doc con il verbale della riunione di oggi e condividilo con il team."*\
\
*"Aggiungi una riga con questo nuovo contatto al foglio "Leads"."*\
\
*"Pianifica una chiamata con il cliente venerdì alle 11."*

## Come funziona l'accesso

Ogni utente collega il proprio account Google tramite un accesso sicuro direttamente nella chat: l'agente mostra un pulsante "Accedi con Google", l'utente concede le autorizzazioni e, da quel momento, l'agente opera solo sui dati di quell'account.

## Parametri di configurazione

| Parametro                        | Obbligatorio | Descrizione                                                                                                                                                                                                                                                                           |
| -------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `GOOGLE CLIENT ID`               | No           | ID client OAuth della tua app GCP (se vuoi usare una tua app con il tuo brand). Se lasciato vuoto, AIsuru utilizza l'app Google condivisa di Memori.                                                                                                                                  |
| `GOOGLE CLIENT SECRET`           | No           | Secret client OAuth della tua app GCP. Obbligatorio solo se imposti `GOOGLE_CLIENT_ID`.                                                                                                                                                                                               |
| `IDENTITY STRICT`                | No           | `true`/`false`. Predefinito: `true`. Verifica l'identità dell'utente nella chat prima di ogni azione.                                                                                                                                                                                 |
| `IDENTITY STRICT GOOGLE ACCOUNT` | No           | `true`/`false`. Predefinito: `true`. L'account Google collegato deve corrispondere all'email dell'utente AIsuru nella chat (IDENTITY STRICT deve essere true). Se true, le azioni verranno eseguite solo quando l'email dell'account AIsuru corrisponde a quella dell'account Google. |

### Parametri personalizzati

Non sono necessari parametri aggiuntivi.

{% hint style="warning" %}
Alcune funzionalità (modifica strutturata di Docs/Sheets/Slides, invio di Gmail) richiedono scope "sensibili" che Google approva dopo una revisione della tua applicazione. Finché la verifica non è completata, tali azioni potrebbero non essere disponibili.
{% endhint %}

### Parametri di configurazione: la tua app Google Cloud

1. Apri **Google Cloud Console** e crea (oppure seleziona) un progetto;
2. Abilita le API necessarie: Google Drive, Docs, Sheets, Slides, Calendar, Gmail;
3. Configura la **schermata di consenso OAuth** (nome dell'app, logo, domini, link all'informativa sulla privacy).
4. Crea credenziali **OAuth client ID** di tipo "Web application" con URI di reindirizzamento`https://mcp.aisuru.ai/oauth/google/callback`
5. Copia il **Client ID** e il **Client secret**

{% hint style="info" %}
**Nota:** per l'uso normale non devi creare nulla: è sufficiente l'accesso a Google nella chat. Questa configurazione è riservata alle aziende che desiderano usare la propria **app Google Cloud con il proprio brand**.
{% endhint %}