Gemini Cloud Assist

oficial

Um servidor MCP que se conecta às APIs do Gemini Cloud Assist, permitindo gerenciar e solucionar problemas do seu ambiente Google Cloud usando linguagem natural.

O que você pode fazer com Gemini Cloud Assist MCP?

  • Investigue incidentes — Peça ao assistente para encaminhar a solução de problemas e a análise da causa raiz no Google Cloud ao Cloud Operator por meio de ask_cloud_operator.
  • Revise implantações e Terraform — Solicite verificações de prontidão de implantações ou a revisão e geração de Terraform, com as alterações registradas em edições de arquivos que podem ser revisadas.
  • Otimize custos — Peça ao Cloud Operator para analisar seu faturamento e seus recursos em tempo real em busca de oportunidades de otimização de custos.
  • Continue uma sessão — Reutilize o contextId retornado por ask_cloud_operator para manter o contexto em chamadas de acompanhamento.
  • Encontre sessões anteriores — Liste suas sessões do Cloud Operator em um projeto com search_operator_sessions e, em seguida, obtenha as interações com fetch_operator_session.

Documentação

Servidor MCP do Gemini Cloud Assist

[!IMPORTANT] Aviso de prévia privada As APIs do servidor MCP do Gemini Cloud Assist estão atualmente em prévia privada e protegidas por uma lista de permissões. Entre em contato com a equipe da sua conta do Google Cloud para solicitar acesso.

Este repositório conecta agentes de programação com IA ao Cloud Operator, o agente operador do Gemini Cloud Assist. O Cloud Operator tem acesso aos seus recursos, registros, métricas, faturamento e políticas ativos do Google Cloud e ajuda você a:

  • Solucionar problemas de incidentes e encontrar as causas raiz.
  • Revisar implantações quanto à prontidão e monitorá-las.
  • Projetar e revisar a infraestrutura: Terraform, Kubernetes e Helm, com alterações registradas em edições de arquivos que podem ser revisadas.
  • Otimizar custos.
  • Responder a perguntas sobre como fazer, com base na documentação do Google Cloud.

[!NOTE] Os Termos de Serviço da Google Cloud Platform (disponíveis em https://cloud.google.com/terms/) e os Termos de Processamento de Dados e Segurança (disponíveis em https://cloud.google.com/terms/data-processing-terms) não se aplicam a nenhum componente do software do servidor MCP do Gemini Cloud Assist.

Como funciona

O plugin cloud-operator adiciona o Cloud Operator ao seu agente. Ele instala:

  • a skill cloud-operator, que informa ao agente quando encaminhar tarefas do Google Cloud ao Cloud Operator e como enviar o contexto necessário;
  • o servidor MCP autocloud (https://geminicloudassist.googleapis.com/mcp/autocloud), conectado com suas credenciais do Google (Application Default Credentials).

Instalação

Siga o guia de instalação: ele orienta você pelos pré-requisitos, pela remoção de uma instalação anterior, pela instalação do plugin no seu agente e pela primeira chamada.

O plugin funciona em:

  • Claude Code
  • Codex
  • Antigravity
  • Gemini CLI
  • OpenCode
  • Pi

Ferramentas MCP

O endpoint /mcp/autocloud disponibiliza estas ferramentas do Cloud Operator:

FerramentaDescrição
ask_cloud_operatorEncaminha tarefas do Google Cloud ao agente Cloud Operator: investigação de incidentes e causas raiz, revisão de implantações, otimização de custos, revisão e geração de Terraform e respostas a perguntas sobre como fazer. Retorna um contextId que dá continuidade à sessão em chamadas posteriores.
search_operator_sessionsLista as sessões do Cloud Operator em um projeto.
fetch_operator_sessionBusca uma sessão do Cloud Operator pelo seu contextId, incluindo as interações.

Observação: essas ferramentas não devem ser tratadas como APIs estáveis. Os parâmetros podem ser renomeados ou modificados conforme o Gemini Cloud Assist evolui.

Contribuição

Licença

Este projeto está licenciado sob a Licença Apache 2.0 e é fornecido no estado em que se encontra, sem garantia ou declaração para qualquer uso ou finalidade. Para mais detalhes, consulte o arquivo LICENSE.