Integra Gemini Cloud Assist con strumenti di terze parti utilizzando MCP

Model Context Protocol (MCP) ti consente di integrare le capacità agentiche di Gemini Cloud Assist e dell'App Design Center direttamente in strumenti di terze parti come Antigravity, Gemini CLI e Cursor. Questa integrazione porta competenze di operazioni cloud e assistenza per l'architettura nei tuoi workflow di sviluppo esistenti. Per saperne di più, 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à di agente di tutti i Gemini Cloud Assist o di flussi di lavoro specifici. L'agente richiamato dalle chiamate allo strumento MCP effettua internamente le proprie chiamate allo strumento 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 attive. 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 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, inclusi la gestione dei modelli, la conformità e la correzione della sicurezza e l'implementazione. Gli strumenti sono:

  • setup_adc: inizializza l'ambiente App Design Center. Si tratta di 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 continua 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 client-agente dipende dall'agente che utilizzi. Le sezioni seguenti forniscono istruzioni per configurare MCP per diversi client.

Per attivare 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 che a quelli di App Design Center e includere il file SKILL.md pertinente. I seguenti snippet mostrano la configurazione combinata.

Antigravity

Per aggiungere i server MCP remoti di Gemini Cloud Assist e App Design Center ad Antigravity, segui le istruzioni riportate in Editor Antigravity: integrazione MCP o completa i seguenti passaggi:

  1. Installa l'estensione.

    In Antigravity, apri il marketplace Estensioni. Cerca l'estensione Gemini Cloud Assist, fai clic su Installa e poi 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, esegui 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.

ChatGPT

Per utilizzare i server Google e Google Cloud MCP con ChatGPT, devi avere un abbonamento a ChatGPT Business.

Per aggiungere i server MCP remoti di Gemini Cloud Assist e App Design Center a ChatGPT, crea un ID client e un client secret OAuth 2.0, quindi aggiungi i server MCP come plug-in in ChatGPT:

  1. Crea un ID client OAuth 2.0 e un client secret:

    1. Nella console Google Cloud , vai a Google Auth Platform > Client > Crea client.

      Vai a Crea client

      Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

    2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

    3. Nel campo Nome, inserisci un nome per l'applicazione.

    4. Nella sezione Origini JavaScript autorizzate, fai clic su + Aggiungi URI e poi inserisci https://chatgpt.com nel campo URI.

    5. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci https://chatgpt.com/connector_platform_oauth_redirect nel campo URI.

    6. Fai clic su Crea. Il client è stato creato.

      Si apre la finestra di dialogo Client OAuth 2.0 creato.

    7. Nella sezione Client secret, copia il Client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

  2. Accedi a ChatGPT con la modalità sviluppatore attivata.

  3. Segui le istruzioni riportate in Creare un plug-in per aggiungere un connettore personalizzato per ogni server MCP:

    • Per Gemini Cloud Assist, imposta l'URL del server su https://geminicloudassist.googleapis.com/mcp.
    • Per App Design Center, imposta l'URL del server su https://designcenter.googleapis.com/mcp.

  4. In OAuth o Impostazioni avanzate, inserisci l'ID client e il client secret OAuth.

  5. Completa la richiesta di accesso per abilitare i server MCP nella chat.

Claude.ai

Per aggiungere i server MCP remoti di Gemini Cloud Assist e App Design Center a Claude.ai, configura i connettori personalizzati con un ID client OAuth 2.0 e un client secret:

  1. Crea un ID client OAuth 2.0 e un client secret:

    1. Nella console Google Cloud , vai a Google Auth Platform > Client > Crea client.

      Vai a Crea client

      Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

    2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

    3. Nel campo Nome, inserisci un nome per l'applicazione.

    4. Nella sezione Origini JavaScript autorizzate, fai clic su + Aggiungi URI e poi inserisci https://claude.ai nel campo URI.

    5. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci https://claude.ai/api/mcp/auth_callback nel campo URI.

    6. Fai clic su Crea. Il client è stato creato.

      Si apre la finestra di dialogo Client OAuth 2.0 creato.

    7. Nella sezione Client secret, copia il Client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

  2. Segui le istruzioni per creare un connettore personalizzato per ogni server MCP:

    • Per Gemini Cloud Assist, imposta l'URL del server su https://geminicloudassist.googleapis.com/mcp.
    • Per App Design Center, imposta l'URL del server su https://designcenter.googleapis.com/mcp.

  3. Nel menu Impostazioni avanzate, inserisci l'ID client e il client secret OAuth.

  4. Completa la richiesta di accesso per abilitare i server MCP nella chat.

