Integra Gemini Cloud Assist con strumenti di terze parti utilizzando MCP

Questo documento mostra come integrare Gemini Cloud Assist e App Design Center con strumenti di terze parti, tra cui Antigravity, Gemini CLI e Cursor, utilizzando Model Context Protocol (MCP).

MCP ti consente di integrare Gemini Cloud Assist e le funzionalità agentiche di App Design Center direttamente nei tuoi strumenti di terze parti e nei tuoi workflow personalizzati preferiti, in modo da poter accedere alle competenze sulle operazioni cloud esattamente dove lavori già. Per maggiori dettagli su MCP, consulta Configurare MCP per l'applicazione AI.

Strumenti MCP di Gemini Cloud Assist

Gemini Cloud Assist è un agente accessibile tramite un insieme di strumenti MCP che utilizzano il pattern agenti come strumenti. A differenza degli strumenti che recuperano i dati o eseguono l'elaborazione procedurale, gli strumenti Gemini Cloud Assist espongono la funzionalità agentica di tutti i Gemini Cloud Assist o di workflow specifici. L'agente richiamato dalle chiamate dello strumento MCP effettua internamente le proprie chiamate agli strumenti per Google Cloud. I seguenti strumenti MCP vengono pubblicati per essere utilizzati dagli agenti:

  • ask_cloud_assist: questa è l'interfaccia principale per l' Google Cloud assistenza e per l'agente Gemini Cloud Assist. Tutte le funzionalità di Gemini Cloud Assist sono accessibili tramite questo strumento e comprendono le funzionalità degli altri strumenti MCP.
  • design_infra: Supporta i flussi di lavoro per la progettazione e l'architettura dell'infrastruttura su Google Cloud. Funziona con gli strumenti del server MCP di App Design Center per gestire il ciclo di vita della progettazione dell'infrastruttura, ad esempio per eseguire e correggere i risultati di sicurezza o per implementare e risolvere i problemi.
  • investigate_issue: supporta i flussi di lavoro per la risoluzione dei problemi in Google Cloud. Può eseguire una risoluzione rapida dei problemi o una risoluzione più approfondita tramite una risorsa di indagine.
  • invoke_operation: supporta i workflow per la creazione, l'aggiornamento e l'eliminazione di risorse in Google Cloud. Questo strumento è funzionale solo quando le Azioni dell'agente sono abilitate. Le operazioni di scrittura in Gemini Cloud Assist possono essere eseguite solo tramite l'invocazione di questo strumento.
  • optimize_costs: supporta i workflow per l'analisi, il monitoraggio e l'ottimizzazione Google Cloud dei costi. Fornisce suddivisioni dettagliate della spesa e identifica le opportunità di efficienza dei costi individuando le risorse inattive o sottoutilizzate.

Strumenti MCP di App Design Center

Questi strumenti, spesso orchestrati dallo strumento design_infra di Gemini Cloud Assist, gestiscono i cicli di vita delle applicazioni dell'infrastruttura utilizzando App Design Center, inclusi la gestione dei modelli, la conformità e la correzione della sicurezza e il deployment. Gli strumenti sono:

  • setup_adc: inizializza l'ambiente App Design Center. Questo è un passaggio di configurazione una tantum che deve essere eseguito prima di poter utilizzare altri strumenti di App Design Center.
  • manage_application: gestisce il ciclo di vita del deployment di un'applicazione. Utilizza questo strumento per eseguire il deployment di un progetto verificato utilizzando App Design Center o recuperare lo stato e i dettagli di un deployment esistente. Questo è il passaggio finale che trasforma il tuo progetto in un'infrastruttura di cui è stato eseguito il deployment su Google Cloud.
  • manage_application_template: gestisce i contenuti Infrastructure as Code (IaC) della progettazione dell'infrastruttura. Utilizza questa opzione per salvare il progetto come modello di App Design Center, esportarlo come file Terraform o aggiornarlo. Ad esempio, puoi utilizzare questo strumento per aggiornare il design modificando le impostazioni dei componenti e le configurazioni dei parametri.
  • assess_best_practices: esegue un controllo completo della sicurezza e della configurazione della progettazione dell'applicazione prima del deployment. Convalida la progettazione in base ai framework di Security Command Center e ai controlli pertinenti, restituendo un report con risultati azionabili per la correzione.
  • list_application_templates: elenca tutti i design delle applicazioni disponibili.

