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

O Protocolo de Contexto de Modelo (MCP) permite integrar os recursos do Gemini Cloud Assist e os recursos agênticos do App Design Center diretamente a ferramentas de terceiros, como Antigravity, CLI do Gemini e Cursor. Essa integração leva a experiência em operações na nuvem e a assistência de arquitetura aos seus fluxos de trabalho de desenvolvimento atuais. Para mais informações, 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 pelas chamadas de ferramentas do MCP faz as próprias chamadas de ferramentas internamente paraGoogle Cloud. As seguintes ferramentas do MCP são publicadas para que os agentes as consumam:

  • 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, que 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 ferramentas do servidor MCP do App Design Center para gerenciar o ciclo de vida do design da infraestrutura. Por exemplo, execute e corrija descobertas de segurança ou implante e corrija 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 custos de Google Cloud . Ele oferece detalhamentos de gastos e identifica oportunidades de eficiência de custos ao encontrar recursos ociosos ou subutilizados.

Ferramentas do MCP do 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 com base nas estruturas do Security Command Center e nos 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 clientes possam executar as mesmas tarefas de forma consistente, mas a maneira como os agentes interagem e invocam o Gemini Cloud Assist usando essas ferramentas vai mudar com o tempo.

Antes de começar

  1. Conceder acesso: para usar o MCP, você precisa receber 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 do 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 a MCP em diferentes clientes.

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

Antigravity

Para adicionar os servidores MCP remotos do Gemini Cloud Assist e da Central de design de apps ao Antigravity, siga as instruções em Editor do Antigravity: integração do MCP ou conclua as etapas a seguir:

  1. Instale a extensão.

    No Antigravity, abra o marketplace Extensões. Pesquise a extensão do Gemini Cloud Assist, clique em Instalar e depois 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, execute 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.

ChatGPT

Você precisa ter uma assinatura do ChatGPT Business para usar os servidores do Google e do Google Cloud MCP com o ChatGPT.

Para adicionar os servidores MCP remotos do Gemini Cloud Assist e do App Design Center ao ChatGPT, crie um ID do cliente e uma chave secreta do cliente OAuth 2.0 e adicione os servidores MCP como plug-ins no ChatGPT:

  1. Crie um ID do cliente e uma chave secreta do cliente OAuth 2.0:

    1. No console do Google Cloud , acesse Google Auth Platform > Clients > Create client.

      Acessar "Criar cliente"

      Se você não tiver um projeto selecionado, será preciso criar um.

    2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

    3. No campo Nome, insira um nome para o aplicativo.

    4. Na seção Origens JavaScript autorizadas, clique em + Adicionar URI e insira https://chatgpt.com no campo URIs.

    5. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://chatgpt.com/connector_platform_oauth_redirect no campo URIs.

    6. Clique em Criar. O cliente é criado.

      A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

    7. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Só é possível copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

  2. Faça login no ChatGPT com o modo de desenvolvedor ativado.

  3. Siga as instruções em Criar um plug-in para adicionar um conector personalizado a cada servidor MCP:

    • Para o Gemini Cloud Assist, defina o URL do servidor como https://geminicloudassist.googleapis.com/mcp.
    • Para o App Design Center, defina o URL do servidor como https://designcenter.googleapis.com/mcp.

  4. Em OAuth ou Configurações avançadas, insira o ID e a chave secreta do cliente OAuth.

  5. Conclua a solicitação de login para ativar os servidores MCP no chat.

Claude.ai

