К основному содержанию
скилл CX Codex

gcp-mcp-setup — скилл для Claude Code и Gemini CLI

Скилл gcp-mcp-setup для Claude Code, Codex и Gemini CLI автоматизирует подключение Google Managed MCP-серверов (OneMCP) к CLI-окружению. Включает нужные API, генерирует ключи и записывает конфигурацию в нужный файл настроек.

Apache-2.0 ★ 151 обновлён 2026-10-12

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add gemini-cli-extensions/sre
/plugin install sre-extension@sre
Открыть на GitHub

Что делает gcp-mcp-setup

Скилл работает на трёх платформах: Claude Code, Codex и Gemini CLI. Он запускает скрипт setup_onemcp.py, который включает Google API, поднимает MCP-серверы и записывает блок mcpServers в файл настроек активного окружения. По умолчанию подключаются Logging, Monitoring, GKE, Run, Resource Manager и Developer Knowledge. Флаг --all добавляет Error Reporting, Cloud SQL, Spanner, Pub/Sub, Vertex AI, Firestore и BigQuery.

Файл конфигурации зависит от целевого окружения: для Gemini CLI это .gemini/settings.json (локально) или ~/.gemini/settings.json (глобально), для Copilot CLI — ~/.copilot/mcp-config.json (только глобально). Флаг --harness позволяет явно указать gemini, antigravity или copilot.

MCP-серверы аутентифицируются через Application Default Credentials, а не через gcloud auth login. Если идентичности расходятся, запросы к API будут падать с ошибкой serviceusage.serviceUsageConsumer denied — даже когда gcloud-команды работают корректно. Проверить состояние после установки можно скриптом verify_setup.py.

Какие задачи решает

  • подключить OneMCP к Gemini CLI одной командой
  • настроить MCP-серверы для нескольких CLI-окружений разом
  • сгенерировать API-ключ и записать конфигурацию автоматически
  • включить Vertex AI и BigQuery через флаг --all
  • диагностировать расхождение идентичностей gcloud и ADC

Примеры запросов агенту

  • Установи OneMCP на проект my-gcp-project с настройкой для Gemini CLI
  • Запусти gcp-mcp-setup с флагом --all и подключи Firestore и BigQuery
  • Проверь, что все google-* серверы зарегистрированы в окружении Codex

Как установить gcp-mcp-setup

1Через маркетплейс плагинов

/plugin marketplace add gemini-cli-extensions/sre
/plugin install sre-extension@sre

Команда ставит плагин sre-extension целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add gemini-cli-extensions/sre --skill gcp-mcp-setup -a claude-code

3Вручную: положить файлы

~/.claude/skills/gcp-mcp-setup/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/gcp-mcp-setup/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о gcp-mcp-setup

Как установить gcp-mcp-setup в Claude Code?

Сначала выполни /plugin marketplace add gemini-cli-extensions/sre, затем /plugin install sre-extension@sre. Альтернативный путь: npx skills add gemini-cli-extensions/sre --skill gcp-mcp-setup -a claude-code — скилл появится в ~/.claude/skills/gcp-mcp-setup/SKILL.md.

Что делает gcp-mcp-setup?

Скилл запускает скрипт настройки, который включает нужные Google API, поднимает Google Managed MCP-серверы и записывает блок конфигурации в файл настроек целевого CLI-окружения.

Почему MCP-серверы не работают после установки, хотя gcloud-команды проходят?

MCP-серверы используют Application Default Credentials, а не текущую сессию gcloud. При расхождении идентичностей нужно выполнить gcloud auth application-default login --account <PROPOSED_IDENTITY_EMAIL> и затем перезапустить verify_setup.py.

Исходный текст

SKILL.md · Apache-2.0
---
name: gcp-mcp-setup
description: 🐉 Use when the user wants to set up Google Managed MCP (OneMCP) servers for their CLI environment. Automates enabling services, MCP servers, generating API keys, and configuring the MCP settings file for the active harness (Gemini, Antigravity, or Copilot CLI).
metadata:
  author: Riccardo
  version: 0.0.10
  status: published
---

# OneMCP Setup Skill

## Overview

This skill provides the automated steps to configure your environment and enable the **Core Google Managed MCP servers** (Logging, Monitoring, GKE, Run, Resource Manager, Developer Knowledge) by default. Use the `--all` flag to include additional services like Error Reporting, Cloud SQL, Spanner, Pub/Sub, Vertex AI, Firestore, and BigQuery.

## When to Use

Use this skill when the user asks to "install OneMCP", "setup OneMCP", or "configure Google Managed MCP servers".

## Core Pattern

1. **Prerequisites Verification**: Ensure the user has `gcloud` authenticated and a target Google Cloud Project with billing enabled.
2. **Setup Script Execution**: Run the provided script to enable APIs, MCP services, and generate the required API Key. 
   - By default, it installs a **Lean SRE toolset** (Logging, Monitoring, GKE, Run, Resource Manager, Developer Knowledge).
   - Use the `--all` flag to include optional services (Error Reporting, Databases, Vertex AI).
   - Use `--harness` to target a specific CLI harness (`gemini`, `antigravity`, or `copilot`). Defaults to `gemini+antigravity`.
   - Script: `skills/gcp-mcp-setup/scripts/setup_onemcp.py <PROJECT_ID> [--local | --global] [--harness {gemini,antigravity,copilot}] [--all] [--google-maps-key YOUR_KEY]`
