BigQuery 란, Google Cloud CLI 원격 MCP 서버로 AI 에이전트가 gcloud bq 명령 쓰는 법

AS-IS, 로컬 CLI 설치가 발목 잡던 구조

지금까지 AI 에이전트로 클라우드 인프라를 관리하려면 에이전트 실행 환경 안에 Google Cloud CLI 바이너리를 설치하고 유지보수해야 했어요. 개발, 테스트, 운영 환경마다 로컬 CLI 버전과 의존성을 맞추는 일이 팀에는 꽤 번거로운 운영 부담이었습니다. 게다가 Gemini Enterprise 같은 웹 기반 에이전트 플랫폼은 사용자가 로컬 패키지를 설치하거나 제어할 수 없는 환경에서 돌아가기 때문에, 이런 곳에서는 CLI 접근 자체가 구조적으로 막혀 있었어요.

이번에 바뀐 것, 원격 MCP 서버로 CLI를 그대로 노출

Google Cloud CLI 원격 MCP 서버는 수백 개의 gcloud, bq 명령을 하나의 MCP 서버로 패키징해서 이 문제를 풉니다. 복잡한 다단계 API 오케스트레이션 대신 CLI 명령 하나로 검증까지 포함된 고수준 작업을 실행할 수 있고, LLM이 공개된 CLI 문서와 사용 예시로 이미 많이 훈련돼 있어서 명령 호출의 정확도도 높다고 해요. 인증은 Agent Identity, OAuth 2.0, IAM으로 처리되고, 모든 명령은 인증된 호출자 신원의 권한으로만 실행됩니다. 여기에 Model Armor가 프롬프트 인젝션 같은 위험 입력을 사전에 걸러주고, 모든 도구 호출은 Audit Logs(cloudcli.googleapis.com/mcp의 Data Access 로그)에 기록돼서 보안팀이 호출자 신원과 IAM 권한 판단 내역을 민감한 명령 페이로드나 PII 노출 없이 확인할 수 있어요.

BigQuery 운영에서 뭐가 달라지나

run_bq_command 도구는 기존 BigQuery MCP 서버가 데이터 분석과 탐색에 집중했던 것과 달리, bq CLI의 전체 기능 범위를 열어서 더 고급 운영 작업을 다룹니다. 원문에서 제시한 핵심 기능은 세 가지예요. BigQuery Data Transfer Service 설정으로 예약 쿼리를 자동 실행하는 것, 처리된 데이터량이나 슬롯 사용량, 실행 계획 같은 작업 세부 정보를 들여다보고 예약(reservation)을 관리하는 것, 그리고 데이터 관리자가 에이전트를 통해 테이블 권한을 직접 조회하고 수정하는 것입니다. run_gcloud_command는 인프라 관리와 장애 진단 쪽에 쓰이는데, 원문은 에이전트가 명령 실행을 자동화하고 도구 간 컨텍스트 전환을 줄여 장애 진단을 단순화하는 예시를 들고 있어요.

실무 적용 체크리스트

도입은 세 단계로 요약됩니다. Google Cloud 프로젝트에서 Cloud CLI Execution API(cloudcli.googleapis.com)를 활성화하고, 에이전트나 사용자 신원에 MCP Tool User(roles/mcp.toolUser) IAM 역할을 부여한 다음, MCP 클라이언트를 cloudcli.googleapis.com/mcp에 연결하면 됩니다. MCP 서버 자체 사용료는 따로 없고 생성한 GCP 리소스 비용과 데이터 전송 비용만 지불하면 돼요. 다만 에이전트가 인증된 호출자 권한 그대로 명령을 실행하기 때문에, 도입 전에 IAM 권한 범위와 조직 정책 제약을 먼저 점검해두는 게 안전합니다.

자주 묻는 질문

bigquery 란 무엇인가요

Google Cloud의 완전관리형 데이터 웨어하우스 서비스로, 대용량 데이터를 SQL로 분석하는 데 쓰입니다. 이번 발표는 BigQuery 자체 기능이 아니라 bq 명령줄 도구를 AI 에이전트가 원격으로 호출하게 해주는 MCP 서버에 관한 내용이에요.

agentic ai와 ai agent 차이는 뭔가요

이번 원문에서 직접 구분하지는 않지만, 이번 발표는 AI 에이전트가 run_gcloud_command, run_bq_command 같은 도구로 실제 인프라 작업을 스스로 수행하게 만드는 사례에 해당합니다.

로컬에 gcloud나 bq CLI를 설치해야 하나요

아니요. 원격 MCP 서버가 네트워크로 격리된 클라우드 샌드박스에서 명령을 실행하기 때문에 에이전트 실행 환경에 CLI 바이너리를 설치하거나 유지보수할 필요가 없습니다.

보안은 어떻게 관리되나요

인증은 Agent Identity, OAuth 2.0, IAM으로 처리되고 모든 명령은 호출자 신원의 권한으로만 실행됩니다. Model Armor가 프롬프트 인젝션 위험을 사전 차단하고, 모든 호출은 Audit Logs에 기록돼 보안팀이 확인할 수 있어요.