Integrowanie usług Firebase przy użyciu pomocy AI

Uprość konfigurację Firebase w przypadku aplikacji internetowych, korzystając z narzędzi do programowania opartych na AI, takich jak Antigravity, Claude Code, Codex i Cursor. Korzystając z umiejętności agenta Firebase w połączeniu z Firebase CLI i serwerem Firebase MCP, możesz przekształcić agenta AI do kodowania w specjalistę od Firebase, który potrafi pisać kod, konfigurować Firebase Security Rules i zarządzać zasobami na żywo.

Ten przewodnik zawiera informacje o korzystaniu z agenta do kodowania opartego na AI, który pomoże Ci skonfigurować Cloud Firestore, Firebase Authentication i Firebase Hosting w aplikacji internetowej. Wkrótce udostępnimy informacje o aplikacjach na iOS, Androida i Fluttera.

Dlaczego warto korzystać z umiejętności i narzędzi agenta Firebase?

Agenci do kodowania AI często mają problemy z określonymi konfiguracjami projektów lub nieaktualnymi informacjami. Ten zestaw narzędzi wypełnia tę lukę, łącząc specjalistyczne instrukcje (umiejętności agenta) z 2 uzupełniającymi się typami narzędzi do wykonywania działań przez agenta (interfejsem wiersza poleceń i serwerem MCP):

  • Umiejętności agenta Firebase: zapewniają agentowi kodującemu wiedzę specjalistyczną i przepływy pracy. Umiejętności stanowią warstwę instrukcji i wskazują agentowi sprawdzone metody pracy z Firebase, w tym pisania kodu. Umiejętności uczą też agenta, kiedy i jak używać interfejsu wiersza poleceń Firebase i serwera MCP Firebase.
  • Narzędzia do wykonywania działań przez agenta:
    • Firebase CLI (narzędzia wiersza poleceń): zawiera narzędzia do zarządzania cyklem życia projektu i środowiskiem. Agent może uruchamiać polecenia CLI w środowisku terminala, aby konfigurować usługi w projekcie w Firebase, wdrażać pełne witryny lub zasoby backendu, uruchamiać lokalne emulatory i wykonywać inne czynności.
    • Serwer MCP Firebase (narzędzia i zasoby do automatyzacji): udostępnia narzędzia do inspekcji i operacji na danych w czasie rzeczywistym. Dzięki strukturalnym wywołaniom narzędzi agent może programowo wysyłać zapytania i aktualizować Cloud Firestoredokumenty, zarządzać Firebase Authenticationużytkownikami, weryfikować Security Rules, pobierać na żywo logi lub dokumentację bezpośrednio do kontekstu i wykonywać inne czynności.

Korzystanie z umiejętności agenta Firebase wraz z Firebase interfejsem wiersza poleceń i serwerem MCP Firebase daje agentowi AI do kodowania dodatkowe możliwości:

  • Podejmuj działania: nie ograniczaj się do pisania kodu. Agent może inicjować usługi, zarządzać Firebase Authentication użytkownikami, wdrażać nowe Firebase Security Rules i pracować bezpośrednio z Twoimi Cloud Firestore danymi.
  • Bądź na bieżąco: używaj oficjalnych promptów uwzględniających wersję, aby przeprowadzić agenta przez zadania konfiguracyjne.
  • Zwiększanie dokładności: dostęp do środowiska i schematów projektu, aby zapewniać bardziej trafne i dokładne informacje.
  • Obniżanie kosztów tokenów: umiejętności agenta wczytują szczegółową dokumentację tylko wtedy, gdy wymaga tego konkretne zadanie, co minimalizuje koszty sesji.

Obowiązujące usługi Firebase

