Как интегрировать сервисы Firebase с помощью ИИ

Упростите настройку 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

    1. Выполните следующие задачи один раз:

      1. Регистрация через терминал:

        codex plugin marketplace add firebase/agent-skills
        
      2. Перезапустите приложение Codex.

      3. Откройте Плагины.

      4. Выберите торговую площадку или источник Firebase.

      5. Откройте Firebase и нажмите + Install (Установить).

    2. Начать новую задачу.

    3. Введите @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:

  1. В Antigravity нажмите на меню на панели агента > Серверы MCP.
  2. Выберите 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:

    1. Добавьте каталог Firebase для плагинов Claude:

      claude plugin marketplace add firebase/firebase-tools
    2. Установите плагин Claude для Firebase:

      claude plugin install firebase@firebase
    3. Проверьте установку:

      claude plugin marketplace list
  • Вариант 2. Настройте MCP-сервер вручную

    Вы также можете настроить MCP-сервер Firebase вручную:

    1. Выполните следующую команду в папке приложения:

      claude mcp add firebase npx -- -y firebase-tools@latest mcp
    2. Проверьте установку:

      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-сервер только в глобальную конфигурацию, нажмите кнопку ниже.

Как установить 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.

  1. Попросите агента настроить сервис. Например, вы можете использовать такие подсказки:

    • Настройте Cloud Firestore в качестве базы данных для этого приложения.
    • Создайте страницу входа с помощью Authentication и обновите Security Rules, чтобы только авторизованные пользователи могли читать и записывать свои данные.
    • Настройте Firebase Hosting и опубликуйте рабочую версию приложения.
  2. Проверьте информацию и выполните все инструкции, которые может предоставить агент, например:

    1. Планирование. Агент предлагает стратегию на основе существующей базы кода.
    2. Подключение. Агент связывает локальный код с существующим проектом Firebase или помогает создать новый.
    3. Инициализирует ресурсы. Агент добавляет в базу кода необходимые библиотеки и конфигурацию Firebase.
    4. Обновление файлов. Специалист создает и обновляет все необходимые файлы, например firestore.rules (чтобы определить, кто может читать, записывать или запрашивать данные в вашей базе данных) или firebase.json (чтобы сообщить интерфейсу командной строки Firebase, какие сервисы нужно развернуть и как их настроить).
    5. Выполнение. Агент помогает вам выполнить дополнительные действия по настройке или развертыванию.

Общие советы по составлению запросов для ИИ-агента программирования

Чтобы получить максимальную пользу от агента на основе ИИ, особенно при работе со сложными интеграциями, такими как 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".

Дальнейшие действия