Claude Code

Per aggiungere i server MCP remoti di Gemini Cloud Assist e App Design Center a Cloud Code, configura i connettori personalizzati con un ID client OAuth 2.0 e un client secret:

  1. Installa Claude Code.

  2. Crea un ID client OAuth 2.0 e un client secret:

    1. Nella console Google Cloud , vai a Google Auth Platform > Client > Crea client.

      Vai a Crea client

      Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

    2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

    3. Nel campo Nome, inserisci un nome per l'applicazione.

    4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci https://claude.ai/api/mcp/auth_callback nel campo URI.

    5. Fai clic su Crea. Il client è stato creato.

      Si apre la finestra di dialogo Client OAuth 2.0 creato.

    6. Nella sezione Client secret, copia il Client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

  3. Segui le istruzioni per creare un connettore personalizzato per ogni server MCP:

    • Per Gemini Cloud Assist, imposta l'URL del server su https://geminicloudassist.googleapis.com/mcp.
    • Per App Design Center, imposta l'URL del server su https://designcenter.googleapis.com/mcp.

  4. Nel menu Impostazioni avanzate, inserisci l'ID client e il client secret OAuth.

  5. Completa la richiesta di accesso per abilitare i server MCP nella chat.

Claude Desktop

Per aggiungere i server MCP remoti di Gemini Cloud Assist e App Design Center a Claude Desktop, configura i connettori personalizzati con un ID client OAuth 2.0 e un client secret:

  1. Installa Claude Desktop.

  2. Crea un ID client OAuth 2.0 e un client secret:

    1. Nella console Google Cloud , vai a Google Auth Platform > Client > Crea client.

      Vai a Crea client

      Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

    2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

    3. Nel campo Nome, inserisci un nome per l'applicazione.

    4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci https://claude.ai/api/mcp/auth_callback nel campo URI.

    5. Fai clic su Crea. Il client è stato creato.

      Si apre la finestra di dialogo Client OAuth 2.0 creato.

    6. Nella sezione Client secret, copia il Client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

  3. Segui le istruzioni per creare un connettore personalizzato per ogni server MCP:

    • Per Gemini Cloud Assist, imposta l'URL del server su https://geminicloudassist.googleapis.com/mcp.
    • Per App Design Center, imposta l'URL del server su https://designcenter.googleapis.com/mcp.

  4. Nel menu Impostazioni avanzate, inserisci l'ID client e il client secret OAuth.

  5. Completa la richiesta di accesso per abilitare i server MCP nella chat.

Codex

Per aggiungere i server MCP remoti di Gemini Cloud Assist e App Design Center a Codex Enterprise, completa i seguenti passaggi:

  1. Nell'interfaccia utente di Codex Enterprise, apri Impostazioni, seleziona Server MCP e poi fai clic su Visualizza configurazione non elaborata per aprire l'editor mcp_config.json.

  2. Aggiungi o unisci il seguente blocco di configurazione al file mcp_config.json. 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"
    }
  }
}

Cursore