Ten przewodnik koncentruje się głównie na tym, jak umiejętności agenta, interfejs Firebase CLI i serwer MCP Firebase współpracują ze sobą, aby pomóc Ci szybko skonfigurować te usługi i funkcje:

  • Cloud Firestore: udostępnianie bazy danych NoSQL.
  • Firebase Authentication: skonfiguruj bezpieczne logowanie użytkowników.
  • Firebase Security Rules: generowanie i ulepszanie Security Rules dla aplikacji.
  • Firebase Hosting: skonfiguruj projekt na potrzeby wdrażania statycznej aplikacji internetowej.

Pełną listę dostępnych funkcji znajdziesz na tej stronie.

Ogólny przepływ pracy

Poniższe kroki opisują ogólny przepływ pracy dotyczący korzystania z umiejętności agenta Firebase do konfigurowania i używania usług Firebase w aplikacji internetowej. W tle umiejętności agenta używają interfejsu Firebase CLI i serwera Firebase MCP do wykonywania tych zadań.

Krok 1. Zainstaluj umiejętności agenta Firebase

W większości przypadków możesz zainstalować umiejętności agenta Firebase w wybranym edytorze za pomocą jednego prompta:

Antigravity

  • Opcja 1. Dostęp na poziomie globalnym

    Umiejętności agenta Firebase są dostępne w jednym z pakietów integracji Build with Google dla Antigravity. Włącz ten pakiet, korzystając z jednej z tych opcji:

    • Podczas wprowadzania: zaznacz pole wyboru stosu Firebase.
    • W ustawieniach po wprowadzeniu: otwórz Ustawienia > Dostosowywanie. W sekcji Build with Google Plugins (Twórz za pomocą wtyczek Google) kliknij Customize (Dostosuj), a potem Download (Pobierz) w przypadku integracji z Firebase.
  • Opcja 2. Dostęp na poziomie projektu

    W katalogu projektu uruchom to polecenie:

    npx skills add firebase/agent-skills --agent=antigravity
    

Claude Code

Uruchom w terminalu te polecenia:

claude plugin marketplace add firebase/agent-skills
claude plugin install firebase@firebase

Codex

  • Opcja 1. Terminal Codex

    Uruchom w terminalu te polecenia:

    codex plugin marketplace add firebase/agent-skills
    codex plugin add firebase@firebase
    
  • Opcja 2. Aplikacja Codex

    1. Wykonaj te czynności tylko raz:

      1. Rejestracja w terminalu:

        codex plugin marketplace add firebase/agent-skills
        
      2. Całkowicie uruchom ponownie aplikację Codex.

      3. Otwórz Wtyczki.

      4. Wybierz platformę/źródło Firebase.

      5. Otwórz Firebase i kliknij + Zainstaluj.

    2. rozpocząć nowe zadanie,

    3. Wpisz @Firebase, aby wybrać wtyczkę, lub poproś Codexa o wykonanie zadania w Firebase.

Kursor

  • Opcja 1. Zainstaluj wtyczkę bezpośrednio z Cursor Marketplace.

  • Opcja 2. Uruchom w terminalu to polecenie:

    npx skills add firebase/agent-skills --agent=cursor
    

Inne agenty

Uruchom w terminalu to polecenie:

npx skills add firebase/agent-skills

Krok 2. Połącz się z serwerem MCP Firebase

Wiele umiejętności agenta Firebase korzysta z Firebase interfejsu CLI do wykonywania zadań, ale zalecane jest też połączenie agenta AI do kodowania z serwerem Firebase MCP. To połączenie zwiększa możliwości agenta w zakresie interakcji z Twoim środowiskiem Firebase, zapewniając głębszą integrację i dostęp.

Metoda wspomagana przez AI

W większości przypadków możesz poprosić agenta AI do kodowania o skonfigurowanie serwera Firebase MCP. Jeśli jednak nie będzie to możliwe lub nie zobaczysz na liście serwera MCP Firebase, przejdź na metodę ręczną.

Metoda ręczna

Antigravity

Aby skonfigurować Antigravity tak, aby używała serwera MCP Firebase:

  1. W Antigravitykliknij menu w panelu Agenta > Serwery MCP.
  2. Wybierz Firebase > Zainstaluj.

