Collegare Gemini a digna¶

Questa guida collega gli strumenti Gemini di Google al digna MCP Server. Ti servono l'endpoint MCP della tua installazione di digna e una chiave API, come descritto nella Panoramica degli agenti IA.

Gli esempi usano https://digna.example.com/mcp come endpoint. Sostituiscilo con il tuo.

Scegliere lo strumento¶

Tutti questi strumenti si collegano dalla macchina su cui girano, quindi funzionano con digna all'interno della rete aziendale, purché quella macchina raggiunga l'endpoint.

Antigravity¶

Antigravity legge i suoi server MCP da mcp_config.json, condiviso da CLI, IDE e app.

1. Aprire mcp_config.json¶

Per aprire il file in uso:

• CLI: digita /mcp e premi Enter per aprire il gestore MCP.
• IDE: nel pannello laterale dell'agente, apri il menu …, seleziona MCP Servers, poi Manage MCP Servers, poi View raw config.
• App: vai su Customizations > Installed > MCP Servers e usa Copy Config File Path.

2. Aggiungere il server digna¶

Aggiungi la voce digna. Se il file ha già una sezione mcpServers, aggiungila lì:

{
  "mcpServers": {
    "digna": {
      "serverUrl": "https://digna.example.com/mcp",
      "headers": {
        "Authorization": "Bearer <api key>"
      }
    }
  }
}

Antigravity raggiunge i server remoti solo tramite HTTP streamable, che è quello usato dal digna MCP Server. Indica l'endpoint come serverUrl; la chiave httpUrl di Gemini CLI non è supportata.

3. Verificare la connessione¶

Nella CLI, digita /mcp: il gestore MCP mostra il server digna con il suo stato e i suoi strumenti, e può ricaricare la configurazione e mostrare i log di connessione. Nell'IDE, il server compare in Manage MCP Servers.

Gemini CLI¶

1. Aggiungere il server¶

Metti la chiave API in una variabile d'ambiente, poi aggiungi il server:

export DIGNA_API_KEY='<api key>'
gemini mcp add --transport http --scope user --header "Authorization: Bearer $DIGNA_API_KEY" digna https://digna.example.com/mcp

La tua shell sostituisce $DIGNA_API_KEY con il suo valore quando esegui il comando, quindi Gemini CLI salva la chiave nelle sue impostazioni. Senza --scope user, il server viene aggiunto solo al progetto corrente.

2. Oppure modificare settings.json¶

Il comando qui sopra scrive in settings.json. Per modificare il file tu stesso:

{
  "mcpServers": {
    "digna": {
      "httpUrl": "https://digna.example.com/mcp",
      "headers": {
        "Authorization": "Bearer <api key>"
      }
    }
  }
}

Usa httpUrl, la chiave per l'HTTP streamable. La chiave simile url seleziona il trasporto SSE più vecchio, che il digna MCP Server non offre. Non usare trattini bassi nel nome del server.

3. Verificare la connessione¶

Dalla tua shell:

gemini mcp list

Il server digna deve risultare connesso. All'interno di una sessione di Gemini CLI, esegui /mcp per vedere il server e i suoi strumenti.

Risoluzione dei problemi di Gemini¶

Il server risulta disconnesso¶

• Verifica che l'endpoint termini con /mcp e sia raggiungibile dalla tua macchina.
• Verifica il nome della chiave: serverUrl in Antigravity, httpUrl in Gemini CLI.
• Un 401 significa che la chiave è stata rifiutata; vedi 401 Unauthorized.

Gemini CLI non si avvia più con il mio account¶

Da giugno 2026, gli account Google personali usano Antigravity CLI al posto di Gemini CLI. Sposta la voce digna in mcp_config.json come descritto in Antigravity, e rinomina httpUrl in serverUrl.

Vedi anche¶

• Panoramica degli agenti IA: endpoint, chiave API, sicurezza e risoluzione dei problemi generale
• Claude: collegare Claude Code, Claude Desktop o un connettore personalizzato
• digna Agentic: cosa possono fare gli agenti IA con digna