使用 AI 辅助功能集成 Firebase 服务

借助 AI 赋能的开发 工具（例如 Antigravity、Claude Code、Codex 和 Cursor），简化 Web 应用的 Firebase 设置。通过将 Firebase 智能体 skill 与 Firebase CLI 和 Firebase MCP 服务器 搭配使用，您可以将 AI 编码代理转变为专业的 Firebase 专家，他们可以编写代码、配置 Firebase Security Rules 和管理实时资源。

本指南介绍了如何使用 AI 编码代理来帮助设置 Cloud Firestore, Firebase Authentication 和 Firebase Hosting，以用于 Web 应用。 请稍后回来查看有关 iOS、Android 和 Flutter 应用的信息！

为什么要使用 Firebase 智能体 skill 和工具？

AI 编码代理通常难以处理特定的项目配置或过时的信息。此工具包通过将专用说明（代理技能）与两种互补的代理执行工具（CLI 和 MCP 服务器）相结合，弥合了这一差距：

• Firebase 代理技能：为 编码代理提供领域专业知识和工作流。作为说明层，技能会指导代理了解使用 Firebase 的最佳实践，包括编写代码。技能还会教代理 何时 以及 如何 使用 Firebase CLI 和 Firebase MCP 服务器。
• 代理执行工具:
  • Firebase CLI （命令行工具）： 提供用于项目生命周期和环境任务的工具。代理可以在终端环境中运行 CLI 命令，以在 Firebase 项目中设置服务、部署完整网站或后端资源、启动本地模拟器等。
  • Firebase MCP 服务器 （程序化工具和资源）： 提供用于 实时检查和数据操作 的工具。通过 结构化工具调用，代理可以以编程方式查询和更新 Cloud Firestore文档、管理Firebase Authentication用户、验证 Security Rules、将实时日志或文档直接拉取到上下文中 等。

将 Firebase 智能体 skill 与 Firebase CLI 和 Firebase MCP 服务器搭配使用，可为 AI 编码代理提供额外的能力：

• 采取行动：不仅限于编写代码。您的代理可以初始化 服务、管理 Firebase Authentication 用户、部署新的 Firebase Security Rules，并直接处理您的 Cloud Firestore 数据。
• 保持最新状态：使用官方的、版本感知的提示来指导代理 完成设置任务。
• 提高准确性：访问项目的环境和架构，以提供 更相关、更准确的帮助。
• 降低 token 费用：代理技能仅在 特定任务需要时才加载详细文档，从而最大限度地减少会话开销。

适用的 Firebase 服务

本指南主要介绍代理技能、Firebase CLI 和 Firebase MCP 服务器如何协同工作，以帮助您快速设置以下服务和 功能：

• Cloud Firestore：预配 NoSQL 数据库。
• Firebase Authentication：设置安全的用户登录。
• Firebase Security Rules：为您的应用生成和优化 Security Rules。
• Firebase Hosting：为静态 Web 应用部署设置项目。

如需查看可用内容的完整列表，请浏览 Firebase 智能体 skill 的完整列表。

常规工作流程

以下步骤介绍了如何使用 Firebase 代理技能在 Web 应用 中设置和使用 Firebase 服务的 通用 工作流程。在后台，代理技能使用 Firebase CLI 和 Firebase MCP 服务器 来完成这些任务。

第 1 步：安装 Firebase 智能体 skill

在大多数情况下，您只需使用一个提示即可在您惯用的编辑器中安装 Firebase 智能体 skill：

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

npx skills add firebase/agent-skills

第 2 步：连接到 Firebase MCP 服务器

虽然许多 Firebase 智能体 skill 都使用 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’集合时，我收到‘权限被拒绝’错误。Cloud Firestore请查看我的 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 智能体 skill 的完整列表。
• 浏览 Firebase MCP 服务器提供的所有可用提示、工具和资源的完整列表。
• 详细了解 Firebase CLI 提供的工具。