Guida · Circa 3 minuti

Come collegare Onplana a Gemini CLI e Code Assist

Installazione in una riga. Onplana include un manifesto di estensione di Gemini nella radice del repository, quindi tutta la configurazione è:gemini extensions install <repo>.

Dopo potrai chiedere a Gemini cose come «riassumi le mie attività in ritardo su Onplana», «crea un piano di progetto per il lancio del Q3 con 5 milestone settimanali» o «elenca i membri del mio team nel progetto della piattaforma dati», e Gemini lo esegue direttamente in Onplana.

Apri Onplana → Impostazioni → Agenti Gemini CLI su GitHub

In breve: tre comandi

# 1. Set your Onplana token
export ONPLANA_PAT=pat_paste-your-token-here

# 2. Install the extension
gemini extensions install https://github.com/Onplana/onplana-mcp-server

# 3. Restart and verify
gemini
> list my Onplana projects via the onplana tool

I passaggi dettagliati, più sotto.

I cinque passaggi in dettaglio

  1. 1

    Installa Gemini CLI (se non ce l'hai già)

    Su macOS / Linux: npm install -g @google/gemini-cli. Su Windows: lo stesso comando in una console con Node. Verifica con `gemini --version`. Se usi Gemini Code Assist in VS Code o JetBrains, hai già quello che serve: Code Assist condivide il file di configurazione con la CLI.

  2. 2

    Genera un token di connessione di Onplana

    Accedi a Onplana su app.onplana.com. Vai su Impostazioni → Agenti → Connetti agente, scegli il riquadro Gemini CLI + Code Assist, poi Token di accesso personale e infine Genera token e mostra lo snippet di connessione. Copia il token di accesso personale (inizia con `pat_`). Impostalo come variabile d'ambiente: export ONPLANA_PAT=pat_your-token-here (aggiungi la riga a ~/.bashrc o ~/.zshrc perché resti).

  3. 3

    Installa l'estensione di Gemini di Onplana (un comando)

    Esegui: gemini extensions install https://github.com/Onplana/onplana-mcp-server. Il repository di Onplana include nella radice un manifesto gemini-extension.json, che Gemini CLI legge per configurare automaticamente la connessione con il server MCP. In alternativa, modifica ~/.gemini/settings.json a mano; il formato è documentato su developers.google.com/gemini-code-assist/docs.

  4. 4

    Riavvia Gemini CLI o ricarica l'editor

    Per Gemini CLI: esci e riapri `gemini`. Per Gemini Code Assist in VS Code: Cmd/Ctrl+Maiusc+P → "Developer: Reload Window". Per JetBrains: riavvia l'IDE. Gli strumenti di Onplana compaiono nel selettore /mcp dopo il riavvio.

  5. 5

    Verifica la connessione

    In una nuova sessione di Gemini, chiedi: «list my Onplana projects via the onplana tool». Gemini chiama lo strumento list_projects di Onplana e ti mostra il risultato. Se ricevi un errore, controlla che ONPLANA_PAT sia impostato nell'ambiente usato da Gemini e che il manifesto dell'estensione sia stato installato correttamente, con `gemini extensions list`.

Oppure configuralo a mano

Se preferisci non installare l'estensione, modifica~/.gemini/settings.json(o .gemini/settings.json nella radice dell'area di lavoro) direttamente:

{
  "mcpServers": {
    "onplana": {
      "httpUrl": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      },
      "timeout": 5000
    }
  }
}

Nota che la chiave è httpUrl, non url. Gemini CLI usa httpUrl per i server Streamable HTTP come Onplana e riserva url ai server SSE. Il token bearer in headers.Authorization autentica ogni richiesta.

Come verificare che funzioni

Apri una nuova sessione di Gemini e prova una di queste:

  • «Con lo strumento onplana, elenca i miei progetti.»
  • «Mostrami le attività in ritardo di Onplana assegnate a me.»
  • «Crea un'attività Onplana nel progetto X chiamata ‘Migrare Postgres su Aurora’.»
  • «Cerca nelle mie pagine di Onplana le note sulla migrazione dell'API.»

