使用 AI 輔助功能整合 Firebase 服務

使用 Antigravity、Claude Code、Codex 和 Cursor 等 AI 輔助開發工具，簡化網頁應用程式的 Firebase 設定。只要將 Firebase 代理技能與 Firebase CLI 和 Firebase MCP 伺服器搭配使用，就能將 AI 程式設計代理轉變為專門的 Firebase 專家，可編寫程式碼、設定 Firebase Security Rules 及管理實際資源。

本指南說明如何使用 AI 程式碼編寫代理，協助設定Cloud Firestore、Firebase Authentication和Firebase Hosting，以用於網頁應用程式。iOS、Android 和 Flutter 應用程式的相關資訊即將推出，敬請期待！

為什麼要使用 Firebase 代理技能和工具？

AI 程式設計代理通常難以處理特定專案設定或過時資訊。這個工具包結合了專門的指令 (代理技能) 和兩種互補的代理程式執行工具 (CLI 和 MCP 伺服器)，填補了這項落差：

• Firebase 代理技能：為程式設計代理程式提供網域專業知識和工作流程。技能是指令層，可引導代理採用最佳做法來使用 Firebase，包括編寫程式碼。技能也會教導代理何時及如何使用 Firebase CLI 和 Firebase MCP 伺服器。
• 代理執行工具：
  • Firebase CLI (指令列工具)：提供專案生命週期和環境工作工具。代理程式可以在終端機環境中執行 CLI 指令，在 Firebase 專案中設定服務、部署完整網站或後端資源、啟動本機模擬器等。
  • Firebase MCP 伺服器 (程式輔助工具和資源)：提供即時檢查和資料作業工具。透過結構化工具呼叫，代理可以程式輔助方式查詢及更新 Cloud Firestore 文件、管理 Firebase Authentication 使用者、驗證 Security Rules、直接將即時記錄或說明文件提取至內容等。

搭配 Firebase CLI 和 Firebase MCP 伺服器使用 Firebase 代理程式技能，可為 AI 程式設計代理程式提供額外功能：

• 採取行動：除了編寫程式碼，您的代理程式可以初始化服務、管理使用者、部署新 Firebase Security Rules，以及直接處理 Cloud Firestore 資料。Firebase Authentication
• 掌握最新資訊：使用官方提供的版本感知提示，引導代理程式完成設定工作。
• 提升準確度：存取專案的環境和結構定義，提供更相關且準確的協助。
• 降低權杖成本：代理技能只會在特定工作需要時載入詳細說明文件，盡可能減少工作階段負擔。

適用的 Firebase 服務

本指南主要說明代理技能、Firebase CLI 和 Firebase MCP 伺服器如何搭配運作，協助您快速設定下列服務和功能：

• Cloud Firestore：佈建 NoSQL 資料庫。
• Firebase Authentication：設定安全的使用者登入機制。
• Firebase Security Rules：為應用程式生成及調整 Security Rules。
• Firebase Hosting：設定專案，以便部署靜態網頁應用程式。

如需完整清單，請瀏覽 Firebase 代理技能完整清單。

一般工作流程

下列步驟說明一般工作流程，說明如何使用 Firebase 代理技能，在網頁應用程式中設定及使用 Firebase 服務。在幕後，代理技能會使用 Firebase CLI 和 Firebase MCP 伺服器完成這些工作。

步驟 1：安裝 Firebase 代理技能

在大多數情況下，您可以在偏好的編輯器中，使用單一提示安裝 Firebase 代理技能：

claude plugin marketplace add firebase/agent-skills
claude plugin install firebase@firebase

npx skills add firebase/agent-skills

步驟 2：連線至 Firebase MCP 伺服器

雖然許多 Firebase 代理技能會使用 Firebase CLI 執行工作，但我們也建議將 AI 程式設計代理連結至 Firebase MCP 伺服器。這項連結可強化代理與 Firebase 環境互動的能力，提供更深入的整合和存取權。

