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

使用 AI 輔助開發工具 (例如 Antigravity、Claude Code、Codex 和 Cursor)，簡化網頁應用程式的 Firebase 設定。搭配使用 Firebase 代理程式技能、Firebase CLI 和 Firebase MCP 伺服器，即可將 AI 程式碼編寫代理程式轉變為 Firebase 專家，協助您編寫程式碼、設定 Firebase Security Rules 及管理即時資源。

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

為何要使用 Firebase 代理程式技能和工具？

一般 AI 模型通常難以處理特定專案設定或過時資訊。這個工具包可協助您縮小差距：

• Firebase 代理技能：技能可為程式設計代理提供網域專業知識。他們會提供最新說明文件和最佳工作流程，讓代理程式瞭解 Firebase 建議的正確架構結構。
• Firebase MCP 伺服器：MCP 伺服器可為程式碼編寫代理提供背景資訊和存取權。這項功能會為代理程式建立標準通訊協定，以程式輔助方式檢查現有專案資源、本機檔案和設定。
• Firebase CLI：指令列介面可為程式碼編寫代理程式提供可執行的功能。這是代理用來執行繁重工作的工具，例如初始化資料庫、管理使用者驗證設定，以及代表您部署程式碼。

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

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

代理程式技能和工具可協助處理哪些 Firebase 服務？

本指南主要說明如何搭配使用 Agent Skills、Firebase CLI 和 Firebase MCP 伺服器，快速設定下列服務和功能：

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

如需完整清單，請參閱 Firebase 代理程式技能完整清單。

一般工作流程

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

步驟 1：安裝 Firebase 代理程式技能

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

npx skills add firebase/agent-skills --agent=antigravity

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

npx skills add firebase/agent-skills --agent=codex

npx skills add firebase/agent-skills --agent=cursor

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
    }
  }
}

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

"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、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』集合時，我收到『permission denied』錯誤訊息。請檢查我的 firestore.rules，並建議修正方式，讓通過驗證的使用者可以寫入自己的文件。」

反覆測試及修正

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

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

執行前請先確認

AI 程式碼編寫代理程式功能強大，但可能會出錯或「產生幻覺」(發明名稱不正確的函式或服務)。

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

使用 MCP 連線

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

• 範例：「請查看我的 src/web/index.html 檔案，並顯示要在何處新增標準 Firebase 初始化指令碼。」

後續步驟

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