Esegui gemini extensions list per confermare che l'estensione di Onplana è installata. Dopo un'installazione riuscita, il selettore /mcp dovrebbe mostrare l'elenco completo degli strumenti di Onplana.

Domande frequenti

Funziona con Gemini Code Assist in VS Code?

Sì. Gemini CLI e Gemini Code Assist condividono lo stesso file di configurazione (~/.gemini/settings.json per tutto l'utente o .gemini/settings.json in un'area di lavoro). Un'installazione con `gemini extensions install` copre entrambi. Poi ricarica la finestra di VS Code (Cmd/Ctrl+Maiusc+P → "Developer: Reload Window") perché Code Assist prenda la nuova configurazione.

E l'app di Gemini su gemini.google.com?

gemini.google.com a maggio 2026 non supporta ancora i server MCP personalizzati. Google indirizza chi vuole collegarsi a server MCP di terze parti verso Gemini CLI o Gemini Code Assist. Lo seguiamo; se l'app aggiunge il supporto MCP, l'installazione sarà con un clic tramite un'interfaccia di connettori simile a quella di Claude.ai.

E Gemini Enterprise / Vertex AI Agent Builder?

Gemini Enterprise è una configurazione diversa da Gemini CLI: un amministratore aggiunge Onplana nella console di Google Cloud come archivio dati Custom MCP Server, con un ID client OAuth e un secret. È in accesso anticipato e lo gestisce l'amministratore, non è self-service: Onplana emette il client per la tua organizzazione su richiesta. La guida su docs.onplana.com/ai-agents/connect-onplana-to-gemini-enterprise/ contiene la configurazione, le 20 azioni da attivare per prime e il link per chiedere l'accesso.

Quale piano di Onplana include MCP?

MCP è disponibile in tutti i piani, incluso quello gratuito. Il numero di connessioni simultanee di agenti cresce con il piano (Free 2, Professional 3, Business 5, Enterprise 10, Enterprise+ illimitate), e il tuo saldo di token IA (un'assegnazione mensile nei piani a pagamento, un bonus una tantum in Free, più il credito che acquisti) è ciò che limita l'uso reale dell'IA. Puoi cambiare piano quando vuoi su app.onplana.com/billing.

Che differenza c'è tra installare con gemini-extension.json e modificare direttamente settings.json?

A livello funzionale sono equivalenti. L'installazione dell'estensione è un comando e usa un manifesto nella radice del repository, quindi è riproducibile. Modificare settings.json a mano serve quando vuoi mettere Onplana accanto a più server MCP (per esempio uno per Onplana, uno per Linear e uno per un'API interna) nello stesso oggetto `mcpServers`. Funzionano entrambi e condividono la stessa configurazione.

Perché la chiave si chiama httpUrl e non url?

Gemini CLI distingue tra server MCP via stdio (chiave: command), via SSE (chiave: url) e via Streamable HTTP (chiave: httpUrl). Il server MCP di Onplana usa Streamable HTTP, lo standard di trasporto più recente, che gestisce richiesta e risposta su HTTPS semplice senza SSE. La chiave `url` nelle configurazioni di Claude Desktop, Cursor e ChatGPT è l'equivalente.

Posso revocare la connessione?

Sì, in due modi: (1) Onplana → Impostazioni → Agenti → Connessioni → Revoca sulla riga del token. (2) Rimuovi ONPLANA_PAT dal tuo ambiente E esegui `gemini extensions uninstall onplana`. Entrambi hanno effetto immediato; la chiamata successiva di Gemini a uno strumento restituisce 401.

A quali strumenti ha accesso Gemini?

351 strumenti, gli stessi che ricevono Claude Desktop, Cursor e ChatGPT: lettura (list_projects, list_my_tasks, get_task, search_org_knowledge, ecc.) e scrittura (create_task, update_task, assign_task, create_milestone, ecc.), oltre alle aree di governance, controllo delle modifiche, conformità, documenti e flussi di lavoro. Il catalogo è lo stesso qualunque sia il client collegato. Il piano abilita alcuni strumenti; il catalogo completo è su onplana.com/mcp.

Correlati