AI 輔助方法

在多數情況下，您可以要求 AI 程式設計代理設定 Firebase MCP 伺服器。不過，如果系統無法順利執行，或您未看到 Firebase MCP 伺服器，請改用手動方法。

手動方法

{
  "mcpServers": {
    "firebase-mcp-server": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"],
      "disabled": false
    }
  }
}

"servers": {
  "firebase": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

"mcp": {
  "servers": {
    "firebase": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

步驟 3：初始化 Firebase 服務

設定好代理技能和工具後，您現在可以使用自然語言，讓 AI 程式設計代理設定 Cloud Firestore、Firebase Authentication 和 Firebase Hosting。

1. 要求代理設定服務。例如，你可以使用以下提示：

   • 將 Cloud Firestore 設為這個應用程式的資料庫。
   • 使用 Authentication 建立登入頁面，並更新 Security Rules，確保只有授權使用者可以讀取及寫入自己的資料。
   • 設定 Firebase Hosting，然後將應用程式部署至正式環境。

2. 查看代理可能提供的資訊，並按照逐步指南操作，例如：

   1. 計畫：代理會根據現有的程式碼集提出策略。
   2. 連線：代理會將本機程式碼連結至現有的 Firebase 專案，或協助您建立新的 Firebase 專案。
   3. 初始化資源：代理程式會在程式碼集新增必要的 Firebase 程式庫和設定。
   4. 更新檔案：代理程式會建立及更新所有必要檔案，例如 firestore.rules (定義資料庫中可讀取、寫入或查詢資料的使用者)，或 firebase.json (告知 Firebase CLI 要部署哪些服務，以及如何設定這些服務)。
   5. 執行：代理程式會引導您完成其他設定或部署步驟。

提示 AI 程式設計代理的一般訣竅

如要充分發揮 AI 程式設計代理的效益，尤其是在處理 Firebase 等多面向整合時，請將互動視為協作，而非單次指令。

提供具體資訊和背景資訊

雖然 Firebase MCP 伺服器會提供專案的重要背景資訊，但使用明確具體的自然語言提示，仍可獲得最佳結果。避免模糊不清的要求。

• 模糊：「修正資料庫錯誤。」
• 具體：「嘗試寫入 Cloud Firestore 中的『users』集合時，出現『權限遭拒』錯誤。請查看我的 firestore.rules，並建議修正方式，讓通過驗證的使用者可以寫入自己的文件。」

反覆測試及修正

AI 程式設計代理在處理複雜工作時，很少能一次就生成完美的程式碼。如果答案不太正確，請繼續對話：

• 提供錯誤訊息：將任何終端機錯誤或控制台記錄貼回對話。
• 要求調整：「該程式碼使用舊版 v8 SDK。請使用 Firebase v9 模組化 SDK 改寫。」
• 要求說明：「說明這些 Firebase Security Rules 如何保護使用者資料。」

執行前請先驗證

AI 程式碼代理雖然功能強大，但仍可能犯錯或「產生幻覺」(發明名稱錯誤的函式或服務)。

• 檢查程式碼：部署至正式環境前，請務必詳閱生成的程式碼，尤其是 Firebase Security Rules 和設定檔 (例如 firebase.json)。
• 在本機測試：盡可能請代理程式協助您在本機測試變更，再將變更推送至正式環境。

使用 MCP 連線

由於 Firebase MCP 伺服器可讓代理直接查看專案結構，因此您可以參考特定檔案，取得量身打造的實作建議。

• 範例：「查看我的 src/web/index.html 檔案，並指出應在何處加入標準 Firebase 初始化指令碼。」

後續步驟

• 瀏覽所有可用的 Firebase 代理技能完整清單。
• 瀏覽 Firebase MCP 伺服器提供的所有可用提示、工具和資源完整清單。
• 進一步瞭解 Firebase CLI 提供的工具。