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 il Model Context Protocol (MCP).

MCP ti consente di integrare le funzionalità agentiche di Gemini Cloud Assist e App Design Center direttamente nei tuoi strumenti di terze parti e nei flussi di lavoro personalizzati preferiti, in modo da poter accedere alle competenze operative del cloud esattamente dove lavori già. Per maggiori dettagli su MCP, consulta Configurare MCP per la tua 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 di Gemini Cloud Assist espongono la funzionalità agentica di tutto Gemini Cloud Assist o di workflow specifici. L'agente richiamato dalle chiamate dello strumento MCP effettua internamente le proprie chiamate allo strumento a Google Cloud. I seguenti strumenti MCP vengono pubblicati per essere utilizzati dagli agenti:

  • ask_cloud_assist: questa è l'interfaccia principale per Google Cloud l'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 eseguire e correggere i risultati di sicurezza o eseguire il deployment 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 Investigation.
  • invoke_operation: supporta i flussi di lavoro per la creazione, l'aggiornamento e l'eliminazione delle 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 la chiamata di questo strumento.
  • optimize_costs: supporta i flussi di lavoro per l'analisi, il monitoraggio e l'ottimizzazione dei costi Google Cloud . Fornisce suddivisioni dettagliate della spesa e identifica le opportunità di efficienza dei costi trovando 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, inclusa 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 una progettazione verificata utilizzando App Design Center o per recuperare lo stato e i dettagli di un deployment esistente. Questo è il passaggio finale che trasforma la tua progettazione 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 questo strumento per salvare la progettazione come modello di App Design Center, esportarla come file Terraform o aggiornarla. Ad esempio, puoi utilizzare questo strumento per aggiornare la progettazione 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 rispetto ai framework di Security Command Center e ai controlli pertinenti, restituendo un report con risultati utilizzabili per la correzione.
  • list_application_templates: elenca tutte le progettazioni di 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 costantemente 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 di 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' Google Cloud ID progetto.

  4. Esegui l'autenticazione utilizzando le Credenziali predefinite dell'applicazione eseguendo il seguente comando:

    gcloud auth application-default login

Configurare MCP per il client

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

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

Gemini CLI

Configurare utilizzando 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

Configurazione manuale

  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 dell'area di lavoro all'indirizzo .gemini/settings.json. Se il file non esiste, crealo. Aggiungi o unisci il seguente blocco di configurazione sotto la mcpServers chiave. Assicurati che il file utilizzi un formato JSON formato 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 delle competenze.

    Crea un file SKILL.md in una delle seguenti directory. Copia e incolla il contenuto Markdown della competenza scelta dalla sezione di riferimento delle competenze di questo documento nel file.

    • Ambito dell'area di lavoro: .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.

    Dopo aver modificato i file settings.json e SKILL.md, riavvia Gemini CLI. Utilizza i seguenti comandi per verificare:

    • /skills list: per verificare che le competenze 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 Installa e poi su Aggiorna.

  2. Configura manualmente i server MCP.

    Apri il riquadro Gestisci server MCP e fai clic Visualizza configurazione non elaborata per modificare il mcp_config.json file. 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 Agente, utilizza i seguenti comandi con barra per verificare la connessione:

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

Cursor

  1. Nel tuo Google Cloud progetto, 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 di Cursor.

  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 di Gemini Cloud Assist e App Design Center utilizzano le competenze dell'agente per istruire l'agente. La competenza guida l'agente nell'esecuzione delle seguenti attività:

  • Concatenamento di più strumenti in un flusso di lavoro.
  • Elaborazione di informazioni locali pertinenti, ad esempio il codice di deployment di Terraform, per ragionare sul contesto locale.
  • Risposta alle chiamate esplicite quando fai riferimento direttamente alla competenza.

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 forniscono funzionalità ampie che potrebbero sovrapporsi agli strumenti specializzati esistenti, utilizza le seguenti strategie per ottimizzare l'ambiente e il caso d'uso specifici:

  1. Personalizza la definizione della competenza: aggiorna il file SKILL.md per specificare gli intenti e i casi d'uso per i quali vuoi richiamare Gemini Cloud Assist. In questo modo, l'agente viene attivato solo per le attività in cui è richiesta la sua ampia competenza nel cloud.
  2. Richiama le competenze in modo esplicito: molti agenti interattivi ti consentono di controllare quando viene attivata una competenza. Se l'agente lo supporta, puoi configurare la competenza in modo che richieda la chiamata manuale utilizzando comandi con barra (/) o menzioni con @ (@). Questo approccio ti consente di scegliere con precisione quando utilizzare Gemini Cloud Assist rispetto a un altro strumento specializzato.

Riferimento alle competenze di Gemini Cloud Assist

Ti consigliamo di utilizzare 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