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

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

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

为何要使用 Firebase 代理技能和工具？

通用 AI 模型通常难以应对特定的项目配置或过时的信息。此工具包弥合了这一差距：

• Firebase 代理技能：技能可为编码代理提供领域专业知识。它们提供最新文档和最佳工作流程，以便智能体了解 Firebase 建议的正确架构结构。
• Firebase MCP 服务器：MCP 服务器为编码代理提供上下文和访问权限。它为代理建立了一个标准协议，以便以编程方式检查您的有效项目资源、本地文件和配置。
• Firebase CLI：命令行界面可为编码代理提供可执行的操作。它是智能体用来执行繁重任务（例如初始化数据库、管理用户身份验证配置和代表您部署代码）的执行工具。

将 Firebase 代理技能与 Firebase CLI 和 Firebase MCP 服务器搭配使用，可为 AI 编码代理提供更多功能：

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

代理技能和工具可协助处理哪些 Firebase 服务？

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

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

如需查看完整列表，请浏览 Firebase 代理技能的完整列表。

常规工作流程

以下步骤介绍了如何使用 Firebase 代理技能在 Web 应用中设置和使用 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 v9 模块化 SDK 重写了它。”
• 请求说明：“说明这些 Firebase Security Rules 如何保护用户数据。”

执行前请先验证

AI 编码助理功能强大，但可能会出错或产生“幻觉”（错误地创建函数或服务名称）。

• 检查代码：在部署到生产环境之前，请务必仔细阅读生成的代码，尤其是 Firebase Security Rules 和配置文件（例如 firebase.json）。
• 在本地进行测试：尽可能让代理帮助您在本地测试更改，然后再将更改推送至正式版。

使用 MCP 连接

由于 Firebase MCP 服务器可让您的代理直接了解项目结构，因此您可以引用特定文件来获取量身定制的实现建议。

• 示例：“查看我的 src/web/index.html 文件，并告诉我应在何处添加标准 Firebase 初始化脚本。”

后续步骤

• 浏览所有可用的 Firebase 代理技能的完整列表。
• 浏览 Firebase MCP 服务器提供的所有可用提示、工具和资源的完整列表。
• 详细了解 Firebase CLI 提供的工具。