3. **Configure Settings**: The script automatically writes the `mcpServers` configuration to the correct location depending on the target harness:
   - **Gemini CLI**: `.gemini/settings.json` (local) or `~/.gemini/settings.json` (global).
   - **Antigravity CLI (agy)**: `.gemini/antigravity/mcp_config.json` and `.gemini/config/mcp_config.json` (local) or the global equivalents under `~/.gemini/`.
   - **GitHub Copilot CLI**: `~/.copilot/mcp-config.json` (always global — no workspace-level config yet).
4. **Verification & Diagnostics:**
   - Script: `skills/gcp-mcp-setup/scripts/verify_setup.py [--harness {gemini,antigravity,copilot}]`
   - This script checks identity consistency (gcloud vs ADC), runs the harness-specific MCP list command, and confirms all expected google-* servers are registered.

## Examples

User: "Please install OneMCP on my project my-gcp-project"
Agent: "I will use the gcp-mcp-setup skill to configure your project and Gemini settings for Cloud Logging, Developer Knowledge, Firestore, and BigQuery."

## Authentication

Note that the **gcloud CLI Identity** (how you are currently logged in via `gcloud auth login`) may differ from the **MCP Server Identity** (which is based on Application Default Credentials, or ADC).

MCP servers typically use ADC to authenticate. If these identities do not match, you may encounter permission errors (e.g., `serviceusage.serviceUsageConsumer` denied) even if `gcloud` commands work correctly.

If MCP doesn't work, you can propose to run this on user's behalf: `gcloud auth application-default login --account <PROPOSED_IDENTITY_EMAIL>`

### 💡 Path Forward

If you encounter an identity mismatch:
1. Run `gcloud auth application-default login --account=YOUR_CLI_IDENTITY` to synchronize identities.
2. Verify the identities match by running the verification script: `python3 skills/gcp-mcp-setup/scripts/verify_setup.py`.

## Documentation

- Antigravity MCP integration guide: https://antigravity.google/docs/mcp
- Code samples from Romin Irani: https://github.com/rominirani/google-mcp-servers/blob/main/demos/README.md
- All supported products: https://docs.cloud.google.com/mcp/supported-products

© Riccardo · Apache-2.0 · gemini-cli-extensions/sre

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
dt-obs-gcp Dynatrace Скилл dt-obs-gcp для Claude Code запрашивает GCP-ресурсы через Dynatrace Smartscape и DQL. Охватывает Compute Engine, GKE, Cloud Run, Pub/Sub, VPC, IAM и Secret Manager. CX Codex +1 2 300установок gcp-development Mindrally Скилл gcp-development для Claude Code и Codex. Задаёт рамки разработки под Google Cloud: Cloud Functions, Cloud Run, Firestore, BigQuery, Terraform и безопасность через IAM. CX Codex +1 986установок gcp-to-aws cline Скилл gcp-to-aws для Claude Code планирует перенос рабочих нагрузок из GCP в AWS, включая AI-приложения. Запускается по запросам о миграции сервисов, Terraform или AI-провайдера. CX Codex +1 842установок gcp-cloud-run aj-geddes Скилл gcp-cloud-run настраивает запуск контейнеров в Google Cloud Run через gcloud и Terraform. Пригодится при развёртывании микросервисов без возни с серверами. CX Codex +1 545установок terraform-gcp devops-skills Скилл terraform-gcp разворачивает инфраструктуру Google Cloud через Terraform. Настраивает провайдеры, модули VPC, кластеры GKE и базы Cloud SQL. CX Codex +1 431установок gcp-networking devops-skills Скилл gcp-networking помогает разворачивать сети в Google Cloud: настраивать VPC, правила межсетевого экрана, Cloud NAT, балансировщики и Private Service Connect через CLI и Terraform. CX Codex +1 389установок

Из того же набора17

Весь набор →
pre-publish-checker Скилл pre-publish-checker проверяет проект перед публикацией: ищет ругань, внутренние ссылки и пути, а затем помогает пройти ручную проверку качества. Пригодится перед открытым релизом кода или расширения. CX Codex +1 ★ 151звёзд репо safe-sre-investigator Скилл safe-sre-investigator заводит отдельные read-only сервисные аккаунты для GCP и Kubernetes и подсказывает команды gcloud/kubectl вместе с оценкой риска. CX Codex +1 ★ 151звёзд репо cloud-monitoring Скилл запрашивает метрики Google Cloud Monitoring через MCP, сжимает данные в CSV и рисует текстовые спарклайны без перегрузки контекста. CX Codex +1 ★ 151звёзд репо postmortem-aggregator Скилл postmortem-aggregator для Claude Code разбирает Post Mortem в папке, рассчитывает показатели сбоев и обновляет POMO_AGGREGATED.md. Помогает находить повторяющиеся причины инцидентов. CX Codex +1 ★ 151звёзд репо generic-mitigations Скилл generic-mitigations учит ИИ-агента купировать сбои в продакшене типовыми мерами SRE вместо долгих раскопок причин во время аварии. CX Codex +1 ★ 151звёзд репо monitoring-graphs Скилл monitoring-graphs для Claude Code, Codex и Gemini CLI генерирует аннотированные графики инцидентов на Python. Запускается, когда нужно визуализировать сбой, показать скачки ошибок или соотнести метрики с этапами инцидента. CX Codex +1 ★ 151звёзд репо anomaly-detection Скилл anomaly-detection находит аномалии во временных рядах из CSV, мониторинга облака и других источников. Автоматически выбирает алгоритм и параметры сглаживания, или работает по вашим настройкам. CX Codex +1 ★ 151звёзд репо investigation-entrypoint Скилл investigation-entrypoint расследования сбоев в Google Cloud Platform для Claude Code, Codex и Gemini CLI. Координирует диагностику GKE и Cloud Run при инцидентах. CX Codex +1 ★ 151звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой