Как интегрировать сервисы 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 и сервер 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

    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 в верхней части панели магазина MCP > Посмотреть необработанную конфигурацию. В файле будет следующее содержимое:

{
  "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 > Настройки. Откройте вкладку Разработчик и нажмите Изменить конфигурацию.

{
  "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

Чтобы настроить 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.

  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 возникает ошибка "Отказано в доступе". Проверь мой firestore.rules и предложи исправление, которое позволит авторизованным пользователям записывать данные в свой документ".

Экспериментируйте и улучшайте

ИИ-агенты для написания кода редко создают идеальный код с первой попытки для сложных задач. Если ответ не совсем точный, продолжайте разговор:

  • Предоставьте сообщения об ошибках. Скопируйте все ошибки терминала или журналы консоли и вставьте их в чат.
  • Попросите внести изменения. "В этом коде используется более старая версия SDK – v8. Перепиши его, используя модульный SDK Firebase версии 9".
  • Запрашивайте объяснения. "Объясни, как эти Firebase Security Rules защищают пользовательские данные".

Проверяйте перед выполнением

ИИ-агенты для написания кода – мощные инструменты, но они могут ошибаться или "галлюцинировать" (создавать функции или сервисы с неправильными названиями).

  • Проверяйте код. Всегда читайте сгенерированный код, особенно Firebase Security Rules и файлы конфигурации (например, firebase.json), прежде чем развертывать его в рабочей среде.
  • Тестируйте локально. По возможности просите агента помочь вам протестировать изменения локально, прежде чем применять их на сайте.

Как использовать подключение MCP

Поскольку сервер Firebase MCP предоставляет агенту прямой доступ к структуре вашего проекта, вы можете ссылаться на определенные файлы, чтобы получить индивидуальные рекомендации по реализации.

  • Пример. "Посмотри на мой файл src/web/index.html и покажи, куда добавить стандартный скрипт инициализации Firebase".

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