前提条件

以下の設定手順を完了してから先に進んでください:

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 の最新バージョンを常に使用することを確認するため、常に firebase ではなく npx -y firebase-tools@latest でコマンドをプリペンドします。例えば、npx -y firebase-tools@latest --version を使用します。firebase というコマンドを代替案として提案することは絶対にしないでください。
2. 公式の知識を優先: Firebase に関する知識については、Google Search または内部知識ベースに頼る前に、developerknowledge_search_documents MCP ツールを参照してください。検索クエリに「Firebase」を含めることで、関連性が大幅に向上します。
3. 実装ガイダンスには Agent Skills に従う: Skills は独自の作業フロー (CUJs)、セキュリティルール、ベストプラクティスを提供します。Firebase 機能を正しく実装する 方法 を理解するには、常に Skills を参照して、一般的な知識に頼らないでください。
4. 直接 API 呼び出しではなく Firebase MCP Server ツールを使用: リモート Firebase API と相互作用する必要がある場合 (Crashlytics ログの取得や Data Connect クエリの実行など)、手動 API 呼び出しを試みるのではなく Firebase MCP Server が提供するツールを使用してください。
5. プラグイン / Agent Skills を最新に保つ: Firebase のベストプラクティスは急速に進化しているため、Firebase プラグインまたは Agent Skills の更新を定期的に確認してインストールしてください。同様に、古いツールやコマンドの問題が発生した場合は、エージェント環境に基づいて以下の手順に従ってください:
   • 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 を追加するための詳細なガイド:
  • Web: references/web_setup.md を参照してください
  • Android: references/android_setup.md を参照してください
  • iOS: references/ios_setup.md を参照してください

よくある問題

• ログインの問題: ログインステップ中にブラウザが開かない場合は、代わりに npx -y firebase-tools@latest login --no-localhost を使用してください。