Упростите настройку 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 и сервер Firebase MCP.
- Инструменты для выполнения действий агентом:
- Firebase CLI (инструменты командной строки): предоставляет инструменты для задач жизненного цикла проекта и среды. Агент может выполнять команды CLI в среде терминала, чтобы настраивать сервисы в проекте Firebase, развертывать сайты или ресурсы серверной части, запускать локальные эмуляторы и т. д.
- Сервер Firebase MCP (программные инструменты и ресурсы): предоставляет инструменты для проверки в реальном времени и операций с данными. С помощью структурированных вызовов инструментов агент может программно запрашивать и обновлять документы Cloud Firestore, управлять пользователями Firebase Authentication, проверять Security Rules, извлекать актуальные журналы или документацию непосредственно в контекст и выполнять другие действия.
Использование навыков агента Firebase вместе с Firebase CLI и сервером Firebase MCP дает ИИ-агенту для написания кода дополнительные возможности:
- Действия. Не ограничивайтесь написанием кода. Ваш агент может инициализировать сервисы, управлять пользователями Firebase Authentication, развертывать новые Firebase Security Rules и работать непосредственно с данными Cloud Firestore.
- Следите за новостями. Используйте официальные запросы с указанием версии, чтобы направлять агента при выполнении задач по настройке.
- Повышение точности. Доступ к среде и схемам проекта позволяет предоставлять более точную и полезную помощь.
- Снижение затрат на токены. Навыки агента загружают подробную документацию только тогда, когда это необходимо для выполнения определенной задачи, что позволяет минимизировать накладные расходы на сеанс.
Применимые сервисы Firebase
В этом руководстве рассказывается, как навыки агента, Firebase CLI и сервер Firebase MCP помогают быстро настроить следующие сервисы и функции:
- 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 входят в один из пакетов интеграции Build with Google для Antigravity. Включить этот пакет можно одним из следующих способов:
- Во время регистрации установите флажок рядом со стеком Firebase.
- В настройках после регистрации. Откройте Настройки > Специальные настройки. В разделе Build with Google Plugins (Создание с помощью плагинов Google) нажмите Customize (Настроить), а затем Download (Скачать) для интеграции с 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 в верхней части панели магазина MCP > Посмотреть необработанную конфигурацию. В файле будет следующее содержимое:
{
"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 > Настройки. Откройте вкладку Разработчик и нажмите Изменить конфигурацию.
{
"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
Чтобы настроить Cline на использование MCP-сервера Firebase, измените файл cline_mcp_settings.json. Вы можете открыть или создать этот файл, нажав на значок MCP-серверов в верхней части панели Cline, а затем на кнопку Настроить 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 возникает ошибка "Отказано в доступе". Проверь мой
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…