Para adicionar os servidores MCP remotos do Gemini Cloud Assist e do App Design Center ao Claude.ai, configure conectores personalizados com um ID do cliente e uma chave secreta do cliente OAuth 2.0:

  1. Crie um ID do cliente e uma chave secreta do cliente OAuth 2.0:

    1. No console do Google Cloud , acesse Google Auth Platform > Clients > Create client.

      Acessar "Criar cliente"

      Se você não tiver um projeto selecionado, será preciso criar um.

    2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

    3. No campo Nome, insira um nome para o aplicativo.

    4. Na seção Origens JavaScript autorizadas, clique em + Adicionar URI e insira https://claude.ai no campo URIs.

    5. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://claude.ai/api/mcp/auth_callback no campo URIs.

    6. Clique em Criar. O cliente é criado.

      A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

    7. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Só é possível copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

  2. Siga as instruções para criar um conector personalizado para cada servidor MCP:

    • Para o Gemini Cloud Assist, defina o URL do servidor como https://geminicloudassist.googleapis.com/mcp.
    • Para o App Design Center, defina o URL do servidor como https://designcenter.googleapis.com/mcp.

  3. No menu Configurações avançadas, insira o ID e a chave secreta do cliente OAuth.

  4. Conclua a solicitação de login para ativar os servidores MCP no chat.

Claude Code

Para adicionar os servidores MCP remotos do Gemini Cloud Assist e do App Design Center ao Claude Code, configure conectores personalizados com um ID do cliente e uma chave secreta do cliente OAuth 2.0:

  1. Instale o Claude Code.

  2. Crie um ID do cliente e uma chave secreta do cliente OAuth 2.0:

    1. No console do Google Cloud , acesse Google Auth Platform > Clients > Create client.

      Acessar "Criar cliente"

      Se você não tiver um projeto selecionado, será preciso criar um.

    2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

    3. No campo Nome, insira um nome para o aplicativo.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://claude.ai/api/mcp/auth_callback no campo URIs.

    5. Clique em Criar. O cliente é criado.

      A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

    6. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Só é possível copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

  3. Siga as instruções para criar um conector personalizado para cada servidor MCP:

    • Para o Gemini Cloud Assist, defina o URL do servidor como https://geminicloudassist.googleapis.com/mcp.
    • Para o App Design Center, defina o URL do servidor como https://designcenter.googleapis.com/mcp.

  4. No menu Configurações avançadas, insira o ID e a chave secreta do cliente OAuth.

  5. Conclua a solicitação de login para ativar os servidores MCP no chat.

Claude Desktop

Para adicionar os servidores MCP remotos do Gemini Cloud Assist e do App Design Center ao Claude Desktop, configure conectores personalizados com um ID do cliente e uma chave secreta do cliente OAuth 2.0:

  1. Instale o Claude Desktop.

  2. Crie um ID do cliente e uma chave secreta do cliente OAuth 2.0:

    1. No console do Google Cloud , acesse Google Auth Platform > Clients > Create client.

      Acessar "Criar cliente"

      Se você não tiver um projeto selecionado, será preciso criar um.

    2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

    3. No campo Nome, insira um nome para o aplicativo.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://claude.ai/api/mcp/auth_callback no campo URIs.

    5. Clique em Criar. O cliente é criado.

      A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

    6. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Só é possível copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

  3. Siga as instruções para criar um conector personalizado para cada servidor MCP:

    • Para o Gemini Cloud Assist, defina o URL do servidor como https://geminicloudassist.googleapis.com/mcp.
    • Para o App Design Center, defina o URL do servidor como https://designcenter.googleapis.com/mcp.

  4. No menu Configurações avançadas, insira o ID e a chave secreta do cliente OAuth.

  5. Conclua a solicitação de login para ativar os servidores MCP no chat.

Codex

Para adicionar os servidores MCP remotos do Gemini Cloud Assist e da Central de design de apps ao Codex Enterprise, siga estas etapas:

  1. Na interface do Codex Enterprise, abra Configurações, selecione Servidores MCP e clique em Ver configuração bruta para abrir o editor mcp_config.json.

  2. Adicione ou mescle o seguinte bloco de configuração ao arquivo mcp_config.json. Essa configuração usa suas credenciais padrão do aplicativo 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"
    }
  }
}

Cursor

