Collegare Gemini

I passaggi da seguire dipendono da come usi Gemini: l'app consumer (Spark), Gemini Enterprise tramite la tua organizzazione, oppure la CLI Antigravity. Scegli quella che ti riguarda qui sotto.

App Gemini (Spark)

1. Vai su gemini.google.com → Impostazioni e assistenza → App collegate → App personalizzate per Spark → Aggiungi un'app personalizzata.
2. Incolla https://mailinapp.com/api/mcp come URL del server.
3. Approva la schermata di consenso di MailInApp quando Gemini la apre — accedi se necessario, scegli per conto di quale account collegarti se appartieni a più di uno, seleziona i tuoi scope (vedi Scope e permessi), e approva.

Tutto qui — nulla da inviare o far revisionare, esattamente come collegare Claude o ChatGPT. Se non vedi App personalizzate per Spark come opzione, si tratta di un requisito di idoneità di Google e non di qualcosa dal lato MailInApp: Google al momento limita le app personalizzate per Spark ad account Google personali, con sede negli USA, maggiorenni, con "Mantieni attività" attivato e l'app Gemini impostata su Inglese. Al di fuori di questi vincoli l'opzione non compare affatto.

Gemini Enterprise (tramite la tua organizzazione)

Se la tua azienda usa Gemini Enterprise, non puoi aggiungere MailInApp da solo come faresti nell'app consumer — è disattivato per impostazione predefinita dietro una policy organizzativa, e attivarlo è una configurazione una tantum che fa il tuo amministratore Workspace, non tu. Invia al tuo amministratore questi dettagli:

• URL di autorizzazione: https://mailinapp.com/oauth/authorize
• URL del token: https://mailinapp.com/oauth/token
• Scope: qualsiasi combinazione da Scope e permessi, separati da spazio.
• PKCE: attivo (S256).
• Client id / secret: scrivi a [email protected] con l'URI di reindirizzamento usato dal tuo tenant Gemini Enterprise, e ne emetteremo uno che il tuo amministratore potrà inserire.

Una volta che il tuo amministratore ha completato questa configurazione, collegarsi e usare MailInApp tramite Gemini Enterprise funziona come con qualsiasi altro assistente — accedi, scegli il tuo account, seleziona gli scope, approva.

CLI Antigravity

Se usi la CLI Antigravity (la successora di Gemini CLI) invece dell'app Gemini, aggiungi MailInApp al suo file di configurazione invece che a una schermata delle impostazioni. Aggiungi una voce a mcp_config.json (o .agents/mcp_config.json):

{
  "mcpServers": {
    "mailinapp": {
      "url": "https://mailinapp.com/api/mcp"
    }
  }
}

La CLI Antigravity apre la stessa schermata di consenso OAuth di ogni altro client alla prima connessione.

Se una connessione smette di funzionare

• Nessuna opzione "Aggiungi un'app personalizzata" sotto App collegate — questo è un requisito di idoneità di Google stesso, non di MailInApp: la funzione delle app personalizzate di Spark richiede un account Google personale con sede negli USA, maggiorenne, con "Mantieni attività" attivato, e l'app Gemini impostata su Inglese. L'opzione non compare affatto al di fuori di questi vincoli, indipendentemente da qualsiasi cosa dal lato MailInApp.
• Connessione Enterprise rifiutata dalla configurazione del tuo amministratore — il client id/secret emesso da MailInApp è vincolato all'esatto URI di reindirizzamento fornito dal tuo tenant in fase di configurazione. Se quell'URI cambia, fai scrivere al tuo amministratore a [email protected] con il nuovo URI invece di riutilizzare il vecchio client.
• La CLI Antigravity segnala un errore di connessione — verifica che mcp_config.json sia JSON valido e che il campo url riporti esattamente https://mailinapp.com/api/mcp; un oggetto mcpServers malformato è la causa più comune.
• Hai cambiato team, oppure un collega ha revocato il tuo accesso — come ogni altra piattaforma, un token del connettore Gemini viene rivalidato rispetto alla tua appartenenza attuale all'account a ogni chiamata, quindi perdere l'accesso a un'azienda disabilita immediatamente le chiamate di quella connessione, senza che tu debba fare nulla dal lato di Gemini.

Revoca

Indipendentemente dalla superficie Gemini tramite cui ti sei collegato, Connessioni nella dashboard di MailInApp (/dashboard/connections) la elenca insieme a ogni altro assistente con un pulsante Revoca a un clic — il token smette di funzionare alla sua prossima chiamata.