Collega Smartsupp a Google Gemini e lavora con i dati della tua live chat semplicemente chiedendo. Invece di cliccare nella dashboard, scrivi una frase normale — Gemini trova l'informazione, la riassume o esegue direttamente l'azione per te.

Gemini non ha una sezione connettori nella sua app web (a differenza di ChatGPT o Claude), quindi il collegamento passa per Gemini CLI — un'app ufficiale gratuita di Google che funziona nel terminale. Non preoccuparti se non hai mai usato un terminale: la configurazione è composta da pochi comandi copia-incolla e si fa una sola volta.

Abbiamo suddiviso l'articolo in alcune sezioni:

Prima di iniziare
Configurare il collegamento
Cosa puoi fare
Da sapere
Quando qualcosa non funziona
E adesso?

Prima di iniziare

Ti serviranno:

Node.js 20 o più recente installato sul computer. Verifica eseguendo node -v nel terminale, oppure scaricalo da nodejs.org.
Un account Google per creare una chiave API Gemini gratuita. A differenza di ChatGPT, non serve alcun piano a pagamento.
Le credenziali di accesso a Smartsupp — durante la configurazione accederai al tuo account Smartsupp per approvare il collegamento.

Configurare il collegamento

1. Installa Gemini CLI. Apri il terminale (su Mac: app Terminale, su Windows: PowerShell) ed esegui:

npm install -g @google/gemini-cli

2. Crea la tua chiave API Gemini. Vai su Google AI Studio, accedi con il tuo account Google e clicca su Create API key. Copia la chiave — ti servirà nel passaggio successivo.

3. Salva la chiave API. Esegui questo comando nel terminale (sostituisci your-key-here con la chiave copiata):

mkdir -p ~/.gemini && echo 'GEMINI_API_KEY=your-key-here' >> ~/.gemini/.env

4. Aggiungi il collegamento Smartsupp. Apri il file ~/.gemini/settings.json in un editor di testo qualsiasi (crealo se non esiste) e incolla:

{
  "mcpServers": {
    "smartsupp": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.smartsupp.com/mcp"],
      "timeout": 30000
    }
  },
  "security": {
    "auth": { "selectedType": "gemini-api-key" }
  }
}

5. Avvia Gemini. Esegui gemini nel terminale. Se ti chiede come vuoi accedere, scegli Use Gemini API Key.

6. Controlla il collegamento. Dentro Gemini digita /mcp. Dovresti vedere:

🟢 smartsupp – Ready (19 tools)

7. Autorizza il collegamento. La prima volta che chiedi dei tuoi dati Smartsupp, nel browser si apre una pagina di accesso Smartsupp. Accedi per approvare l'accesso — Gemini non vede mai la tua password Smartsupp.

⚠️ Nota: L'autorizzazione usa automaticamente l'account Smartsupp con cui sei attualmente connesso nel browser. Se gestisci più account Smartsupp, prima di autorizzare verifica di essere connesso a quello giusto.

8. Verifica che funzioni. Prova una richiesta semplice, ad esempio "Elenca tutti gli agenti del mio account Smartsupp." Se Gemini risponde con l'elenco dei tuoi agenti, il collegamento funziona.

Cosa puoi fare

Una volta collegato, Gemini può leggere i tuoi dati Smartsupp e gestire la posta in arrivo su tua richiesta. Scrivi semplicemente ciò che ti serve come una frase normale:

Panoramica delle conversazioni

"Mostrami le conversazioni dell'ultima settimana."
"Riassumi questa conversazione in tre frasi."
"Quali conversazioni sono ancora aperte?"

Statistiche

"Quante nuove conversazioni abbiamo avuto la settimana scorsa?"
"Suddividi le nuove conversazioni giorno per giorno."

Contatti

"Find the contact with the email jan@example.com."
"Quali tag ha questo cliente?"

Gestione delle conversazioni

"Assegna questa conversazione all'agente Marie."
"Chiudi questa conversazione."

Risposte nella chat

"Invia in questa conversazione: Grazie per la pazienza, ci stiamo lavorando."

💡 Idee da provare: Un riepilogo mattutino ("Riassumi le conversazioni di ieri ed evidenzia quelle che richiedono una risposta") o un report veloce ("Confronta il numero di nuove conversazioni di questa settimana e della scorsa").

Da sapere

Gemini lavora con i tuoi dati Smartsupp reali. Approvi l'accesso effettuando il login (OAuth) — Gemini non vede mai la tua password.
La lettura (panoramiche, statistiche, contatti) è completamente disponibile. Le azioni (risposte, tag, assegnazioni) vengono eseguite solo quando le richiedi — e Gemini ti chiede conferma prima di eseguirle.
Cambiare account Smartsupp: chiudi Gemini, elimina la cartella ~/.mcp-auth (esegui rm -rf ~/.mcp-auth), riavvia Gemini e accedi con l'altro account.

Quando qualcosa non funziona

Errore 401 quando inizi a chattare: Gemini CLI legge il file .env dalla cartella da cui lo avvii. Se quella cartella ha un proprio .env senza GEMINI_API_KEY, la chiave non viene caricata. Aggiungi la chiave anche a quel file, oppure avvia Gemini dalla tua cartella home.
smartsupp risulta Disconnected: digita /mcp auth smartsupp dentro Gemini. Se non basta, elimina ~/.mcp-auth e riprova.
npm install fallisce con un errore di permessi (EACCES): salta l'installazione ed esegui Gemini direttamente con npx @google/gemini-cli.

E adesso?

Collegare Smartsupp a ChatGPT — lo stesso connettore per gli utenti di ChatGPT.
Collegare Smartsupp a Claude — lo stesso connettore per gli utenti di Claude.
Panoramica della dashboard — scopri la dashboard di Smartsupp e le sue sezioni principali.

💡 Serve altro aiuto? Contact our team di supporto — saremo felici di aiutarti!

Collegare Smartsupp a Google Gemini