# gemini-cloud-assist-mcp

gemini-cloud-assist-mcp connects your agent to Cloud Operator for Google Cloud: incident investigation, Terraform and manifest review, cost analysis. Access requires Private Preview allowlisting.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 72 repo stars
- Author: GoogleCloudPlatform · official Google repository
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp
- Updated: 2026-10-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/gemini-cloud-assist-mcp

## What it does

This server links your coding agent to Cloud Operator, a Google Cloud agent that works against your live project. Through `ask_cloud_operator` you can hand it incident and root-cause work, rollout checks, Terraform or Kubernetes and Helm review and generation, and cost analysis. File changes come back as edits you can look over before accepting.

The first tool, `ask_cloud_operator`, starts a task and returns a `contextId` that you pass on follow-up calls. `search_operator_sessions` lists your sessions in a project, and `fetch_operator_session` loads one by `contextId` along with its turns. The endpoint is `https://geminicloudassist.googleapis.com/mcp/autocloud`.

You need the Google Cloud SDK, a Google Cloud project, and two IAM roles: `roles/serviceusage.serviceUsageAdmin` and `roles/geminicloudassist.user`. Auth runs on Application Default Credentials, so sign in with `gcloud auth login` and then `gcloud auth application-default login`. The service is in Private Preview, and a project outside the allowlist gets no access. The remote architecture needs `v0.8.0` or newer.

## Requirements
- Needs: Node.js (commands run via npx)
- Works with: Kubernetes, Terraform

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add gemini-cloud-assist-mcp -- npx -y @google-cloud/gemini-cloud-assist-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add gemini-cloud-assist-mcp -- npx -y @google-cloud/gemini-cloud-assist-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gemini-cloud-assist-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@google-cloud/gemini-cloud-assist-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "gemini-cloud-assist-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@google-cloud/gemini-cloud-assist-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add gemini-cloud-assist-mcp npx -y @google-cloud/gemini-cloud-assist-mcp
```

## When to use it
- trace the root cause of an incident in a Google Cloud project
- check whether a rollout is ready and how it is being monitored
- review Terraform and get fixes as file edits
- generate Kubernetes and Helm manifests
- find where project spend can be cut

## Example prompts
- Use ask_cloud_operator to find out why my service started returning errors
- Ask Cloud Operator to review `main.tf` against Terraform best practices
- List my Cloud Operator sessions in this project with `search_operator_sessions`

## Similar
- [cloud-operator](https://affpapa.org/en/nevibecode/skills/cloud-operator.md) — skill · ★ 24522 repo stars
- [managing-infra](https://affpapa.org/en/nevibecode/skills/managing-infra.md) — skill · 115 installs
- [devops-cloud](https://affpapa.org/en/nevibecode/skills/devops-cloud.md) — skill · 204 installs
- [devops-engineer](https://affpapa.org/en/nevibecode/skills/devops-engineer.md) — skill · 12400 installs
- [devops-cicd](https://affpapa.org/en/nevibecode/skills/devops-cicd.md) — skill · 610 installs
- [oci](https://affpapa.org/en/nevibecode/skills/oci.md) — skill · 598 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
