Collegare Gemini CLI al proprio studio

Che cos’è

Gemini CLI è Gemini di Google, eseguito nel terminale del computer. Con il connettore IA, può consultare i dati del tuo studio (vendite, clienti, agenda, finanze) quando fai una domanda, con le autorizzazioni dell’utente associato alla chiave. Può solo consultare i dati: non modifica nulla nel sistema.

Quando usarlo

Usi già Gemini nel terminale e vuoi fare domande sull’andamento dello studio senza aprire il sistema.
Vuoi confrontare i dati del sistema con altre attività che Gemini svolge per te.

Prima di iniziare

Tieni a portata di mano l’indirizzo del connettore, copiato seguendo l’articolo Collegare la tua IA, e una chiave API con l’opzione “Consenti l’uso come connettore IA”. Gemini CLI deve essere installato sul computer. Puoi anche accedere con il tuo account del sistema: senza l’intestazione della chiave, digita /mcp auth heya in Gemini CLI e accedi dalla schermata che si apre.

Passo dopo passo

Passaggio 1 — Aggiungere il connettore

Nel terminale, esegui il comando qui sotto, sostituendo l’indirizzo con quello copiato da Copia indirizzo e hk_... con la tua chiave:

gemini mcp add --transport http --header "Authorization: Bearer hk_..." heya https://seu-dominio/mcp

Per usarlo in tutte le cartelle del computer, aggiungi -s user. Se preferisci modificare il file di configurazione (~/.gemini/settings.json), inserisci questo blocco:

{
  "mcpServers": {
    "heya": {
      "httpUrl": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

Usa httpUrl, non url: in Gemini CLI, url è il vecchio formato di connessione e non funziona con il connettore.

Passaggio 2 — Verificare la connessione

Apri Gemini CLI e digita /mcp. Il connettore heya dovrebbe apparire come CONNECTED, con gli strumenti listar_areas, buscar_ferramentas ed executar_consulta.

Passaggio 3 — Fare una domanda

Per esempio, chiedi: “quali spese scadono questa settimana nello studio?”.

Cosa succede dopo

Gemini individua la query giusta per la domanda, la esegue e risponde con i dati del sistema.
La chiave appare nella scheda API Key e il valore di Ultimo utilizzo viene aggiornato.
Per revocare l’accesso, revoca la chiave nella scheda API Key: Gemini perderà l’accesso entro 30 secondi.

Errori comuni e domande

D: Funziona con Gemini nel browser (gemini.google.com)?
R: Non ancora. Gemini nel browser richiede un accesso dedicato invece della chiave API. Usa Gemini CLI.

D: /mcp mostra DISCONNECTED. Cosa devo fare?
R: Controlla di aver usato httpUrl (e non url), che l’indirizzo termini con /mcp e che la chiave sia stata incollata per intero, con Bearer e uno spazio dopo.

D: Gemini dice che la chiave deve avere l’opzione “Consenti l’uso come connettore IA”. Perché?
R: La chiave è stata creata senza questa opzione. Modifica la chiave nella scheda API Key e seleziona Consenti l’uso come connettore IA.

D: Gemini CLI è diventato Antigravity CLI. Le istruzioni sono ancora valide?
R: Per alcuni account, Google ha sostituito Gemini CLI con Antigravity CLI. Cerca l’opzione per aggiungere un server MCP tramite HTTP con intestazione: l’indirizzo e l’intestazione Authorization: Bearer hk_... sono gli stessi.

D: Posso salvare la chiave in un file del progetto?
R: È meglio di no. Il file .gemini/settings.json nella cartella del progetto viene spesso aggiunto al controllo versione, esponendo la chiave. Preferisci il file del tuo utente (~/.gemini/settings.json).