Integrar o Gemini Cloud Assist com ferramentas de terceiros usando o MCP

Este documento mostra como integrar o Gemini Cloud Assist e o App Design Center a ferramentas de terceiros, incluindo Antigravity, CLI do Gemini e Cursor, usando o Protocolo de Contexto de Modelo (MCP).

Com o MCP, você integra o Gemini Cloud Assist e os recursos de agente da Central de design de apps diretamente às suas ferramentas de terceiros e fluxos de trabalho personalizados preferidos. Assim, você acessa a experiência em operações na nuvem exatamente onde já trabalha. Para mais detalhes sobre o MCP, consulte Configurar o MCP para seu aplicativo de IA.

Ferramentas do Gemini Cloud Assist MCP

O Gemini Cloud Assist é um agente acessível por um conjunto de ferramentas do MCP usando o padrão de agentes como ferramentas. Ao contrário das ferramentas que buscam dados ou fazem processamento procedural, as ferramentas do Gemini Cloud Assist expõem a funcionalidade de agente de todo o Gemini Cloud Assist ou de fluxos de trabalho específicos. O agente invocado por chamadas de ferramentas do MCP faz as próprias chamadas de ferramentas internamente para Google Cloud. As seguintes ferramentas do MCP são publicadas para consumo dos agentes:

  • ask_cloud_assist: é a interface principal para assistência do Google Cloud e para o agente do Gemini Cloud Assist. Toda a funcionalidade do Gemini Cloud Assist está acessível por essa ferramenta e abrange a funcionalidade das outras ferramentas do MCP.
  • design_infra: isso oferece suporte a fluxos de trabalho para projetar e arquitetar infraestrutura no Google Cloud. Ele funciona com as ferramentas do servidor MCP do App Design Center para gerenciar o ciclo de vida do design da infraestrutura. Por exemplo, é possível executar e corrigir descobertas de segurança ou implantar e corrigir problemas.
  • investigate_issue: isso oferece suporte a fluxos de trabalho para solução de problemas em Google Cloud. Ela pode fazer uma solução de problemas rápida ou mais detalhada usando um recurso de investigação.
  • invoke_operation: isso oferece suporte a fluxos de trabalho para criar, atualizar e excluir recursos em Google Cloud. Essa ferramenta só funciona quando as ações do agente estão ativadas. As operações de gravação no Gemini Cloud Assist só podem ser executadas com a invocação dessa ferramenta.
  • optimize_costs: isso oferece suporte a fluxos de trabalho para analisar, rastrear e otimizar os custos de Google Cloud . Ele fornece detalhamentos de gastos e identifica oportunidades de eficiência de custos ao encontrar recursos ociosos ou subutilizados.

Ferramentas do MCP no App Design Center

Essas ferramentas, geralmente orquestradas pela ferramenta design_infra do Gemini Cloud Assist, gerenciam os ciclos de vida dos aplicativos de infraestrutura usando o App Design Center, incluindo gerenciamento de modelos, conformidade e correção de segurança e implantação. As ferramentas são:

  • setup_adc: inicializa o ambiente do App Design Center. Essa é uma etapa de configuração única que precisa ser realizada antes de usar outras ferramentas do App Design Center.
  • manage_application: gerencia o ciclo de vida de implantação de um aplicativo. Use essa ferramenta para implantar um design verificado usando o App Design Center ou extrair o status e os detalhes de uma implantação atual. Esta é a etapa final que transforma seu design em uma infraestrutura implantada no Google Cloud.
  • manage_application_template: gerencia o conteúdo de infraestrutura como código (IaC) do design da sua infraestrutura. Use isso para salvar o design como um modelo do App Design Center, exportar o design como arquivos do Terraform ou atualizar o design. Por exemplo, é possível usar essa ferramenta para atualizar o design modificando as configurações de componentes e as configurações de parâmetros.
  • assess_best_practices: realiza uma auditoria abrangente de segurança e configuração no design do aplicativo antes da implantação. Ele valida o design de acordo com os frameworks do Security Command Center e os controles relevantes, retornando um relatório com descobertas práticas para correção.
  • list_application_templates: lista todos os designs de aplicativos disponíveis.

Essas ferramentas do MCP não devem ser tratadas como APIs estáveis nem configuradas por clientes de API procedimentais. As ferramentas dessa lista ou os parâmetros delas podem ser renomeados, redefinidos, removidos ou adicionados ao longo do tempo para acompanhar a evolução dos recursos do Gemini Cloud Assist. As funcionalidades do Gemini Cloud Assist vão permanecer estáveis para que os agentes do cliente possam executar as mesmas tarefas de forma consistente, mas a maneira como os agentes interagem e invocam o Gemini Cloud Assist por meio dessas ferramentas vai mudar com o tempo.

Antes de começar

  1. Conceder acesso: para usar o MCP, é necessário ter um papel do Identity and Access Management que contenha a permissão mcp.googleapis.com/tools.call, como um dos seguintes papéis do Gemini Cloud Assist:

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

  2. Se ainda não tiver feito isso, instale a CLI gcloud e os componentes Beta dela.

  3. Ative o serviço MCP no seu projeto com o seguinte comando:

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

    Substitua PROJECT_ID pelo Google Cloud ID do projeto.

  4. Autentique usando Application Default Credentials executando o seguinte comando:

    gcloud auth application-default login

