Collega Smartsupp a Google Gemini e utilizza i dati della tua chat dal vivo semplicemente facendo una domanda. Invece di cliccare nella dashboard, ti basta scrivere cosa vuoi sapere: Gemini trova le informazioni, le riassume oppure esegue subito quello che chiedi.

A differenza di ChatGPT o Claude, Gemini non offre una sezione connector nella sua web app. Per collegarlo, serve Gemini CLI — l’app ufficiale e gratuita di Google che funziona dal terminale. Non ti preoccupare se è la prima volta che usi il terminale: bastano pochi comandi da copiare e incollare, e devi farlo solo una volta.

L’articolo è diviso in queste sezioni:

Prima di iniziare
Configura la connessione
Cosa puoi fare
Cosa sapere
Risolvi i problemi
E adesso?

Prima di iniziare

Ti serviranno:

Node.js 20 o superiore installato sul tuo computer. Per controllare, digita node -v nel terminale, oppure scaricalo da nodejs.org.
Un account Google per generare una chiave API gratuita Gemini. Diversamente da ChatGPT, non serve attivare nessun piano a pagamento.
Le tue credenziali Smartsupp — serviranno durante la configurazione per approvare la connessione.

🟡 Requisito: Il server MCP di Smartsupp è disponibile dal piano Plus in poi.

Configura la connessione

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

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 Crea API key. Copia la chiave: ti servirà al prossimo passaggio.

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

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

4. Aggiungi la connessione Smartsupp. Apri il file ~/.gemini/settings.json con un editor di testo (creane uno nuovo se non esiste) e incolla questi dati:

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

5. Avvia Gemini. Digita gemini nel terminale. Se ti viene chiesto come accedere, scegli Usa Gemini API key.

6. Verifica la connessione. All’interno di Gemini, digita /mcp. Se tutto va bene, dovresti vedere questo:

🟢 smartsupp – Pronto (19 strumenti)

7. Autorizza la connessione. Quando per la prima volta chiedi informazioni sui dati Smartsupp, si apre una pagina di login Smartsupp nel browser. Fai il login per confermare: l’approvazione della connessione avviene con il login, e Gemini non vede mai la tua password Smartsupp.

⚠️ Nota: L’autorizzazione usa in automatico l’account Smartsupp attualmente collegato nel browser. Se gestisci più account Smartsupp, controlla prima di autorizzare di aver fatto accesso a quello corretto.

8. Controlla che tutto funzioni. Prova una richiesta semplice, tipo "Elenca tutti gli agenti sul mio account Smartsupp." Se Gemini risponde con la lista degli agenti, la connessione funziona.

Cosa puoi fare

Quando la connessione è attiva, Gemini può leggere i tuoi dati Smartsupp e gestire la casella di posta seguendo le tue richieste. Scrivi semplicemente ciò di cui hai bisogno, come fosse una normale frase:

"Riepiloga le conversazioni di ieri ed evidenzia quelle che non hanno ancora ricevuto risposta."
"Quali conversazioni sono ancora aperte?"
"Quante nuove conversazioni abbiamo avuto la settimana scorsa rispetto a quella precedente?"

Ecco qualche esempio concreto di come puoi usarlo:

⚠️ Le risposte e le azioni sono effettive. Se invii un messaggio tramite l’agente AI, verrà mostrato al cliente; chiudere, assegnare o etichettare cambia la casella di posta per tutta la squadra. Prima di confermare un’azione, specialmente se riguarda molte conversazioni, leggi bene cosa farà l’agente.

💡 Altri esempi di prompt, informazioni su cosa rimane in Smartsupp e su come vengono gestiti i tuoi dati: Lavora con la casella di posta Smartsupp dal tuo agente AI.

Cosa sapere

Gemini utilizza i tuoi dati Smartsupp reali. L’accesso avviene tramite login (OAuth) e Gemini non visualizza mai la tua password.
Lettura (panoramiche, statistiche, contatti) è sempre disponibile. Le azioni (risposte, etichette, assegnazioni) vengono eseguite solo quando lo chiedi — e prima Gemini ti chiede sempre conferma.
Vuoi passare a un altro account Smartsupp? Chiudi Gemini, elimina la cartella ~/.mcp-auth (con il comando rm -rf ~/.mcp-auth), riapri Gemini e fai accesso con l’account desiderato.

Risolvi i problemi

Errore 401 quando inizi a chattare: Gemini CLI cerca il file .env nella cartella dove lo avvii. Se in quella cartella hai un .env senza GEMINI_API_KEY, la chiave non viene trovata. Aggiungila anche lì, oppure avvia Gemini dalla tua home.
Smartsupp risulta Disconnesso: digita /mcp auth smartsupp dentro Gemini. Se non si risolve, elimina ~/.mcp-auth e riprova.
npm install dà errore di permessi (EACCES): salta l’installazione e avvia Gemini direttamente con npx @google/gemini-cli.

E adesso?

Collega Smartsupp a ChatGPT — guida simile per chi usa ChatGPT.
Collega Smartsupp a Claude — guida simile per chi usa Claude.
Panoramica dashboard — scopri la dashboard Smartsupp e le sue sezioni principali.

💡 Hai bisogno di aiuto? Contatta il nostro team di supporto — siamo sempre felici di darti una mano!