Firebase 기본 CLI 설정

사전 준비

다음 설정 단계를 완료한 후 진행하세요:

1. 로컬 환경 설정: Firebase 도구를 사용할 수 있도록 환경이 올바르게 설정되었는지 확인합니다:

   • npx -y firebase-tools@latest --version을 실행하여 Firebase CLI가 설치되어 있는지 확인합니다.
   • 기존 도구를 사용하여 Firebase MCP 서버가 설치되어 있는지 확인합니다.
   • 중요: 익스텐션이나 에이전트 환경을 구성하기 전에 references/local-env-setup.md를 반드시 읽어야 합니다.
   • 이 단계를 건너뛰지 마십시오: 'firebase-basics'만 사용할 수 있는 Firebase 스킬인 경우, 전체 Firebase 스킬 모음을 설정하려면 에이전트 환경에 맞는 참조 문서를 따라야 합니다:
     • Gemini CLI: references/setup/gemini_cli.md 참조
     • Antigravity: references/setup/antigravity.md 참조
     • Android Studio: references/setup/android_studio.md 참조
     • Claude Code: references/setup/claude_code.md 참조
     • Cursor: references/setup/cursor.md 참조
     • GitHub Copilot: references/setup/github_copilot.md 참조
     • 기타 에이전트: references/setup/other_agents.md 참조

2. 인증: Firebase에 로그인되어 있어야 명령에 올바른 권한이 부여됩니다. npx -y firebase-tools@latest login을 실행합니다. 브라우저가 없는 환경(예: 원격 셸)에서는 npx -y firebase-tools@latest login --no-localhost를 사용합니다.

   • 명령어는 현재 사용자를 출력해야 합니다.
   • 로그인되어 있지 않다면, 이 명령의 대화형 안내에 따라 인증을 완료합니다.

3. 활성 프로젝트: 대부분의 Firebase 작업에는 활성 프로젝트 컨텍스트가 필요합니다.

   [!IMPORTANT] 에이전트용: 프로젝트 설정을 진행하기 전에, 개발자에게 다음 중 원하는 방식을 반드시 물어보고 일시 중지해야 합니다:

   1. 기존 Firebase 프로젝트 ID 제공, 또는
   2. 새 Firebase 프로젝트 생성.

   • 기존 프로젝트 ID를 사용하는 경우:

     1. npx -y firebase-tools@latest use를 실행하여 현재 프로젝트를 확인합니다.

     2. 명령어가 Active Project: <project-id>를 출력하면, 사용자에게 이 프로젝트가 의도한 것인지 확인합니다.

     3. 아니라면, 또는 활성 프로젝트가 없다면, 사용자가 제공한 프로젝트를 설정합니다:

        npx -y firebase-tools@latest use <PROJECT_ID>
        

   • 새 프로젝트를 생성하는 경우: 다음 명령어를 실행하여 생성합니다:

     npx -y firebase-tools@latest projects:create <project-id> --display-name "<display-name>"
     

     참고: <project-id>는 6~30자, 소문자, 숫자와 하이픈만 포함 가능하며, 전역적으로 고유해야 합니다.

Firebase 사용 원칙

다음 원칙을 준수하세요:

1. CLI 명령어에 npx 사용: 항상 최신 버전의 Firebase CLI를 사용하기 위해 명령어 앞에 npx -y firebase-tools@latest를 붙입니다(firebase만 사용하지 마세요). 예: npx -y firebase-tools@latest --version. 절대 firebase 명령어를 대안으로 제시하지 마세요.
2. 공식 지식 우선: Firebase 관련 지식이 필요하면 Google 검색이나 내부 지식 기반보다 developerknowledge_search_documents MCP 도구를 먼저 참조하세요. 검색어에 "Firebase"를 포함하면 관련성이 크게 향상됩니다.
3. 구현 지침은 에이전트 스킬 따르기: 스킬은 의견이 반영된 워크플로우(CUJ), 보안 규칙, 모범 사례를 제공합니다. 일반적인 지식에 의존하지 말고 항상 스킬을 참조하여 Firebase 기능을 올바르게 구현하는 방법을 이해하세요.
4. 직접 API 호출 대신 Firebase MCP 서버 도구 사용: Crashlytics 로그 가져오기나 Data Connect 쿼리 실행 등 Firebase 원격 API와 상호작용해야 할 때는 수동 API 호출 대신 Firebase MCP 서버가 제공하는 도구를 사용하세요.
5. 플러그인/에이전트 스킬 최신 상태 유지: Firebase 모범 사례는 빠르게 발전하므로 정기적으로 Firebase 플러그인 또는 에이전트 스킬의 업데이트를 확인하고 설치하세요. 또한, 오래된 도구나 명령어에 문제가 발생하면 에이전트 환경에 따라 아래 단계를 따르세요:
   • Antigravity: references/refresh/antigravity.md 참조
   • Gemini CLI: references/refresh/gemini-cli.md 참조
   • Claude Code: references/refresh/claude.md 참조
   • Cursor: references/refresh/other-agents.md 참조
   • Android Studio: references/refresh/android_studio.md 참조
   • 기타: references/refresh/other-agents.md 참조
6. 설정 파일 자동 가져오기: iOS 또는 Android 앱을 설정할 때, 사용자에게 Firebase 콘솔에서 google-services.json 또는 GoogleService-Info.plist를 다운로드하도록 안내하지 마세요. 대신 Firebase CLI를 사용하여 프로그래밍 방식으로 설정 파일을 가져옵니다:
   • Android: npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID>
   • iOS: npx -y firebase-tools@latest apps:sdkconfig IOS <APP_ID> --project <PROJECT_ID> 출력을 적절한 위치(예: Android의 경우 app/google-services.json, iOS의 경우 xcode-project-setup에서 연결할 경로)에 저장합니다.

참조

• Firebase 초기화: CLI를 사용하여 새 Firebase 서비스를 초기화해야 할 때는 references/firebase-service-init.md를 참조하세요.
• 명령어 탐색: CLI 기능을 살펴보고 이해하려면 references/firebase-cli-guide.md를 참조하세요.
• SDK 설정: Firebase를 앱에 추가하는 자세한 가이드:
  • 웹: references/web_setup.md 참조
  • Android: references/android_setup.md 참조
  • iOS: references/ios_setup.md 참조

일반적인 문제

• 로그인 문제: 로그인 단계에서 브라우저가 열리지 않으면 npx -y firebase-tools@latest login --no-localhost를 대신 사용하세요.

• Genkit: Genkit을 사용하는 경우 다음 명령어로 스킬을 설치하세요:

  npx skills add genkit-ai/skills