Configurar o MCP para seu cliente

A configuração do agente cliente depende do agente que você está usando. As seções a seguir fornecem instruções para configurar o MCP em diferentes clientes.

Para ativar o fluxo de trabalho completo de design para implantação, configure seu cliente para se conectar aos servidores do Gemini Cloud Assist e do MCP do App Design Center e inclua o arquivo SKILL.md relevante. Os snippets a seguir mostram a configuração combinada.

CLI do Gemini

Configurar usando uma extensão

Instale o servidor MCP como uma extensão da CLI do Gemini usando o seguinte comando:

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

Configurar manualmente

  1. Configure as definições do servidor MCP.

    Abra o arquivo de configurações de escopo do usuário da CLI do Gemini em ~/.gemini/settings.json ou as configurações de escopo do espaço de trabalho em .gemini/settings.json. Se o arquivo não existir, crie-o. Adicione ou mescle o seguinte bloco de configuração na chave mcpServers. Verifique se o arquivo usa um formato JSON válido. Essa configuração usa automaticamente suas Application Default Credentials. 

    {
  "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. Crie e preencha os arquivos de habilidade.

    Crie um arquivo SKILL.md em um dos seguintes diretórios. Copie e cole o conteúdo em markdown da habilidade escolhida na seção referência de habilidade deste documento no arquivo.

    • Escopo do espaço de trabalho: .gemini/skills/<skill-name>/
    • Escopo do usuário: ~/.gemini/skills/<skill-name>/

    Confira um exemplo de estrutura de diretório:

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

  3. Verifique suas habilidades.

    Depois de modificar os arquivos settings.json e SKILL.md, reinicie a CLI do Gemini. Use os seguintes comandos para verificar:

    • /skills list: para verificar se as habilidades locais foram descobertas.
    • /mcp list: para verificar se os servidores MCP do Gemini Cloud Assist e do App Design Center estão conectados.

Antigravity

  1. Instale a extensão.

    No Antigravity, abra o marketplace Extensões. Pesquise a extensão do Gemini Cloud Assist, clique em Instalar e em Atualizar.

  2. Configure os servidores MCP manualmente.

    Abra o painel Gerenciar servidores MCP e clique em Ver configuração bruta para editar o arquivo mcp_config.json. Adicione ou mescle o seguinte bloco de configuração. Essa configuração usa suas Application Default Credentials para autenticação.

    {
  "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. Verifique sua configuração.

    Depois de modificar os arquivos mcp_config.json e SKILL.md, reinicie o Antigravity. No painel do agente, use os seguintes comandos de barra para verificar a conexão:

    • /skills list: verifica se suas habilidades locais foram descobertas.
    • /mcp list: verifica se os servidores MCP do Gemini Cloud Assist e do App Design Center estão conectados.

Cursor

  1. No seu projeto do Google Cloud , crie um ID do cliente OAuth 2.0 para um app de computador.

  2. Configure URI://anysphere.cursor-mcp/oauth/callback como o URL de redirecionamento. Para mais informações, consulte a documentação do cursor.

  3. Adicione ou mescle o seguinte bloco de configuração:

       {
     "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"]
         }
       }
     }
   }

Habilidades do Gemini Cloud Assist

As ferramentas do Gemini Cloud Assist e do App Design Center MCP usam habilidades de agente para instruir seu agente. A habilidade orienta o agente a realizar as seguintes tarefas:

  • Encadeie várias ferramentas em um fluxo de trabalho.
  • Processar informações locais relevantes, como código de implantação do Terraform, para raciocinar sobre seu contexto local.
  • Responder a invocações explícitas quando você se referir à skill diretamente.

Ao usar agentes interativos, como o Antigravity ou a CLI do Gemini, é possível integrar as ferramentas do MCP do Gemini Cloud Assist com outros agentes e fluxos de trabalho. Como essas ferramentas oferecem recursos amplos que podem se sobrepor às suas ferramentas especializadas atuais, use as seguintes estratégias para otimizar seu ambiente e caso de uso específicos:

  1. Personalize a definição da habilidade: atualize o arquivo SKILL.md para especificar os objetivos e casos de uso em que você quer invocar o Gemini Cloud Assist. Isso garante que o agente seja acionado apenas para tarefas em que é necessária uma ampla experiência em nuvem.
  2. Invocar habilidades explicitamente: muitos agentes interativos permitem controlar quando uma habilidade é acionada. Se o seu agente for compatível, você poderá configurar a habilidade para exigir invocação manual usando comandos de barra (/) ou menções com @ (@). Assim, você escolhe com precisão quando usar o Gemini Cloud Assist em vez de outra ferramenta especializada.

Referência de habilidade do Gemini Cloud Assist

Recomendamos o seguinte arquivo SKILL.md em todos os agentes configurados com as ferramentas MCP do Gemini Cloud Assist. Esse arquivo orienta seu agente sobre como usar as ferramentas corretamente.

A seguir