Per aggiungere i server MCP remoti di Gemini Cloud Assist e App Design Center a Cursor, crea un ID client e un client secret OAuth 2.0, quindi configura i server MCP con OAuth statico. Cursor utilizza URI di reindirizzamento diversi a seconda che tu acceda a Cursor tramite il web o un'app per computer:

  1. Crea un ID client OAuth 2.0 e un client secret:

    Agenti web o con cursore

    1. Nella console Google Cloud , vai a Google Auth Platform > Client > Crea client.

      Vai a Crea client

      Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

    2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

    3. Nel campo Nome, inserisci un nome per l'applicazione.

    4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci https://www.cursor.com/agents/mcp/oauth/callback nel campo URI.

    5. Fai clic su Crea. Il client è stato creato.

      Si apre la finestra di dialogo Client OAuth 2.0 creato.

    6. Nella sezione Client secret, copia il Client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

    Desktop

    1. Nella console Google Cloud , vai a Google Auth Platform > Client > Crea client.

      Vai a Crea client

      Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

    2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

    3. Nel campo Nome, inserisci un nome per l'applicazione.

    4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci http://localhost:8787/callback nel campo URI.

    5. Fai clic su Crea. Il client è stato creato.

      Si apre la finestra di dialogo Client OAuth 2.0 creato.

    6. Nella sezione Client secret, copia il Client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

  2. Segui le istruzioni per configurare il server MCP con OAuth statico, e aggiungi o unisci il seguente blocco di configurazione alla configurazione MCP di Cursor:

    {
  "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"]
      }
    },
    "application_design_center": {
      "url": "https://designcenter.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

  3. Imposta le variabili di ambiente OAUTH_CLIENT_ID e OAUTH_CLIENT_SECRET nel tuo ambiente.

  4. Utilizzare il server MCP in Chat.

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 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'applicazionee. 

    {
  "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 della skill.

    Crea un file SKILL.md in una delle seguenti directory. Copia e incolla i contenuti 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/

    Sostituisci SKILL_NAME con il nome della directory della tua skill.

    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 e poi esegui questi comandi per verificare la configurazione:

    • /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.

Gemini Enterprise

Per registrare i server MCP remoti di Gemini Cloud Assist e App Design Center in Gemini Enterprise, un amministratore deve completare i seguenti passaggi:

  1. Crea un ID client OAuth 2.0 e un client secret con l'URI di reindirizzamento di Gemini Enterprise:

    1. Nella console Google Cloud , vai a Google Auth Platform > Client > Crea client.

      Vai a Crea client

      Se non hai selezionato un progetto, ti viene chiesto di crearne uno.

    2. Nell'elenco Tipo di applicazione, seleziona Applicazione web.

    3. Nel campo Nome, inserisci un nome per l'applicazione.

    4. Nella sezione URI di reindirizzamento autorizzati, fai clic su + Aggiungi URI e poi inserisci https://vertexaisearch.cloud.google.com/oauth-redirect nel campo URI.

    5. Fai clic su Crea. Il client è stato creato.

      Si apre la finestra di dialogo Client OAuth 2.0 creato.

    6. Nella sezione Client secret, copia il Client secret e salvalo in un luogo sicuro. Puoi copiarlo una sola volta. Se lo perdi, elimina il secret e creane uno nuovo.

  2. Nella console Google Cloud , vai a Gemini Enterprise > Datastore e poi fai clic su Crea datastore. Per saperne di più, vedi Configurare il datastore del server MCP personalizzato.

  3. Seleziona Server MCP personalizzato come origine dati.

  4. Configura un datastore del server MCP personalizzato per ogni endpoint:

    • Per Gemini Cloud Assist, inserisci https://geminicloudassist.googleapis.com/mcp.
    • Per App Design Center, inserisci https://designcenter.googleapis.com/mcp.

  5. Inserisci l'ID client e il client secret OAuth, quindi salva il datastore. Gli strumenti diventano disponibili per gli agenti Gemini Enterprise.

Skill di Gemini Cloud Assist

Gli strumenti MCP Gemini Cloud Assist e App Design Center utilizzano le skill 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 degli strumenti specializzati esistenti, utilizza le seguenti strategie per ottimizzare l'ambiente e il 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 è richiesta la sua vasta esperienza nel 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 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 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