Questi strumenti MCP non devono essere trattati come API stabili o configurati tramite client API procedurali. Gli strumenti di questo elenco o i relativi parametri potrebbero essere rinominati, ridefiniti, rimossi o aggiunti nel tempo per tenere conto delle funzionalità in evoluzione di Gemini Cloud Assist. Le funzionalità di Gemini Cloud Assist rimarranno stabili in modo che gli agenti client possano eseguire in modo coerente le stesse attività, ma il modo in cui gli agenti interagiscono e richiamano Gemini Cloud Assist tramite questi strumenti cambierà nel tempo.

Prima di iniziare

  1. Concedi l'accesso: per utilizzare MCP, devi disporre di un ruolo Identity and Access Management che contenga l'autorizzazione mcp.googleapis.com/tools.call, ad esempio uno dei seguenti ruoli Gemini Cloud Assist:

    • roles/geminicloudassist.user
    • roles/geminicloudassist.editor
    • roles/geminicloudassist.admin

  2. Se non l'hai ancora fatto, installa gcloud CLI e i relativi componenti beta.

  3. Abilita il servizio MCP nel tuo progetto con il seguente comando:

    gcloud beta services mcp enable geminicloudassist.googleapis.com \
    --project=PROJECT_ID

    Sostituisci PROJECT_ID con l'ID progetto Google Cloud .

  4. Autenticati utilizzando le credenziali predefinite dell'applicazione eseguendo questo comando:

    gcloud auth application-default login

Configura MCP per il tuo cliente

La configurazione dell'agente client dipende dall'agente che utilizzi. Le sezioni seguenti forniscono istruzioni per configurare MCP per diversi client.

Per abilitare il flusso di lavoro completo dalla progettazione all'implementazione, devi configurare il client in modo che si connetta sia ai server MCP di Gemini Cloud Assist sia di App Design Center e includere il file SKILL.md pertinente. I seguenti snippet mostrano la configurazione combinata.

Gemini CLI

Configurare l'utilizzo di un'estensione

Installa il server MCP come estensione di Gemini CLI utilizzando il seguente comando:

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

Configura manualmente

  1. Configura le impostazioni del server MCP.

    Apri il file delle impostazioni dell'ambito utente di Gemini CLI all'indirizzo ~/.gemini/settings.json o le impostazioni dell'ambito workspace all'indirizzo .gemini/settings.json. Se il file non esiste, crealo. Aggiungi o unisci il seguente blocco di configurazione alla chiave mcpServers. Assicurati che il file utilizzi un formato JSON valido. Questa configurazione utilizza automaticamente le Credenziali predefinite dell'applicazione. 

    {
  "mcpServers": {
    "gemini_cloud_assist": {
      "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      },
      "timeout": 600000
    },
    "application_design_center": {
      "httpUrl": "https://designcenter.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      },
      "timeout": 600000
    }
  }
}

  2. Crea e compila i file di skill.

    Crea un file SKILL.md in una delle seguenti directory. Copia e incolla i contenuti in formato Markdown per la skill che hai scelto dalla sezione Riferimento alle skill di questo documento nel file.

    • Ambito del workspace: .gemini/skills/<skill-name>/
    • Ambito utente: ~/.gemini/skills/<skill-name>/

    Di seguito è riportata una struttura di directory di esempio:

    .gemini/
└── skills/
    ├── design-and-deploy/
    │   └── SKILL.md
    └── google-gemini-cloud-assist/
        └── SKILL.md

  3. Verifica le tue competenze.

    Una volta modificati i file settings.json e SKILL.md, riavvia Gemini CLI. Utilizza i seguenti comandi per la verifica:

    • /skills list: per verificare che le tue skill locali siano state rilevate correttamente.
    • /mcp list: per verificare che i server MCP di Gemini Cloud Assist e App Design Center siano connessi.

