在 Claude Code 中安装 Firebase Agent Skills 与 MCP 服务器（firebase-basics 实战指南）-开发者社区

在 Claude Code 中安装 Firebase Agent Skills 与 MCP 服务器（firebase-basics 实战指南）

【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills

本篇指南基于skills/cloud/firebase-basics技能的官方安装文档，完整讲解如何在 Claude Code 中通过插件市场（Plugin Marketplace）一次性安装 Firebase 的 Agent Skills 与 Firebase MCP 服务器，并对安装前检查、混合状态处理、安装验证、重启连接以及后续更新维护给出可执行的命令与判断依据。读完本文，你将能够独立完成 Claude Code 的 Firebase 环境搭建，并确认firebase-basics技能与 Firebase MCP 工具均已就绪可用。

为什么要在 Claude Code 中集成 Firebase

Claude Code 作为 Agent 开发环境，要充分发挥 Firebase 的能力，需要两类组件协同工作：

Agent Skills：即本仓库中的firebase-basics技能（见 SKILL.md），它提供了 Firebase CLI 安装校验、firebase-tools@latest版本检查、CLI 登录（含--no-localhost）、项目创建与切换（firebase use）、以及google-services.json/GoogleService-Info.plist配置文件的自动化下载等基础能力。技能的作用是让 Agent 知道"如何正确地做"，而不是依赖通用知识。
MCP 服务器：让 Claude Code 能够直接与 Firebase 远程 API 交互（例如拉取 Crashlytics 日志、执行 Data Connect 查询）。SKILL.md 中明确要求：凡是需要调用 Firebase 远程 API 的场景，应优先使用 Firebase MCP Server 提供的工具，而非手工构造 API 请求。

Claude Code 使用原生的插件管理器来同时管理 Skills 与 MCP 功能，这也是官方文档给出的推荐安装方式（Recommended Method: Using Plugins）。

前置准备：本地环境校验

在开始插件安装之前，应先按 local-env-setup.md 的要求完成最小环境校验，SKILL.md 也强调这一步不可跳过：

Node.js 版本：运行node --version，要求版本>= 20（推荐使用 nvm/nvm-windows 安装 Node 24）。因为 Firebase CLI 以 npx 方式运行，Node 环境缺失会导致后续所有命令失败。
Firebase CLI 可用性：运行npx -y firebase-tools@latest --version，应能正常输出版本号。注意官方规范要求始终以npx -y firebase-tools@latest前缀调用，而非裸firebase命令，这样能确保每次都使用最新版 CLI。
Firebase 登录：运行npx -y firebase-tools@latest login；在无浏览器环境（如远程 shell）使用npx -y firebase-tools@latest login --no-localhost。未登录时，后续项目管理命令没有正确权限。

根据 SKILL.md 的 CRITICAL 规则：如果当前 Agent 环境中仅有firebase-basics这一个 Firebase 技能，就必须按照对应环境的 setup 参考文档（Claude Code 对应本指南）完成全套技能的安装，否则不得继续执行其他 Firebase 任务。

第一步：检查现有安装状态

安装前先确认插件是否已经就绪，避免重复安装：

检查已安装的 Skills：

# 查看本地（项目级）已安装技能 npx skills list --agent claude-code # 查看全局已安装技能 npx skills list --global --agent claude-code

观察输出中是否包含firebase-basics。

检查已有的 MCP 配置：

claude mcp list -s user # 用户级作用域 claude mcp list -s project # 项目级作用域

观察任一命令的输出中是否包含firebase条目。

根据检查结果确定下一步路径：
- Skills 与 MCP 配置都存在：说明插件已完整安装，立即停止，跳过本文档其余所有安装步骤。
- 两者都不存在：说明尚未安装，直接进入下一步"添加 Marketplace"。
- 只发现其中一项（例如 Skills 已装但 MCP 缺失，或反之）：属于混合状态，此时应停下来询问用户，向用户说明当前环境处于半安装状态，并确认是否要继续安装 Firebase 插件，得到确认后再进入下一步。

这种"先检查、后安装"的流程设计，与仓库中其他 Agent 环境的 setup 文档（如 cursor.md）保持一致，核心目的是保证安装操作的幂等性，避免破坏既有配置。

第二步：添加 Marketplace 并安装插件

添加 Firebase 插件市场

claude plugin marketplace add firebase/agent-skills

该命令默认使用 User 作用域，将 Firebase 的 Agent Skills 插件市场注册到 Claude Code 中。仓库根目录的 README.md 也说明了同类插件市场的通用接入模式（如claude plugin marketplace add google/skills后执行claude plugin install），本仓库的plugins/目录中可以看到插件形态的实例，例如 plugin.json 定义了name、version、description、license等元数据，mcp.json 则声明插件捆绑的 MCP 服务器（如developer-knowledge采用streamable-http类型）。Firebase 插件采用同样的"Skills + MCP 捆绑分发"结构，安装一个插件即可同时获得两套能力。

