Упростите настройку Firebase для веб-приложений с помощью инструментов разработки на основе искусственного интеллекта, таких как Antigravity, Claude Code, Codex и Cursor. Используя навыки агента Firebase вместе с интерфейсом командной строки Firebase и сервером Firebase MCP, вы можете превратить своего ИИ-агента в специалиста по 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. На самом деле навыки агента используют Firebase CLI и сервер Firebase MCP для выполнения этих задач.
Шаг 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 на вкладке Обзор). Плагины, установленные в 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 CLI, мы также рекомендуем подключить вашего ИИ-агента к MCP-серверу Firebase. Это подключение расширяет возможности агента по взаимодействию со средой Firebase, обеспечивая более глубокую интеграцию и доступ.
Метод на основе ИИ
В большинстве случаев вы можете попросить ИИ-агента по написанию кода настроить сервер Firebase MCP. Если сервер Firebase MCP не отображается в списке, перейдите к ручному методу.
Вручную
Antigravity
Чтобы настроить Antigravity для использования MCP-сервера Firebase:
- В Antigravity нажмите на меню на панели агента > Серверы MCP.
- Выберите Firebase > Установить.
Это автоматически обновит ваш файл mcp_config.json. Чтобы посмотреть его, в верхней части панели MCP Store нажмите Manage MCP Servers (Управление MCP-серверами) > View raw config (Посмотреть необработанную конфигурацию). Вы увидите следующий контент:
{
"mcpServers": {
"firebase-mcp-server": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Claude
Claude Code
Вариант 1. Установка с помощью плагина (рекомендуется)
Проще всего настроить сервер Firebase MCP в Claude Code, установив официальный плагин Firebase:
Добавьте каталог Firebase для плагинов 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 и опубликуйте рабочую версию приложения.
Проверьте информацию и выполните все инструкции, которые может предоставить агент, например:
- Планирование. Агент предлагает стратегию на основе существующей базы кода.
- Подключение. Агент связывает локальный код с существующим проектом Firebase или помогает создать новый.
- Инициализирует ресурсы. Агент добавляет в базу кода необходимые библиотеки и конфигурацию Firebase.
- Обновление файлов. Специалист создает и обновляет все необходимые файлы, например
firestore.rules(чтобы определить, кто может читать, записывать или запрашивать данные в вашей базе данных) илиfirebase.json(чтобы сообщить интерфейсу командной строки Firebase, какие сервисы нужно развернуть и как их настроить). - Выполнение. Агент помогает вам выполнить дополнительные действия по настройке или развертыванию.
Общие советы по составлению запросов для ИИ-агента программирования
Чтобы получить максимальную пользу от агента на основе ИИ, особенно при работе со сложными интеграциями, такими как Firebase, относитесь к взаимодействию с ним как к сотрудничеству, а не как к однократному выполнению команды.
Будьте конкретны и предоставьте контекст
Хотя MCP-сервер Firebase предоставляет агенту значительный контекст о вашем проекте, четкие и конкретные запросы на естественном языке дают наилучшие результаты. Избегайте расплывчатых запросов.
- Неопределенно: "Исправьте ошибку базы данных".
- Конкретный. "При попытке записи в коллекцию users в Cloud Firestore возникает ошибка permission denied. Проверь мой
firestore.rulesи предложи исправление, которое позволит авторизованным пользователям записывать данные в свой документ".
Повторяйте и улучшайте
ИИ-агенты для программирования редко генерируют идеальный код с первой попытки, когда речь идет о сложных задачах. Если ответ не совсем точный, продолжайте разговор:
- Предоставьте сообщения об ошибках. Вставьте в чат ошибки терминала или журналы консоли.
- Попросите внести корректировки. "В этом коде используется более старая версия SDK – v8. Перепиши его, используя модульный SDK Firebase версии 9".
- Запрашивайте объяснения. "Объясни, как эти Firebase Security Rules защищают пользовательские данные".
Проверяйте перед выполнением
ИИ-агенты для программирования – мощный инструмент, но они могут ошибаться или "галлюцинировать" (придумывать несуществующие функции или сервисы).
- Проверяйте код. Всегда внимательно читайте сгенерированный код, особенно Firebase Security Rules и файлы конфигурации (например,
firebase.json), прежде чем развертывать его в рабочей среде. - Тестируйте локально. По возможности просите агента помочь вам протестировать изменения локально, прежде чем применять их на сайте.
Как использовать подключение к MCP
Поскольку MCP-сервер Firebase предоставляет агенту прямой доступ к структуре проекта, вы можете ссылаться на конкретные файлы, чтобы получать индивидуальные рекомендации по реализации.
- Пример. "Посмотри на мой файл
src/web/index.htmlи покажи, куда добавить стандартный скрипт инициализации Firebase".
Дальнейшие действия
- Посмотреть полный список доступных навыков агента Firebase
- Ознакомьтесь с полным списком всех доступных запросов, инструментов и ресурсов, которые предоставляет MCP-сервер Firebase.
- Подробнее об инструментах, предоставляемых интерфейсом командной строки Firebase CLI.