Para adicionar os servidores MCP remotos do Gemini Cloud Assist e da Central de design de apps ao Cursor, crie um ID do cliente e uma chave secreta do cliente OAuth 2.0 e configure os servidores MCP com OAuth estático. O Cursor usa URIs de redirecionamento diferentes, dependendo se você acessa o Cursor pela Web ou por um app para computador:

  1. Crie um ID do cliente e uma chave secreta do cliente OAuth 2.0:

    Agentes da Web ou de cursor

    1. No console do Google Cloud , acesse Google Auth Platform > Clients > Create client.

      Acessar "Criar cliente"

      Se você não tiver um projeto selecionado, será preciso criar um.

    2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

    3. No campo Nome, insira um nome para o aplicativo.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://www.cursor.com/agents/mcp/oauth/callback no campo URIs.

    5. Clique em Criar. O cliente é criado.

      A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

    6. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Só é possível copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

    Computador

    1. No console do Google Cloud , acesse Google Auth Platform > Clients > Create client.

      Acessar "Criar cliente"

      Se você não tiver um projeto selecionado, será preciso criar um.

    2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

    3. No campo Nome, insira um nome para o aplicativo.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira http://localhost:8787/callback no campo URIs.

    5. Clique em Criar. O cliente é criado.

      A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

    6. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Só é possível copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

  2. Siga as instruções para configurar o servidor MCP com OAuth estático e adicione ou mescle o seguinte bloco de configuração à sua configuração do MCP do 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. Defina as variáveis de ambiente OAUTH_CLIENT_ID e OAUTH_CLIENT_SECRET no seu ambiente.

  4. Usar o servidor MCP no Chat.

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 um. 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 do Markdown para a 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/

    Substitua SKILL_NAME pelo nome do diretório da sua habilidade.

    Confira a seguir 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 e execute os comandos a seguir para verificar a configuraçã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.

Gemini Enterprise

Para registrar os servidores MCP remotos do Gemini Cloud Assist e da Central de design de apps no Gemini Enterprise, um administrador precisa concluir as seguintes etapas:

  1. Crie um ID do cliente e uma chave secreta do cliente OAuth 2.0 com o URI de redirecionamento do Gemini Enterprise:

    1. No console do Google Cloud , acesse Google Auth Platform > Clients > Create client.

      Acessar "Criar cliente"

      Se você não tiver um projeto selecionado, será preciso criar um.

    2. Na lista Tipo de aplicativo, selecione Aplicativo da Web.

    3. No campo Nome, insira um nome para o aplicativo.

    4. Na seção URIs de redirecionamento autorizados, clique em + Adicionar URI e insira https://vertexaisearch.cloud.google.com/oauth-redirect no campo URIs.

    5. Clique em Criar. O cliente é criado.

      A caixa de diálogo Cliente OAuth 2.0 criado é aberta.

    6. Na seção Chaves secretas do cliente, copie a Chave secreta do cliente e salve em um local seguro. Só é possível copiar uma vez. Se você perder a chave, exclua a chave secreta e crie outra.

  2. No console do Google Cloud , acesse Gemini Enterprise > Repositórios de dados e clique em Criar repositório de dados. Para mais informações, consulte Configurar o repositório de dados do servidor MCP personalizado.

  3. Selecione Servidor MCP personalizado como a fonte de dados.

  4. Configure um repositório de dados de servidor MCP personalizado para cada endpoint:

    • Para o Gemini Cloud Assist, insira https://geminicloudassist.googleapis.com/mcp.
    • Para o App Design Center, insira https://designcenter.googleapis.com/mcp.

  5. Insira o ID do cliente e a chave secreta do cliente do OAuth e salve o repositório de dados. As ferramentas ficam disponíveis para os agentes do Gemini Enterprise.

Habilidades do Gemini Cloud Assist

As ferramentas MCP do Gemini Cloud Assist e do App Design Center 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.
  • Responda 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 de habilidade: atualize o arquivo SKILL.md para especificar os intents e casos de uso em que você quer invocar o Gemini Cloud Assist. Isso garante que o agente só seja acionado 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 arroba (@). Essa abordagem permite escolher precisamente quando usar o Gemini Cloud Assist em vez de outra ferramenta especializada.

Referência de habilidades 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 o agente sobre como usar as ferramentas corretamente.

A seguir