Spowoduje to automatyczne zaktualizowanie pliku mcp_config.json, który możesz wyświetlić, klikając Zarządzaj serwerami MCP u góry panelu Sklep MCP > Wyświetl surową konfigurację. Plik będzie zawierać te informacje:

{
  "mcpServers": {
    "firebase-mcp-server": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Claude

Claude Code

  • Opcja 1. Instalacja za pomocą wtyczki (zalecana)

    Najprostszym sposobem skonfigurowania serwera Firebase MCP w Claude Code jest zainstalowanie oficjalnej wtyczki Firebase:

    1. Dodaj platformę Firebase z wtyczkami do Claude:

      claude plugin marketplace add firebase/firebase-tools
    2. Zainstaluj wtyczkę Claude do Firebase:

      claude plugin install firebase@firebase
    3. Sprawdź instalację:

      claude plugin marketplace list
  • Opcja 2. Ręczne skonfigurowanie serwera MCP

    Możesz też ręcznie skonfigurować serwer MCP Firebase:

    1. W folderze aplikacji uruchom to polecenie:

      claude mcp add firebase npx -- -y firebase-tools@latest mcp
    2. Sprawdź instalację:

      claude mcp list

      Powinny się w nim znajdować:

      firebase: npx -y firebase-tools@latest mcp - ✓ Connected
      

Claude Desktop

Aby skonfigurować Claude Desktop do korzystania z serwera MCP Firebase, zmień plik claude_desktop_config.json. Możesz otworzyć lub utworzyć ten plik w menu Claude > Ustawienia. Kliknij kolejno kartę Deweloper i Edytuj konfigurację.

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Kursor

Opcja 1. Wtyczka Marketplace (zalecana)

Zainstaluj wtyczkę Firebase z Cursor Marketplace. Spowoduje to automatyczne skonfigurowanie serwera MCP i udostępnienie umiejętności agenta Firebase.

Opcja 2. Konfiguracja MCP jednym kliknięciem

Jeśli chcesz dodać serwer MCP tylko do konfiguracji globalnej, kliknij ten przycisk:

Instalowanie serwera MCP

Opcja 3. Konfiguracja ręczna

Jeśli wolisz skonfigurować serwer dla konkretnego projektu lub chcesz ręcznie edytować ustawienia, zaktualizuj plik mcp.json:

  • W przypadku konkretnego projektu kliknij .cursor/mcp.json.
  • W przypadku wszystkich projektów (globalnych) edytuj ~/.cursor/mcp.json
"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

Cline

Aby skonfigurować Cline tak, aby używał serwera MCP Firebase, edytuj plik cline_mcp_settings.json. Możesz otworzyć lub utworzyć ten plik, klikając ikonę serwerów MCP u góry panelu Cline, a następnie klikając przycisk Skonfiguruj serwery MCP.

{
  "mcpServers": {
    "firebase": {
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"],
      "disabled": false
    }
  }
}

VS Code Copilot

Aby skonfigurować pojedynczy projekt, edytuj plik .vscode/mcp.json w obszarze roboczym:

"servers": {
  "firebase": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

Aby serwer był dostępny w każdym otwieranym projekcie, zmień ustawienia użytkownika, np.:

"mcp": {
  "servers": {
    "firebase": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "firebase-tools@latest", "mcp"]
    }
  }
}

Windsurf

Aby skonfigurować edytor Windsurf, zmodyfikuj plik ~/.codeium/windsurf/mcp_config.json:

"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

Krok 3. Zainicjuj usługi Firebase

Po skonfigurowaniu umiejętności agenta i narzędzi możesz używać języka naturalnego, aby agent AI do kodowania skonfigurował Cloud Firestore, Firebase Authentication i Firebase Hosting.

  1. Poproś agenta o skonfigurowanie usługi. Możesz na przykład użyć takich promptów:

    • Skonfiguruj Cloud Firestore jako bazę danych tej aplikacji.
    • Utwórz stronę logowania za pomocą Authentication i zaktualizuj Security Rules, aby mieć pewność, że tylko autoryzowani użytkownicy mogą odczytywać i zapisywać własne dane.
    • Skonfiguruj Firebase Hosting i wdroż aplikację w wersji produkcyjnej.
  2. Sprawdź informacje i wykonaj wszystkie czynności, które może Ci zaproponować agent, np.:

    1. Plany: agent proponuje strategię na podstawie istniejącej bazy kodu.
    2. Łączy: agent łączy Twój kod lokalny z istniejącym projektem w Firebase lub pomaga Ci utworzyć nowy projekt w Firebase.
    3. Inicjuje zasoby: agent dodaje do bazy kodu wymagane biblioteki i konfigurację Firebase.
    4. Aktualizuje pliki: agent tworzy i aktualizuje wszystkie niezbędne pliki, takie jak firestore.rules (aby określić, kto może odczytywać, zapisywać lub wysyłać zapytania dotyczące danych w bazie danych) lub firebase.json (aby poinformować Firebase CLI, które usługi wdrożyć i jak je skonfigurować).
    5. Wykonuje: agent przeprowadza Cię przez dodatkowe czynności konfiguracyjne lub wdrożeniowe.

Ogólne wskazówki dotyczące promptów dla asystenta kodowania AI

Aby w pełni wykorzystać możliwości agenta AI do kodowania, zwłaszcza podczas pracy z wielopłaszczyznowymi integracjami, takimi jak Firebase, traktuj interakcję jako współpracę, a nie jednorazowe polecenie.

Podawaj konkretne informacje i kontekst

Serwer Firebase MCP zapewnia agentowi istotny kontekst dotyczący Twojego projektu, ale najlepsze wyniki uzyskasz, stosując jasne i konkretne prompty w języku naturalnym. Unikaj niejasnych próśb.

  • Niejasne: „Napraw błąd bazy danych”.
  • Szczegółowe: „Podczas próby zapisu w kolekcji „users” w Cloud Firestore pojawia się błąd „permission denied”. Sprawdź mój firestore.rules i zaproponuj poprawkę, która umożliwi uwierzytelnionym użytkownikom zapisywanie zmian w ich własnym dokumencie”.

Iteruj i doprecyzuj

Agenty AI do kodowania rzadko generują idealny kod za pierwszym razem w przypadku złożonych zadań. Jeśli odpowiedź nie jest do końca trafna, kontynuuj rozmowę:

  • Podaj komunikaty o błędach: wklej do czatu wszelkie błędy terminala lub dzienniki konsoli.
  • Poproś o wprowadzenie zmian: „Ten kod korzysta ze starszego pakietu SDK w wersji 8. Przepisz go za pomocą modułowego pakietu SDK Firebase w wersji 9."
  • Poproś o wyjaśnienie: „Wyjaśnij, jak te Firebase Security Rules chronią dane użytkowników”.

Sprawdź przed wykonaniem

Agenty AI do kodowania są potężne, ale mogą popełniać błędy lub „halucynować” (wymyślać nieprawidłowo nazwane funkcje lub usługi).

  • Sprawdź kod: zawsze czytaj wygenerowany kod, zwłaszcza Firebase Security Rulesi pliki konfiguracyjne (np. firebase.json), zanim wdrożysz go w środowisku produkcyjnym.
  • Testuj lokalnie: w miarę możliwości poproś agenta o pomoc w lokalnym testowaniu zmian przed ich wprowadzeniem.

Korzystanie z połączenia MCP

Serwer MCP Firebase zapewnia agentowi bezpośredni wgląd w strukturę projektu, dzięki czemu możesz odwoływać się do konkretnych plików, aby uzyskać dostosowane porady dotyczące implementacji.

  • Przykład: „Sprawdź mój plik src/web/index.html i pokaż, gdzie dodać standardowy skrypt inicjowania Firebase”.

Dalsze kroki