Collega Smartsupp a Google Gemini e lavora con i dati della tua chat dal vivo semplicemente chiedendo. Invece di navigare nella dashboard, scrivi una semplice frase — Gemini trova le informazioni, le riassume o esegue l'azione per te.

Gemini non ha una sezione per i connettori nella sua app web (a differenza di ChatGPT o Claude), quindi il collegamento avviene tramite Gemini CLI — un'app ufficiale gratuita di Google che viene eseguita nel terminale. Non preoccuparti se non hai mai usato un terminale: la configurazione richiede pochi comandi da copiare e incollare e va eseguita una sola volta.

Abbiamo suddiviso l'articolo in alcune sezioni:

Prima di iniziare
Configura il collegamento
Cosa puoi fare
Da sapere
Risoluzione dei problemi
Qual è il prossimo passo?

Prima di iniziare

Ti serviranno:

Node.js 20 o versioni successive Installato sul tuo 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 ti serve alcun piano a pagamento.
Le tue credenziali di accesso a Smartsupp — durante la configurazione accederai al tuo account Smartsupp per approvare il collegamento.

🟡 Requisito: Il server MCP di Smartsupp è disponibile con il piano Plus E quelli superiori.

Configura 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 Crea chiave API. 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 che hai copiato):

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

4. Aggiungi il collegamento a 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 Usa la chiave API Gemini.

6. Controlla il collegamento. All'interno di Gemini, digita /mcp. Dovresti vedere:

🟢 smartsupp – Ready (19 tools)

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

⚠️ Nota: L'autorizzazione utilizza automaticamente l'account Smartsupp a cui hai attualmente effettuato l'accesso nel browser. Se gestisci più di un account Smartsupp, controlla di aver effettuato l'accesso a quello giusto prima di autorizzare.

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

Cosa puoi fare

Una volta collegato, Gemini può leggere i tuoi dati Smartsupp e gestire la tua Inbox seguendo le tue istruzioni. Ti basta scrivere ciò che ti serve con una frase normale:

"Riassumi le conversazioni di ieri ed evidenzia quelle che richiedono ancora una risposta."
"Quali conversazioni sono ancora aperte?"
"Quante nuove conversazioni abbiamo avuto la scorsa settimana rispetto alla settimana precedente?"

Usi tipici (con prompt di esempio):

⚠️ Le risposte e le azioni sono reali. Un messaggio che invii tramite il tuo assistente AI arriva nella chat del cliente, e chiudere, assegnare o etichettare le conversazioni modifica l'Inbox per tutta la tua squadra. Leggi ciò che il tuo assistente sta per fare prima che proceda, soprattutto quando interviene su molte conversazioni contemporaneamente.

💡 Altri prompt di esempio, cosa rimane in Smartsupp e come vengono gestiti i tuoi dati: Lavora con la tua Inbox Smartsupp dal tuo assistente AI.

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, etichette, assegnazioni) vengono eseguite solo quando le richiedi — e Gemini ti chiede conferma prima di eseguirle.
Passare a un altro account Smartsupp: Chiudi Gemini, elimina la cartella ~/.mcp-auth (esegui rm -rf ~/.mcp-auth), avvia nuovamente Gemini e accedi con l'altro account.

Risoluzione dei problemi

Errore 401 quando inizi a chattare: Gemini CLI legge il file .env Dalla cartella in cui lo esegui. Se quella cartella ha un proprio .env Senza GEMINI_API_KEY, la chiave non viene rilevata. Aggiungi la chiave anche a quel file oppure avvia Gemini dalla tua cartella home.
Smartsupp mostra Disconnesso: Digita /mcp auth smartsupp All'interno di Gemini. Se non risolve il problema, elimina ~/.mcp-auth E riprova.
npm install Non riesce a causa di un errore di autorizzazione (EACCES): Salta l'installazione ed esegui Gemini direttamente con npx @google/gemini-cli.

Qual è il prossimo passo?

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

💡 Hai bisogno di altro aiuto? Contatta la nostra Squadra di supporto — saremo felici di aiutarti!