Firebase CLI 基本設定 (Website)

前提条件

以下のセットアップ手順を完了してから進めてください。

1. ローカル環境のセットアップ: Firebase ツールを使用できるように環境が正しく設定されていることを確認します。

   • npx -y firebase-tools@latest --version を実行して、Firebase CLI がインストールされているか確認します。
   • 既存のツールを使用して、Firebase MCP サーバーがインストールされているか確認します。
   • 重要: 以下の拡張機能やエージェント環境を設定する前に、必ず references/local-env-setup.md をお読みください。
   • このステップをスキップしないでください: 利用可能な Firebase スキルが 'firebase-basics' のみの場合、エージェント環境のリファレンスに従って 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 検索や内部知識ベースに頼る前に、developerknowledge_search_documents MCP ツールを参照してください。検索クエリに「Firebase」を含めると、関連性が大幅に向上します。
3. 実装ガイダンスにはエージェントスキルに従う: スキルは、意見が反映されたワークフロー（CUJ）、セキュリティルール、ベストプラクティスを提供します。Firebase 機能を正しく実装する方法を理解するために、一般的な知識に頼らず、常にスキルを参照してください。
4. 直接 API 呼び出しではなく Firebase MCP サーバーツールを使用する: リモートの Firebase API とやり取りする必要がある場合（Crashlytics ログの取得や Data Connect クエリの実行など）、手動で 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 をアプリに追加するための詳細なガイド:
  • Web: 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