gcloud MCP Server의 개요
Google의 googleapis 조직이 만든 gcloud MCP 서버는 에이전트에게 도구 하나, run_gcloud_command를 줍니다. 이 도구는 모델이 넘긴 인수 목록으로 사용자 컴퓨터에 설치된 gcloud CLI를 실행합니다. 호출할 때마다 먼저 gcloud에 명령을 파싱하게 하고, 명령 그룹을 접근 제어 목록과 대조한 뒤, 셸 없이 gcloud 바이너리를 직접 실행합니다. 그래서 파이프, 리디렉션, 명령 연결은 실패합니다. 같은 저장소에는 관측성, Cloud Storage, Backup and DR용 서버도 따로 있습니다.
자체 자격 증명은 없습니다. 모든 호출은 활성 gcloud 계정으로 실행되므로, gcloud auth login이나 활성화된 서비스 계정 키가 허용하는 것을 그대로 물려받습니다. README는 좁은 IAM 역할을 가진 서비스 계정 가장(impersonation)을 권장합니다. 항목 10개로 된 기본 차단 목록이 항상 적용되며, 대부분 SSH와 터널링 명령, 그리고 gcloud interactive와 gcloud meta입니다. -c로 넘기는 JSON 파일로 허용 목록이나 차단 목록 중 하나를 추가할 수 있고, 둘을 함께 쓸 수는 없습니다.
저장소는 Apache-2.0 라이선스이며 GitHub 스타는 약 940개입니다. @google-cloud/gcloud-mcp는 2026년 10월 26일까지 한 달 동안 약 212,000회 내려받아졌습니다. Google은 이를 공식 지원 제품이 아니며 Google Cloud 서비스 약관의 적용을 받지 않는 프리뷰로 표시합니다. 마지막 gcloud-mcp 릴리스 0.5.3은 2026년 1월 5일에 나왔고, 그 뒤의 변경은 의존성 업데이트입니다.
gcloud MCP Server 설치 방법
npx -y @google-cloud/gcloud-mcpgcloud MCP Server, 쓸 만한 가치가 있습니까?
이 서버는 모델과 gcloud 사이에 거의 아무것도 두지 않습니다. 그것이 장점이자 위험입니다. 기본 설정에서 일반 개발자 계정으로 실행되는 에이전트는 프로젝트, Compute Engine 인스턴스, Cloud SQL 데이터베이스를 삭제하고, IAM 정책을 다시 쓰고, 서비스 계정 키를 만들 수 있습니다. 내장된 차단은 피해가 아니라 대화형 세션을 막으려고 고른 명령 그룹 10개뿐이기 때문입니다. README도 차단 목록을 그렇게 설명합니다. 위험한 명령이 아니라 에이전트에게 의미가 없는 명령을 뺀다는 것입니다.
가장 중요한 빈틈은 자격 증명입니다. gcloud auth print-access-token과 그 application-default 및 identity-token 변형은 기본 차단 목록에 없습니다. 그래서 에이전트, 또는 에이전트가 읽은 리소스 설명을 통해 주입된 프롬프트가 유효한 액세스 토큰을 모델의 컨텍스트에 출력할 수 있습니다. 이들을 차단 목록에 추가하는 풀 리퀘스트(#419)는 2026년 5월 6일부터 열려 있습니다. 병합될 때까지는 자체 차단 파일에 이 명령들을 넣으십시오. gcloud config로 설정한 가장도 확실한 경계가 아닙니다. config 명령이 허용되어 있어 에이전트가 설정을 해제할 수 있기 때문입니다. 서비스 계정 자체를 활성화하거나 config 그룹을 차단하면 이 문제가 막힙니다.
써야 할 기능은 허용 목록입니다. {"allow": ["compute instances list", "logging read"]} 같은 파일은 에이전트를 지정한 그룹이나 정확한 명령으로 제한합니다. 규칙은 릴리스 트랙에 대해 정밀합니다. beta storage를 허용해도 GA storage는 허용되지 않으며, GA 명령을 차단하면 그 alpha와 beta 형태도 차단됩니다. 명령 파싱은 문자열 비교가 아니라 gcloud 자체 린터를 거치므로, 플래그 순서를 바꾸는 식으로 검사를 피하기가 더 어렵습니다.
여기에는 BigQuery 비용 보호가 없습니다. BigQuery 쿼리 도구가 없기 때문입니다. 서버는 gcloud 바이너리만 실행하며, 문서에는 시험 실행이나 바이트 제한에 대한 언급이 없습니다. 온디맨드 BigQuery 쿼리는 월 1 TiB 무료 이후 스캔한 TiB당 $6.25가 과금되며, 설정해야 할 통제 수단은 여전히 BigQuery 자체의 프로젝트 단위 할당량과 최대 청구 바이트 설정입니다. BigQuery, AlloyDB, Cloud SQL에 SQL을 실행하려면 Google의 MCP Toolbox for Databases가 더 맞습니다. 열린 명령줄 대신 이름이 붙은 매개변수화 쿼리를 씁니다. gcloud-mcp는 그 데이터베이스들을 둘러싼 컨트롤 플레인을 위한 도구입니다.
제 역할을 하는 곳
Google Cloud를 쓰는 20인 스타트업의 플랫폼 엔지니어
Cloud Run 서비스가 왜 500 오류를 돌려주는지, 무엇이 바뀌었는지 묻기
viewer 역할만 가진 서비스 계정으로, run services describe, run revisions list, logging read만 허용한 목록과 함께 gcloud-mcp를 실행합니다. 에이전트는 쓰기 경로 없이 리비전과 로그를 읽습니다. 서버는 무료이며, Cloud Logging 읽기는 평소대로 과금됩니다.
중견 소매업체의 FinOps 분석가
여러 프로젝트에 걸쳐 유휴 Compute Engine 디스크와 연결되지 않은 IP 주소 목록 만들기
--filter와 --format 프로젝션을 붙인 compute disks list, compute addresses list 같은 목록 명령은 필요한 필드만 돌려주므로 출력이 작게 유지됩니다. 목록 명령만 허용하면 에이전트는 보고만 하고 삭제는 하지 못하므로, 정리 결정은 사람에게 남습니다.
규제를 받는 Google Cloud 조직에서 에이전트 허용 여부를 검토하는 보안 엔지니어
개발자 노트북의 에이전트가 개발자의 gcloud 로그인으로 무엇을 할 수 있는지 판단하기
기본 상태에서는 그 로그인이 할 수 있는 모든 것을 할 수 있으며, 액세스 토큰 출력도 포함됩니다. Google은 이에 대한 지원 계약을 제공하지 않습니다. 클라이언트 설정과 함께 배포하는 허용 목록 파일, 그리고 읽기 전용 서비스 계정 가장이 승인 전 최소 조건입니다.
도입 전 확인할 점
- 설정
- Node.js 20 이상과 인증된 gcloud CLI가 필요합니다. npx @google-cloud/gcloud-mcp init --agent=gemini-cli는 Gemini CLI 확장으로 설치합니다. Claude Desktop, Cursor, Cline, VS Code에서는 MCP 설정에 npx -y @google-cloud/gcloud-mcp를 추가합니다. -c 플래그는 허용 또는 차단 JSON 파일의 절대 경로를 받습니다.
- 연동
- 도구 하나, run_gcloud_command가 읽기와 쓰기를 가리지 않고 gcloud가 다루는 모든 것을 다룹니다. 같은 저장소에 storage-mcp(기본은 읽기 전용과 생성 전용이며, 삭제는 --enable-destructive-tools 뒤에 있음), observability-mcp(Application Default Credentials로 로그, 메트릭, 트레이스), backupdr-mcp 서버가 따로 있습니다. stdio 전용이며 HTTP 전송은 없습니다.
- 데이터와 개인정보
- 활성 gcloud 계정으로 로컬에서 실행되며 명령 출력을 모델에 돌려줍니다. gcloud가 출력할 수 있는 것은 모두 컨텍스트에 닿습니다. auth print 명령을 차단하지 않으면 액세스 토큰도 포함되며, 리소스 설명이나 로그 줄은 신뢰할 수 없는 텍스트입니다. 공개된 GitHub 보안 권고는 없습니다.
- 대규모 사용 시 비용
- 서버는 무료이며, 모든 명령은 평소대로 프로젝트에 과금됩니다. 비싼 실수는 호출량이 아니라 인스턴스나 GPU 생성 같은 쓰기이며, 서버에는 이를 제한하는 장치가 없습니다. 예산, 할당량, IAM이 막아야 합니다.
- 제한
- 호환성이 깨지는 변경이 있을 수 있는 프리뷰이며, Google Cloud 지원과 약관 밖에 있습니다. 자체적인 시험 실행, 승인 단계, 명령별 확인이 없습니다. 기본 차단 목록은 무시할 수 없으므로 SSH 기반 워크플로는 쓸 수 없습니다. 2026년 10월 28일 기준 issue 33개가 열려 있었습니다.
좋은 점
- 도구 하나로 gcloud가 다루는 거의 모든 Google Cloud 서비스에 닿습니다
- gcloud 자체 린터로 파싱한 명령 그룹 단위 허용 목록 또는 차단 목록
- 셸이 없어서 파이프, 명령 연결, 치환이 실패합니다
- 기존 gcloud 자격 증명과 IAM을 쓰므로 새로 준비할 것이 없습니다
아쉬운 점
- 기본 차단 목록은 삭제가 아니라 SSH와 대화형 명령을 막습니다
- print-access-token 명령이 기본으로 차단되지 않습니다
- 공식 지원 Google 제품이 아닌 프리뷰입니다
- 2026년 1월 이후 gcloud-mcp 릴리스가 없습니다
추천 대상
에이전트가 gcloud로 리소스를 살펴보고 운영하기를 원하며, 허용 목록과 좁은 권한의 서비스 계정으로 묶어 둘 Google Cloud 엔지니어입니다.
gcloud MCP Server 대안
gcloud MCP Server: 자주 묻는 질문
- gcloud MCP Server, 쓸 만한 가치가 있습니까?
- gcloud를 얇고 정직하게 감싼 서버로, 뒤에 있는 계정만큼만 안전합니다. 대부분의 개발자에게 이는 허용 목록을 추가하기 전까지 권한이 지나치게 크다는 뜻입니다. 평점은 5점 만점에 3.5점입니다.
- gcloud MCP Server의 가격은 얼마입니까?
- 무료이며 Apache-2.0 라이선스입니다. 모든 명령은 직접 입력한 것과 똑같이 Google Cloud 프로젝트에 과금됩니다.
- gcloud MCP Server의 단점은 무엇입니까?
- 기본 차단 목록은 삭제가 아니라 SSH와 대화형 명령을 막습니다; print-access-token 명령이 기본으로 차단되지 않습니다; 공식 지원 Google 제품이 아닌 프리뷰입니다; 2026년 1월 이후 gcloud-mcp 릴리스가 없습니다.
- gcloud MCP Server에 적합한 사람은 누구입니까?
- 에이전트가 gcloud로 리소스를 살펴보고 운영하기를 원하며, 허용 목록과 좁은 권한의 서비스 계정으로 묶어 둘 Google Cloud 엔지니어입니다.
- 팀이나 프로덕션 환경에서 gcloud MCP Server의 비용은 얼마입니까?
- 서버는 무료이며, 모든 명령은 평소대로 프로젝트에 과금됩니다. 비싼 실수는 호출량이 아니라 인스턴스나 GPU 생성 같은 쓰기이며, 서버에는 이를 제한하는 장치가 없습니다. 예산, 할당량, IAM이 막아야 합니다.
- gcloud MCP Server에 회사 데이터를 맡겨도 안전합니까?
- 활성 gcloud 계정으로 로컬에서 실행되며 명령 출력을 모델에 돌려줍니다. gcloud가 출력할 수 있는 것은 모두 컨텍스트에 닿습니다. auth print 명령을 차단하지 않으면 액세스 토큰도 포함되며, 리소스 설명이나 로그 줄은 신뢰할 수 없는 텍스트입니다. 공개된 GitHub 보안 권고는 없습니다.
- gcloud MCP Server의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 MCP Toolbox for Databases, AWS MCP Server, Azure MCP Server 및 Terraform MCP Server입니다.
답변 확인일: 2026년 10월 28일.