Antigravity

  1. Installa l'estensione.

    In Antigravity, apri il marketplace Estensioni. Cerca l'estensione Gemini Cloud Assist, fai clic su Installa, quindi su Aggiorna.

  2. Configura manualmente i server MCP.

    Apri il riquadro Gestisci server MCP e fai clic su Visualizza configurazione non elaborata per modificare il file mcp_config.json. Aggiungi o unisci il seguente blocco di configurazione. Questa configurazione utilizza le Credenziali predefinite dell'applicazione per l'autenticazione.

    {
  "mcpServers": {
    "gemini_cloud_assist": {
      "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
      "headers": {},
      "authProviderType": "google_credentials"
    },
    "application_design_center": {
      "serverUrl": "https://designcenter.googleapis.com/mcp",
      "headers": {},
      "authProviderType": "google_credentials"
    }
  }
}

  3. Verifica la configurazione.

    Dopo aver modificato i file mcp_config.json e SKILL.md, riavvia Antigravity. Nel riquadro dell'agente, utilizza i seguenti comandi slash per verificare la connessione:

    • /skills list: verifica che le tue skill locali siano state rilevate.
    • /mcp list: verifica che i server MCP di Gemini Cloud Assist e App Design Center siano connessi.

Cursore

  1. Nel tuo progetto Google Cloud , crea un ID client OAuth 2.0 per un'app desktop.

  2. Configura URI://anysphere.cursor-mcp/oauth/callback come URL di reindirizzamento. Per saperne di più, consulta la documentazione sui cursori.

  3. Aggiungi o unisci il seguente blocco di configurazione:

       {
     "mcpServers": {
       "gemini_cloud_assist": {
         "url": "https://geminicloudassist.googleapis.com/mcp",
         "auth": {
           "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
           "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
           "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
         }
       }
     }
   }

Competenze di Gemini Cloud Assist

Gli strumenti MCP Gemini Cloud Assist e App Design Center utilizzano le competenze dell'agente per istruirlo. La skill guida l'agente a svolgere le seguenti attività:

  • Concatenare più strumenti in un flusso di lavoro.
  • Elabora le informazioni locali pertinenti, ad esempio il codice di deployment di Terraform, per dedurre il contesto locale.
  • Rispondi alle invocazioni esplicite quando fai riferimento direttamente alla skill.

Quando utilizzi agenti interattivi come Antigravity o Gemini CLI, puoi integrare gli strumenti MCP di Gemini Cloud Assist con altri agenti e flussi di lavoro. Poiché questi strumenti offrono funzionalità ampie che potrebbero sovrapporsi a quelle dei tuoi strumenti specializzati esistenti, utilizza le seguenti strategie per ottimizzare per il tuo ambiente e caso d'uso specifici:

  1. Personalizza la definizione dell'abilità: aggiorna il file SKILL.md per specificare gli intent e i casi d'uso per cui vuoi richiamare Gemini Cloud Assist. In questo modo, l'agente viene attivato solo per le attività in cui sono richieste le sue ampie competenze sul cloud.
  2. Richiamare le skill in modo esplicito: molti agenti interattivi ti consentono di controllare quando viene attivata una skill. Se l'agente lo supporta, puoi configurare la skill in modo che richieda l'invocazione manuale utilizzando i comandi slash (/) o le @menzioni (@). Questo approccio ti consente di scegliere con precisione quando utilizzare Gemini Cloud Assist anziché un altro strumento specializzato.

Riferimento alle competenze di Gemini Cloud Assist

Ti consigliamo il seguente file SKILL.md su tutti gli agenti configurati con gli strumenti MCP di Gemini Cloud Assist. Questo file guida l'agente su come utilizzare gli strumenti in modo appropriato.

Passaggi successivi