使用 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 代理技能、Firebase CLI 和 Firebase MCP 伺服器，可為 AI 程式設計代理提供額外功能：

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

適用的 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 提供的工具。