Упростите настройку 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. Чтобы посмотреть его, в верхней части панели 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 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 для использования сервера Firebase MCP, отредактируйте файл 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 CLI, какие сервисы нужно развернуть и как их настроить). - Выполнение. Агент помогает вам выполнить дополнительные действия по настройке или развертыванию.
Общие советы по составлению запросов для ИИ-агента программирования
Чтобы получить максимальную отдачу от ИИ-агента, особенно при работе с многогранными интеграциями, такими как 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
- Полный список доступных подсказок, инструментов и ресурсов, предоставляемых сервером Firebase MCP.
- Подробнее об инструментах, предоставляемых интерфейсом командной строки Firebase CLI.