Claude가 Firebase · GCP를 직접 조작하게 하는 MCP 세팅 가이드

이 글을 읽고 나면 Claude에게 "Firebase 프로젝트 만들어줘", "Cloud Functions 배포해줘"라고 말만 해도 AI가 직접 실행해줍니다.

이 세팅이 왜 필요한가?

기본 Claude Code는 내 PC의 파일만 다룰 수 있습니다. Firebase 콘솔에 접속하거나, Cloud Functions를 배포하거나, Firestore 데이터를 읽는 것은 기본적으로 Claude가 할 수 없어요.

MCP(Model Context Protocol) 를 연결하면 달라집니다.

MCP 세팅 전:  Claude ↔ 내 PC 파일만
MCP 세팅 후:  Claude ↔ 내 PC + Firebase + GCP + 기타 서비스

한 번 세팅해두면 이후엔 말로 지시만 하면 됩니다.

나:  "Firebase 프로젝트 새로 만들고 Firestore랑 Hosting 켜줘"
Claude: (자동으로 프로젝트 생성 + 서비스 활성화)

나:  "방금 만든 프로젝트에 배포까지 해줘"
Claude: (코드 빌드 + Firebase Hosting 배포)

전체 흐름

1. CLI 도구 설치    (firebase, gcloud)
2. CLI 로그인       (내 구글 계정 인증)
3. MCP 등록         (Claude에 연결)
4. 완료

PART 1. Firebase MCP 세팅

1단계. Node.js 설치

Firebase CLI는 Node.js 위에서 동작합니다. 먼저 설치 여부를 확인하세요.

node --version

버전이 나오면 이미 설치된 것. 없다면 https://nodejs.org 에서 LTS 버전 다운로드 후 설치.

2단계. Firebase CLI 설치

Mac / Windows 공통

npm install -g firebase-tools

설치 확인:

firebase --version

3단계. Firebase 로그인

firebase login

브라우저가 열리면서 구글 계정 로그인 화면이 나옵니다. Firebase를 사용할 계정으로 로그인.

로그인 확인:

firebase projects:list

내 Firebase 프로젝트 목록이 나오면 성공.

⚠️ 회사/학교 계정은 조직 정책으로 막힐 수 있습니다. 가능하면 개인 구글 계정을 사용하세요.

브라우저가 열리지 않는다면:

firebase login --no-localhost

4단계. Claude에 Firebase MCP 등록

claude mcp add firebase -- firebase mcp

등록 확인:

claude mcp list

firebase: firebase mcp - ✓ Connected 가 나오면 완료.

Firebase MCP로 할 수 있는 것

지시 예시	Claude가 하는 일
"Firebase 프로젝트 새로 만들어줘"	프로젝트 생성
"Firestore에서 users 컬렉션 읽어줘"	데이터 조회
"보안 규칙 업데이트하고 배포해줘"	규칙 수정 + 배포
"Functions 배포해줘"	빌드 + 배포 자동화
"Firebase Hosting에 올려줘"	호스팅 배포

PART 2. Google Cloud MCP 세팅

Cloud Run, Cloud Functions, IAM, Storage 등 GCP 전체 서비스를 Claude가 직접 조작할 수 있게 됩니다.

1단계. Google Cloud CLI (gcloud) 설치

Mac

brew install --cask google-cloud-sdk

Homebrew가 없다면 먼저:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Windows

👉 https://cloud.google.com/sdk/docs/install 에서 Windows 인스톨러 다운로드 후 실행

설치 확인:

gcloud --version

2단계. Google Cloud 로그인 (2가지 모두 실행)

① CLI 명령어용 인증

gcloud auth login

② 애플리케이션/SDK 호출용 인증

gcloud auth application-default login

두 가지를 모두 실행해야 합니다. 하나는 터미널 명령어용, 다른 하나는 코드에서 Google API를 호출할 때 사용됩니다.

로그인 확인:

gcloud auth list

내 계정 이메일 옆에 * 표시가 있으면 성공.

3단계. 기본 프로젝트 설정 (선택)

자주 쓰는 GCP 프로젝트가 있다면 기본값으로 설정해두면 편합니다.

gcloud config set project [프로젝트ID]

4단계. Claude에 Google Cloud MCP 등록

claude mcp add gcloud-mcp -- npx -y @google-cloud/gcloud-mcp

등록 확인:

claude mcp list

gcloud-mcp: ... - ✓ Connected 가 나오면 완료.

Google Cloud MCP로 할 수 있는 것

지시 예시	Claude가 하는 일
"Cloud Run에 배포해줘"	컨테이너 빌드 + 배포
"Cloud Functions 목록 보여줘"	함수 목록 조회
"Cloud Storage 버킷 만들어줘"	스토리지 생성
"IAM 권한 확인해줘"	접근 권한 조회

트러블슈팅

gcloud 명령어를 못 찾을 때 (Mac)

echo 'export PATH=$PATH:/usr/local/Caskroom/google-cloud-sdk/latest/google-cloud-sdk/bin' >> ~/.zshrc
source ~/.zshrc

MCP 연결이 Failed로 나올 때

Claude Code를 완전히 종료 후 재시작하고 다시 확인. 그래도 안 되면:

claude mcp remove firebase
claude mcp add firebase -- firebase mcp

Windows에서 npx 명령어가 안 될 때

node --version
npm --version

없다면 Node.js 재설치 후 PowerShell 재시작.

세팅 체크리스트

Firebase만 쓸 경우

Node.js 설치
npm install -g firebase-tools
firebase login
claude mcp add firebase -- firebase mcp

GCP까지 쓸 경우 (위에 추가로)

gcloud CLI 설치
gcloud auth login
gcloud auth application-default login
claude mcp add gcloud-mcp -- npx -y @google-cloud/gcloud-mcp

핵심 원리 한 줄 요약

CLI 로그인 + MCP 등록 — 이 두 가지만 하면 Claude가 Firebase와 GCP를 내 대신 조작합니다.