O que é gcloud MCP Server?
O servidor MCP gcloud, da organização googleapis do Google, dá ao agente uma ferramenta, run_gcloud_command, que executa a CLI gcloud instalada na sua máquina com uma lista de argumentos fornecida pelo modelo. Antes de cada chamada, ele pede ao gcloud que analise o comando, confere o grupo de comandos em uma lista de controle de acesso e então inicia o binário gcloud diretamente, sem shell, de modo que pipes, redirecionamento e encadeamento de comandos falham. O mesmo repositório também hospeda servidores separados de observabilidade, Cloud Storage e Backup and DR.
Ele não tem credenciais próprias. Cada chamada roda como a conta gcloud ativa, então herda tudo o que o gcloud auth login ou uma chave de conta de serviço ativada permitem; o README recomenda personificação de conta de serviço com um papel de IAM restrito. Uma lista de bloqueio padrão de 10 entradas, em sua maioria comandos de SSH e de túnel, além de gcloud interactive e gcloud meta, sempre se aplica, e um arquivo JSON passado com -c acrescenta uma lista de permissão ou uma lista de bloqueio, nunca as duas.
O repositório tem licença Apache-2.0 e cerca de 940 estrelas no GitHub, e o @google-cloud/gcloud-mcp teve cerca de 212.000 downloads no mês até 26 de outubro de 2026. O Google o classifica como uma prévia que não é um produto com suporte oficial nem coberto pelos termos de serviço do Google Cloud. O último release do gcloud-mcp, 0.5.3, saiu em 5 de janeiro de 2026; desde então, as mudanças foram atualizações de dependências.
Como instalar gcloud MCP Server
npx -y @google-cloud/gcloud-mcpgcloud MCP Server vale a pena?
Este servidor acrescenta quase nada entre o modelo e o gcloud, e isso é ao mesmo tempo seu atrativo e seu risco. Na configuração padrão, um agente rodando como uma conta típica de desenvolvedor pode excluir projetos, instâncias do Compute Engine e bancos do Cloud SQL, reescrever políticas de IAM ou criar chaves de conta de serviço, porque os únicos bloqueios embutidos são 10 grupos de comandos escolhidos para impedir sessões interativas, não danos. O README apresenta a lista de bloqueio assim: ela remove comandos que não fazem sentido para um agente, não comandos perigosos.
A lacuna que mais importa é a de credenciais. O gcloud auth print-access-token e suas variantes application-default e identity-token não estão na lista de bloqueio padrão, então um agente, ou um prompt injetado pela descrição de um recurso que ele leu, pode imprimir um token de acesso válido no contexto do modelo. Um pull request que os adiciona à lista de bloqueio (#419) está aberto desde 6 de maio de 2026. Até ele ser incorporado, adicione esses comandos ao seu próprio arquivo de bloqueio. A personificação definida via gcloud config também não é uma barreira firme, já que os comandos config são permitidos e um agente pode desfazê-la; ativar a própria conta de serviço, ou bloquear o grupo config, fecha essa brecha.
A lista de permissão é o recurso a usar. Um arquivo como {"allow": ["compute instances list", "logging read"]} limita o agente a grupos nomeados ou comandos exatos, e as regras são precisas quanto às faixas de release: permitir beta storage não permite o storage GA, enquanto bloquear um comando GA também bloqueia suas formas alpha e beta. A análise dos comandos passa pelo próprio linter do gcloud em vez de comparação de strings, o que torna a verificação mais difícil de driblar reordenando flags.
Não há proteção de custo para o BigQuery aqui, porque não há ferramenta de consulta ao BigQuery. O servidor só executa o binário gcloud, e a documentação não menciona dry-run nem limite de bytes. Consultas sob demanda no BigQuery custam US$ 6,25 por TiB lido após 1 TiB gratuito por mês, e as cotas por projeto do próprio BigQuery e a configuração de máximo de bytes faturados continuam sendo os controles a definir. Para SQL no BigQuery, AlloyDB ou Cloud SQL, o MCP Toolbox for Databases do Google é mais adequado, com consultas nomeadas e parametrizadas em vez de uma linha de comando aberta; o gcloud-mcp serve para o plano de controle em torno desses bancos.
Onde ele se destaca
Um engenheiro de plataforma em uma startup de 20 pessoas no Google Cloud
Perguntar por que um serviço do Cloud Run está retornando erros 500 e o que mudou
Rode o gcloud-mcp com uma lista de permissão de run services describe, run revisions list e logging read, sob uma conta de serviço que só tenha papéis de leitura. O agente lê revisões e logs sem nenhum caminho de escrita. O servidor é gratuito; as leituras do Cloud Logging são cobradas normalmente.
Uma analista de FinOps em uma varejista de porte médio
Inventariar discos ociosos do Compute Engine e endereços IP não associados em vários projetos
Comandos de listagem como compute disks list e compute addresses list com --filter e projeções de --format devolvem só os campos necessários, mantendo a saída pequena. Com uma lista de permissão de comandos de listagem, o agente pode relatar, mas não excluir, o que deixa a decisão da limpeza com uma pessoa.
Um engenheiro de segurança avaliando se permite agentes em uma organização regulada do Google Cloud
Decidir o que um agente no laptop de um desenvolvedor poderia fazer com o login gcloud desse desenvolvedor
De fábrica, ele pode fazer tudo o que esse login pode, inclusive imprimir tokens de acesso, e o Google não oferece contrato de suporte para ele. Um arquivo de lista de permissão distribuído com a configuração do cliente, mais personificação de uma conta de serviço só de leitura, é o mínimo antes da aprovação.
Antes de decidir
- Configuração
- Requer Node.js 20 ou posterior e uma CLI gcloud autenticada. npx @google-cloud/gcloud-mcp init --agent=gemini-cli o instala como extensão do Gemini CLI; para Claude Desktop, Cursor, Cline ou VS Code, adicione npx -y @google-cloud/gcloud-mcp à configuração MCP. A flag -c recebe um caminho absoluto para um arquivo JSON de permissão ou bloqueio.
- Integrações
- Uma ferramenta, run_gcloud_command, cobrindo tudo o que o gcloud cobre, leitura e escrita. O mesmo repositório distribui servidores separados: storage-mcp (por padrão só leitura e criação, exclusões atrás de --enable-destructive-tools), observability-mcp (logs, métricas e traces via Application Default Credentials) e backupdr-mcp. Só stdio; sem transporte HTTP.
- Dados e privacidade
- Roda localmente como a conta gcloud ativa e devolve a saída dos comandos ao modelo. Tudo o que o gcloud pode imprimir chega ao contexto, inclusive tokens de acesso, a menos que você bloqueie os comandos auth print, e descrições de recursos ou linhas de log são texto não confiável. Nenhum aviso de segurança foi publicado no GitHub.
- Custo em escala
- O servidor é gratuito; cada comando é cobrado no projeto como de costume. Os erros caros são escritas, como criar instâncias ou GPUs, não o volume de chamadas, e nada no servidor os limita; orçamentos, cotas e IAM precisam fazer isso.
- Limites
- Prévia sujeita a mudanças incompatíveis, fora do suporte e dos termos do Google Cloud. Não tem dry-run, etapa de aprovação nem confirmação por comando próprios. A lista de bloqueio padrão não pode ser sobrescrita, então fluxos baseados em SSH ficam indisponíveis. Havia 33 issues abertas em 28 de outubro de 2026.
O que é bom
- Uma ferramenta alcança quase todo serviço do Google Cloud que o gcloud cobre
- Lista de permissão ou de bloqueio por grupo de comandos, analisada pelo próprio linter do gcloud
- Sem shell, então pipes, encadeamento e substituição falham
- Usa as credenciais e o IAM existentes do gcloud, nada novo a provisionar
O que não é
- A lista de bloqueio padrão barra SSH e comandos interativos, não exclusões
- Os comandos print-access-token não são bloqueados por padrão
- Prévia, não um produto do Google com suporte oficial
- Nenhum release do gcloud-mcp desde janeiro de 2026
Ideal para
Engenheiros de Google Cloud que querem um agente para inspecionar e operar recursos pelo gcloud e vão prendê-lo a uma lista de permissão e a uma conta de serviço restrita.
Alternativas ao gcloud MCP Server
gcloud MCP Server: perguntas frequentes
- gcloud MCP Server vale a pena?
- Um wrapper fino e honesto em torno do gcloud, exatamente tão seguro quanto a conta por trás dele, o que, para a maioria dos desenvolvedores, significa poderoso demais até você adicionar uma lista de permissão. Damos nota 3.5 de 5.
- Quanto custa gcloud MCP Server?
- Gratuito e com licença Apache-2.0. Cada comando é cobrado no seu projeto do Google Cloud como se você mesmo o tivesse digitado.
- Quais são as desvantagens de gcloud MCP Server?
- A lista de bloqueio padrão barra SSH e comandos interativos, não exclusões; os comandos print-access-token não são bloqueados por padrão; prévia, não um produto do Google com suporte oficial; nenhum release do gcloud-mcp desde janeiro de 2026.
- Para quem gcloud MCP Server é indicado?
- Engenheiros de Google Cloud que querem um agente para inspecionar e operar recursos pelo gcloud e vão prendê-lo a uma lista de permissão e a uma conta de serviço restrita.
- Quanto custa gcloud MCP Server para uma equipe ou em produção?
- O servidor é gratuito; cada comando é cobrado no projeto como de costume. Os erros caros são escritas, como criar instâncias ou GPUs, não o volume de chamadas, e nada no servidor os limita; orçamentos, cotas e IAM precisam fazer isso.
- gcloud MCP Server é seguro para dados da empresa?
- Roda localmente como a conta gcloud ativa e devolve a saída dos comandos ao modelo. Tudo o que o gcloud pode imprimir chega ao contexto, inclusive tokens de acesso, a menos que você bloqueie os comandos auth print, e descrições de recursos ou linhas de log são texto não confiável. Nenhum aviso de segurança foi publicado no GitHub.
- Quais são as melhores alternativas ao gcloud MCP Server?
- As alternativas mais próximas que analisamos são MCP Toolbox for Databases, AWS MCP Server, Azure MCP Server e Terraform MCP Server.
Respostas verificadas em 28 de out. de 2026.