Gemini Cloud Assist

Servidor MCP Gemini Cloud Assist

[!IMPORTANT] Aviso de Prévia Privada As APIs do servidor MCP Gemini Cloud Assist estão atualmente em Prévia Privada e estão atrás de uma lista de permissões. Entre em contato com a equipe de conta do Google Cloud para solicitar acesso.

[!WARNING] Aviso de Descontinuação e Migração para Servidor MCP Remoto

O servidor MCP Gemini Cloud Assist migrou de uma arquitetura local baseada em Node.js para uma arquitetura de Servidor MCP Remoto. O servidor local mais antigo baseado em Node.js perderá suporte nos próximos meses.

Para usar os novos Servidores MCP Remotos, use a versão v0.8.0 ou posterior. Se desejar continuar usando o servidor local legado durante a transição, fixe sua configuração em versões mais antigas.

Este servidor conecta clientes do Model Context Protocol (MCP) às APIs Gemini Cloud Assist. Ele permite que você use linguagem natural para entender, gerenciar e solucionar problemas do seu ambiente Google Cloud diretamente da linha de comando local.

[!NOTE] Os Termos de Serviço do 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 Gemini Cloud Assist.

Para saber mais sobre o Gemini Cloud Assist, consulte a Visão geral do Gemini Cloud Assist na documentação do Google Cloud.

✨ Principais recursos

• Projetar infraestrutura: Crie e arquitete configurações de infraestrutura para o Google Cloud.
• Solucionar problemas: Execute investigações aprofundadas para encontrar a causa raiz de problemas complexos no seu ambiente Google Cloud.
• Gerenciar recursos: Crie, atualize e exclua recursos do Google Cloud diretamente do seu fluxo de chat (requer Agent Actions).
• Otimizar custos: Analise seus gastos, acompanhe custos e identifique oportunidades de eficiência, como recursos ociosos.
• Obter assistência geral: Faça perguntas e receba orientações sobre práticas recomendadas, arquiteturas e operações do Google Cloud.

Início rápido

Antes de começar, certifique-se de ter o seguinte configurado:

• Google Cloud SDK instalado e configurado.
• Um projeto Google Cloud.
• Os seguintes papéis de IAM na sua conta de usuário:
  • roles/serviceusage.serviceUsageAdmin: Necessário para ativar as APIs do Cloud Assist.
  • roles/geminicloudassist.user: Necessário para fazer solicitações às APIs do Cloud Assist.

Etapa 1: Autenticar no Google Cloud

O servidor MCP Gemini Cloud Assist usa as Credenciais Padrão do Aplicativo (ADC) locais para autenticar com segurança no Google Cloud. Para configurar o ADC, execute os seguintes comandos gcloud:

# Authenticate your user account to the gcloud CLI
gcloud auth login

# Set up Application Default Credentials for the server.
gcloud auth application-default login

Configurar seu cliente MCP

A configuração do cliente-agente depende de qual agente você está usando.

Antigravity

Adicione o seguinte ao seu mcp_config.json:

"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

1. No seu projeto Google Cloud, crie um ID de cliente OAuth 2.0 para um aplicativo de desktop.
2. Configure URI://anysphere.cursor-mcp/oauth/callback como a URL de redirecionamento.
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"]
      }
    },
    "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"]
      }
    }
  }
}

Claude

Siga as instruções de configuração para seu aplicativo específico:

• Claude.ai

Ferramentas MCP

Ferramentas MCP do Gemini Cloud Assist

O Gemini Cloud Assist é um agente acessível por meio de um conjunto de ferramentas MCP. O agente invocado por chamadas de ferramentas MCP faz suas próprias chamadas de ferramentas internamente para o Google Cloud. As seguintes ferramentas MCP são publicadas para consumo pelos agentes:

Ferramenta	Descrição
ask_cloud_assist	A interface principal para assistência do Google Cloud e para o agente Gemini Cloud Assist. Toda a funcionalidade é acessível por meio desta ferramenta.
design_infra	Suporta fluxos de trabalho para projetar e arquitetar infraestrutura no Google Cloud.
investigate_issue	Suporta fluxos de trabalho para solução de problemas no Google Cloud. Pode fazer solução de problemas rápida ou mais aprofundada por meio de um recurso de Investigação.
invoke_operation	Suporta fluxos de trabalho para criar, atualizar e excluir recursos no Google Cloud. Só funciona quando Agent Actions estão habilitadas.
optimize_costs	Suporta fluxos de trabalho para analisar, acompanhar e otimizar custos do Google Cloud. Fornece detalhamentos de gastos e identifica oportunidades de eficiência de custos.

Ferramentas MCP do Application Design Center

As ferramentas do Application Design Center MCP, frequentemente orquestradas pela ferramenta design_infra do GCA, gerenciam o ciclo de vida do aplicativo de infraestrutura usando o Application Design Center, incluindo gerenciamento de modelos, conformidade e correção de segurança e implantação.

Ferramenta	Descrição
setup_adc	Inicializa o ambiente do Application Design Center. Esta é uma etapa de configuração única que deve ser executada antes que outras ferramentas ADC possam ser usadas.
manage_application	Gerencia o ciclo de vida de implantação de um aplicativo. Use esta ferramenta para implantar um design verificado usando o Application Design Center ou recuperar o status e os detalhes de uma implantação existente. Este é o passo final que transforma seu design em infraestrutura implantada no Google Cloud.
manage_application_template	Gerencia o conteúdo de Infraestrutura como Código (IaC) do seu design de infraestrutura. Use para salvar o design como um modelo do Application Design Center, exportar o design como arquivos Terraform ou atualizar o design (por exemplo, componente, configurações de parâmetros etc.).
assess_best_practices	Realiza uma auditoria abrangente de segurança e configuração no seu design de aplicativo antes da implantação. Valida o design em relação às estruturas do Security Command Center e controles relevantes, retornando um relatório com descobertas acionáveis para correção.
list_application_templates	Lista todos os designs de aplicativo disponíveis.

Observação: Essas ferramentas não devem ser tratadas como APIs estáveis. Os parâmetros podem ser renomeados ou modificados para acomodar as capacidades em evolução do Gemini Cloud Assist.

Habilidades do Agente

As ferramentas MCP do Gemini Cloud Assist utilizam arquivos SKILL.md para instruir seu agente sobre como usar as ferramentas corretamente. As habilidades ajudam a orientar seu agente a encadear várias ferramentas em um fluxo de trabalho, passar informações locais relevantes para o Gemini Cloud Assist e habilitar invocação explícita.

Habilidade	Descrição
designing-and-deploying-infrastructure	Orienta o agente sobre como projetar, avaliar, implantar e solucionar problemas de infraestrutura em nuvem usando o Application Design Center (ADC) e as ferramentas do Gemini Cloud Assist.
operating-google-cloud	Fornece instruções para gerenciar recursos do Google Cloud Platform (GCP) e Kubernetes usando ferramentas MCP especializadas.

Contribuindo

• Se você encontrar um bug, registre um problema em nossa página de GitHub Issues.
• Antes de enviar uma solicitação de pull, revise nosso Guia de Contribuição.

Licença

Este projeto é licenciado sob a Licença Apache 2.0 e fornecido como está, sem garantia ou representação para qualquer uso ou finalidade. Para detalhes, consulte o arquivo LICENSE.