安装 Firebase 插件

claude plugin install firebase@firebase

命令中的firebase@firebase表示从名为firebase的插件市场安装名为firebase的插件。安装完成后，Claude Code 会自动将捆绑的 Agent Skills 与 Firebase MCP 服务器配置写入本地环境。

验证安装

重新执行第一步中的检查命令：

npx skills list --agent claude-code npx skills list --global --agent claude-code claude mcp list -s user claude mcp list -s project

确认firebase-basics技能与firebaseMCP 条目均已出现，即表示安装成功。Firebase MCP 服务器的底层运行方式可参考同技能下其他环境文档（cursor.md）中给出的配置形态，即通过npx -y firebase-tools@latest mcp或firebase mcp启动，Claude Code 插件安装会以等效方式注册该服务器。

第三步：重启并确认连接

重启 Claude Code：指示用户重启 Claude Code 应用，然后停下来等待用户的确认，再继续后续操作。重启是让新安装的技能与 MCP 服务器完成加载的必要步骤。
确认连接：重启后，在 Claude Code 中确认 Firebase MCP 服务器已成功连接、firebase-basics技能可被 Agent 调用。

日常维护：更新插件与技能

Firebase 的最佳实践演进较快，SKILL.md 建议定期检查并更新插件或 Agent Skills。Claude Code 环境下应使用其原生插件管理器进行更新，而不是npx：

claude plugin update firebase@firebase

该命令来自 refresh/claude.md，用于将 Firebase 插件（含技能与 MCP 配置）刷新到最新版本，确保 Agent 使用的 Firebase 知识不与官方最佳实践脱节。如果遇到工具或命令过时的问题，同样执行此更新流程。

安装后的能力基线

完成上述安装后，Claude Code 中的 Agent 即可获得firebase-basics技能定义的完整能力，其中包括（详见 SKILL.md）：

CLI 调用规范：所有命令统一使用npx -y firebase-tools@latest前缀，保证版本最新。
项目上下文管理：通过npx -y firebase-tools@latest use <PROJECT_ID>切换活动项目，或用npx -y firebase-tools@latest projects:create <project-id> --display-name "<display-name>"创建新项目（项目 ID 要求 6–30 位、小写、可含数字与连字符且全局唯一）。
配置文件自动化获取：不再引导用户去 Firebase 控制台手动下载，而是用 CLI 拉取，例如 Android 端执行npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID>，iOS 端执行npx -y firebase-tools@latest apps:sdkconfig IOS <APP_ID> --project <PROJECT_ID>。
服务初始化与命令探索：需要初始化新 Firebase 服务时参考 firebase-service-init.md（npx -y firebase-tools@latest init）；需要探索 CLI 功能时参考 firebase-cli-guide.md（npx -y firebase-tools@latest --help或npx -y firebase-tools@latest <command> --help）。

这些能力会通过本指南安装的firebase-basics技能在 Claude Code 中自动生效，构成 Agent 正确、安全操作 Firebase 的基线。

常见问题排查

登录时浏览器无法打开：改用npx -y firebase-tools@latest login --no-localhost完成无浏览器认证，该问题与处理方式在 SKILL.md 的 Common Issues 中有明确说明。
安装后技能未生效：确认 Claude Code 已完整重启；再次执行npx skills list --agent claude-code与claude mcp list -s user核对条目是否出现，并确认不存在"技能已装但 MCP 缺失"的混合状态。
环境为半安装状态：按第一步中的分支判断，先与用户确认意图，再决定是否补装插件，切勿在混合状态下直接覆盖配置。
Firebase CLI 命令报错或版本过旧：检查 Node.js 版本是否>= 20，并执行claude plugin update firebase@firebase刷新插件。

总结

在 Claude Code 中使用 Firebase 的最佳路径是插件市场方式：先通过npx skills list与claude mcp list完成安装状态检查（注意混合状态需与用户确认），再依次执行claude plugin marketplace add firebase/agent-skills与claude plugin install firebase@firebase，重启后验证firebase-basics技能与 Firebase MCP 服务器均已可用，之后通过claude plugin update firebase@firebase持续保持更新。整套流程既覆盖了 Skills 与 MCP 两方面的安装，也与仓库内 local-env-setup.md、SKILL.md、refresh/claude.md 等配套文档相互印证，可作为团队在 Claude Code 中落地 Firebase 技能的标准操作手册。

【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考