Оптимизируйте настройку Firebase для веб-приложений с помощью инструментов разработки на основе искусственного интеллекта, таких как Antigravity, Claude Code, Codex и Cursor. Используя навыки агента Firebase вместе с CLI Firebase и сервером MCP Firebase, вы можете превратить своего ИИ-агента по программированию в специализированного эксперта по Firebase, который может писать код, настраивать Firebase Security Rules и управлять активными ресурсами.
В этом руководстве рассказывается, как с помощью ИИ-агента для программирования настроить Cloud Firestore, Firebase Authentication и Firebase Hosting для веб-приложения. Скоро мы добавим информацию о приложениях для iOS, Android и Flutter.
Зачем использовать навыки и инструменты агента Firebase
ИИ-агенты для программирования часто испытывают трудности с определенными конфигурациями проектов или устаревшей информацией. Этот набор инструментов устраняет разрыв, объединяя специализированные инструкции (навыки агента) с двумя дополняющими друг друга типами инструментов выполнения агента (CLI и сервер MCP):
- Навыки агента Firebase. Предоставляют агенту программирования знания в предметной области и рабочие процессы. Навыки – это инструкции, которые помогают агенту работать с Firebase, в том числе писать код. Навыки также учат агента, когда и как использовать CLI Firebase и MCP-сервер Firebase.
- Инструменты выполнения агента:
- Firebase CLI (инструменты командной строки). Предоставляет инструменты для задач, связанных с жизненным циклом проекта и средой. Агент может выполнять команды CLI в терминале, чтобы настраивать сервисы в проекте Firebase, развертывать сайты или ресурсы бэкенда, запускать локальные эмуляторы и выполнять другие действия.
- Сервер Firebase MCP (программные инструменты и ресурсы). Предоставляет инструменты для проверки и операций с данными в реальном времени. Благодаря структурированным вызовам инструментов агент может программно запрашивать и обновлять документы Cloud Firestore, управлять пользователями Firebase Authentication, проверять Security Rules, извлекать журналы или документацию непосредственно в контекст и выполнять другие действия.
Использование навыков агента Firebase вместе с интерфейсом командной строки Firebase и MCP-сервером Firebase дает вашему ИИ-агенту для программирования дополнительные возможности:
- Действуйте. Не ограничивайтесь написанием кода. Ваш агент может инициализировать сервисы, управлять пользователями Firebase Authentication, развертывать новые Firebase Security Rules и работать напрямую с вашими данными Cloud Firestore.
- Актуальность. Используйте официальные запросы с учетом версий, чтобы помочь агенту выполнить задачи по настройке.
- Повышение точности. Доступ к среде и схемам проекта позволяет предоставлять более точную и релевантную помощь.
- Снижение расходов на токены. Навыки агента загружают подробную документацию только тогда, когда этого требует конкретная задача, что минимизирует накладные расходы на сеанс.
Применимые сервисы Firebase
В этом руководстве в основном рассказывается о том, как навыки агента, Firebase CLI и MCP-сервер Firebase работают вместе, чтобы помочь вам быстро настроить следующие сервисы и функции:
- Cloud Firestore – подготовка базы данных NoSQL.
- Firebase Authentication – настройте безопасный вход пользователей.
- Firebase Security Rules: генерируйте и улучшайте Security Rules для своего приложения.
- Firebase Hosting – настройте проект для развертывания статического веб-приложения.
Полный список доступных навыков можно найти в документации Firebase.
Общий рабочий процесс
Ниже описан общий рабочий процесс, в котором навыки агента Firebase используются для настройки и применения сервисов Firebase в веб-приложении. Для выполнения этих задач навыки агента используют CLI Firebase и MCP-сервер Firebase.
Шаг 1. Установите навыки агента Firebase
В большинстве случаев вы можете установить навыки агента Firebase в предпочитаемом редакторе с помощью одного запроса:
Antigravity
Вариант 1. Доступ на глобальном уровне
Навыки агента Firebase включены в плагин Firebase в Antigravity Marketplace (и в пакет интеграции Build with Google). Установите плагин, используя один из следующих вариантов:
- В Antigravity Marketplace нажмите Customizations (Настройки), выберите вкладку Marketplace и нажмите + на карточке плагина Firebase.
- В Antigravity CLI: запустите
/plugin install firebase@agent-marketplace(или запустите/pluginи установите Firebase на вкладке Discover (Обзор)). Плагины, установленные в Antigravity, также автоматически синхронизируются с Antigravity CLI. - При регистрации установите флажок для Firebase.
Вариант 2. Доступ на уровне проекта
Выполните в каталоге проекта следующую команду:
npx skills add firebase/agent-skills --agent=antigravity
Claude Code
Выполните в терминале следующие команды:
claude plugin marketplace add firebase/agent-skills
claude plugin install firebase@firebase
Codex
Вариант 1. Терминал Codex
Выполните в терминале следующие команды:
codex plugin marketplace add firebase/agent-skills codex plugin add firebase@firebaseВариант 2. Приложение Codex
Выполните следующие задачи один раз:
Регистрация через терминал:
codex plugin marketplace add firebase/agent-skillsПолностью перезапустите приложение Codex.
Откройте Плагины.
Выберите торговую площадку или источник Firebase.
Откройте Firebase и нажмите + Install (+ Установить).
Начните новую задачу.
Введите
@Firebase, чтобы выбрать плагин, или попросите Codex выполнить задачу Firebase.
Курсор
Вариант 1. Установите плагин напрямую из Cursor Marketplace.
Вариант 2. Выполните в терминале следующую команду:
npx skills add firebase/agent-skills --agent=cursor
Другие агенты
Выполните в терминале следующую команду:
npx skills add firebase/agent-skills
Шаг 2. Подключитесь к MCP-серверу Firebase
Хотя многие навыки агента Firebase используют для задач интерфейс командной строки Firebase, мы также рекомендуем подключить ИИ-агента для программирования к MCP-серверу Firebase. Это подключение расширяет возможности агента по взаимодействию со средой Firebase, обеспечивая более глубокую интеграцию и доступ.
Метод с использованием ИИ
В большинстве случаев вы можете попросить ИИ-агента настроить сервер MCP Firebase. Если у вас возникнут проблемы или вы не увидите MCP-сервер Firebase в списке, перейдите к разделу Вручную.
Ручной способ.
Antigravity
Чтобы настроить Antigravity для использования MCP-сервера Firebase:
- В Antigravity на панели агента нажмите на меню и выберите Серверы MCP.
- Выберите Firebase > Установить.
Это автоматически обновит ваш файл mcp_config.json. Чтобы посмотреть его, нажмите Manage MCP Servers (Управление MCP-серверами) в верхней части панели MCP Store > View raw config (Посмотреть необработанную конфигурацию). Вы увидите следующий контент:
{
"mcpServers": {
"firebase-mcp-server": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Claude
Claude Code
Вариант 1. Установка с помощью плагина (рекомендуется)
Проще всего настроить MCP-сервер Firebase в Claude Code, установив официальный плагин Firebase:
Добавьте Firebase Marketplace для плагинов Claude:
claude plugin marketplace add firebase/firebase-toolsУстановите плагин Claude для Firebase:
claude plugin install firebase@firebaseПроверьте установку:
claude plugin marketplace list
Вариант 2. Настройте MCP-сервер вручную
Вы также можете настроить MCP-сервер Firebase вручную:
Выполните следующую команду в папке приложения:
claude mcp add firebase npx -- -y firebase-tools@latest mcpПроверьте установку:
claude mcp listВ видео должно содержаться следующее:
firebase: npx -y firebase-tools@latest mcp - ✓ Connected
Claude Desktop
Чтобы настроить Claude Desktop для использования сервера MCP Firebase, отредактируйте файл claude_desktop_config.json. Вы можете открыть или создать этот файл в меню Claude > Settings (Claude > Настройки). Откройте вкладку Developer (Разработчик) и нажмите Edit Config (Изменить конфигурацию).
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Курсор
Вариант 1. Плагин Marketplace (рекомендуется)
Установите плагин Firebase из Cursor Marketplace. Это автоматически настроит MCP-сервер и предоставит доступ к навыкам агента Firebase.
Вариант 2. Настройка MCP в один клик
Если вы хотите добавить MCP-сервер только в глобальную конфигурацию, нажмите кнопку ниже.
Вариант 3. Настройка вручную
Если вы хотите настроить сервер для определенного проекта или изменить настройки вручную, обновите файл mcp.json:
- Для определенного проекта измените
.cursor/mcp.json - Для всех проектов (глобально) измените
~/.cursor/mcp.json
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Клайн
Чтобы настроить Cline для использования MCP-сервера Firebase, отредактируйте файл cline_mcp_settings.json. Чтобы открыть или создать этот файл, нажмите на значок MCP-серверов в верхней части панели Cline, а затем – на кнопку Configure MCP Servers (Настроить MCP-серверы).
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"],
"disabled": false
}
}
}
VS Code Copilot
Чтобы настроить один проект, отредактируйте файл .vscode/mcp.json в рабочей области:
"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"]
}
}
}
Виндсерфинг
Чтобы настроить Windsurf Editor, измените файл ~/.codeium/windsurf/mcp_config.json:
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Шаг 3. Инициализируйте сервисы Firebase
После настройки навыков и инструментов агента вы можете использовать естественный язык, чтобы ваш ИИ-агент для программирования настроил Cloud Firestore, Firebase Authentication и Firebase Hosting.
Попросите агента настроить сервис. Например, вы можете использовать такие подсказки:
- Настройте Cloud Firestore в качестве базы данных для этого приложения.
- Создайте страницу входа с помощью Authentication и обновите Security Rules, чтобы только авторизованные пользователи могли читать и записывать свои данные.
- Настройте Firebase Hosting и разверните рабочую версию приложения.
- Найдите в документации Cloud Firestore информацию о том, как разбить результаты запроса на страницы, и добавьте постраничную загрузку в список записей.
Ознакомьтесь с информацией и следуйте инструкциям, которые может предоставить агент, например:
- Планирование. Агент предлагает стратегию на основе существующей базы кода.
- Подключение. Агент связывает локальный код с существующим проектом Firebase или помогает создать новый.
- Инициализирует ресурсы. Агент добавляет в базу кода необходимые библиотеки и конфигурацию Firebase.
- Обновляет файлы. Агент создает и обновляет необходимые файлы, например
firestore.rules(чтобы определить, кто может читать, записывать или запрашивать данные в базе данных) илиfirebase.json(чтобы сообщить Firebase CLI, какие сервисы нужно развернуть и как их настроить). - Выполнение. Агент помогает вам выполнить дополнительные действия по настройке или развертыванию.
Обучите агента на основе официальной документации Firebase
Сервер MCP Firebase включает инструменты, которые позволяют агенту искать актуальную официальную документацию Google для разработчиков (в том числе firebase.google.com), когда он пишет код и работает с вашим проектом Firebase. Это означает, что агент может использовать текущие SDK и API, новые функции, правильный синтаксис Security Rules и т. д., а не полагаться только на данные для обучения. Эти инструменты предоставляются MCP-сервером Developer Knowledge.
Если ваш агент не поддерживает MCP-серверы или вы хотите ссылаться на определенную документацию в подсказках или файлах инструкций проекта (например, AGENTS.md или CLAUDE.md), вы можете указать агенту на машиночитаемую документацию Firebase:
Индексы документации (
llms.txt). Предоставьте агенту полный индекс документации Firebase по адресу https://firebase.google.com/docs/llms.txt или используйте индекс для конкретного продукта, например https://firebase.google.com/docs/firestore/llms.txt для Cloud Firestore или https://firebase.google.com/docs/auth/llms.txt для Authentication.Страницы Markdown (
.md.txt). Добавьте.md.txtк URL любой страницы документации Firebase (например,https://firebase.google.com/docs/firestore/quickstart.md.txt), чтобы получить чистый код Markdown, отформатированный для языковых моделей. Кроме того, в верхней части любой страницы документации Firebase можно нажать Скопировать страницу в формате Markdown или открыть меню и выбрать Посмотреть в формате Markdown.
Общие советы по написанию запросов для ИИ-агента программирования
Чтобы получить максимальную отдачу от вашего ИИ-агента по кодированию, особенно при работе с многогранными интеграциями, такими как Firebase, относитесь к взаимодействию как к сотрудничеству, а не как к разовой команде.
Будьте точны и добавляйте контекст
Хотя MCP-сервер Firebase предоставляет агенту значительный контекст о вашем проекте, четкие и конкретные запросы на естественном языке дают наилучшие результаты. Избегайте расплывчатых запросов.
- Неопределённо: "Исправьте ошибку базы данных".
- Конкретный. "Я получаю ошибку "Доступ запрещен" при попытке записи в коллекцию "Пользователи" в Cloud Firestore. Проверь мой
firestore.rulesи предложи исправление, которое позволит аутентифицированным пользователям вносить изменения в свои документы".
Экспериментируйте и улучшайте
ИИ-агенты для программирования редко генерируют идеальный код с первой попытки, когда речь идет о сложных задачах. Если ответ не совсем точный, продолжайте разговор:
- Предоставьте сообщения об ошибках. Вставьте в чат ошибки терминала или журналы консоли.
- Попросите внести корректировки. "В этом коде используется более старая версия SDK – v8. Перепиши его, используя модульный SDK Firebase версии 9".
- Запрашивайте объяснения. "Объясни, как эти Firebase Security Rules защищают пользовательские данные".
Проверяйте перед выполнением
ИИ-агенты для программирования – мощный инструмент, но они могут ошибаться или "галлюцинировать" (придумывать несуществующие функции или сервисы).
- Проверяйте код. Всегда внимательно читайте сгенерированный код, особенно Firebase Security Rules и файлы конфигурации (например,
firebase.json), прежде чем развертывать его в рабочей среде. - Тестируйте локально. По возможности просите агента помочь вам протестировать изменения локально, прежде чем публиковать их.
Как использовать MCP-подключение
Поскольку сервер Firebase MCP предоставляет агенту прямую видимость структуры вашего проекта, вы можете ссылаться на конкретные файлы, чтобы получить индивидуальные советы по реализации.
- Пример. "Посмотри на мой файл
src/web/index.htmlи покажи, куда добавить стандартный скрипт инициализации Firebase".
Дальнейшие действия
- Посмотреть полный список доступных навыков агента Firebase
- Посмотрите полный список всех доступных подсказок, инструментов и ресурсов, которые предоставляет MCP-сервер Firebase.
- Подробнее об инструментах, предоставляемых интерфейсом командной строки Firebase CLI.
- Узнайте, как подключить ИИ-помощника разработчика к официальной документации Google для разработчиков с помощью MCP-сервера Developer Knowledge.