Integrowanie usług Firebase przy użyciu pomocy AI

Uprość konfigurację Firebase w aplikacjach internetowych, korzystając z narzędzi dla programistów opartych na AI, takich jak Antigravity, Claude Code, Codex i Cursor. Dzięki połączeniu umiejętności agenta Firebase z interfejsem wiersza poleceń Firebase i serwerem MCP Firebase możesz przekształcić swojego agenta AI do kodowania w wyspecjalizowanego eksperta Firebase, który może pisać kod, konfigurować Firebase Security Rules i zarządzać zasobami na żywo.

Z tego przewodnika dowiesz się, jak za pomocą agenta kodowania AI skonfigurować Cloud Firestore, Firebase Authentication i Firebase Hosting w aplikacji internetowej. Wkrótce znajdziesz tu informacje o aplikacjach na iOS, Androida i Fluttera.

Dlaczego warto używać umiejętności i narzędzi agenta Firebase?

Agenty AI do kodowania często mają problemy z konkretnymi 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 zadań przez agenta (interfejs wiersza poleceń i serwer MCP):

  • Umiejętności agenta Firebase: zapewniają agentowi kodującemu wiedzę specjalistyczną i przepływy pracy. Umiejętności stanowią warstwę instrukcji, która wskazuje 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 agenta:
    • Interfejs wiersza poleceń Firebase (narzędzia wiersza poleceń): udostępnia narzędzia do zadań związanych z cyklem życia projektu i środowiskiem. Agent może uruchamiać polecenia interfejsu wiersza poleceń w środowisku terminala, aby konfigurować usługi w projekcie w Firebase, wdrażać całe witryny lub zasoby backendu, uruchamiać emulatory lokalne i wykonywać inne czynności.
    • Serwer MCP Firebase (narzędzia i zasoby zautomatyzowane): udostępnia narzędzia do kontroli i operacji na danych w czasie rzeczywistym. Dzięki ustrukturyzowanym wywołaniom narzędzi agent może automatycznie wysyłać zapytania i aktualizować dokumenty Cloud Firestore, zarządzać użytkownikami Firebase Authentication, sprawdzać Security Rules, pobierać logi lub dokumentację bezpośrednio do kontekstu i wykonywać inne czynności.

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

  • Podejmowanie działań: nie ograniczaj się do pisania kodu. Agent może inicjować usługi, zarządzać użytkownikami Firebase Authentication, wdrażać nowe Firebase Security Rules i pracować bezpośrednio z danymi Cloud Firestore.
  • 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: uzyskaj dostęp do środowiska i schematów projektu, aby zapewnić bardziej trafną i dokładną pomoc.
  • Obniżenie kosztów tokenów: umiejętności agenta wczytują szczegółową dokumentację tylko wtedy, gdy wymaga tego konkretne zadanie, co minimalizuje obciążenie sesji.

Odpowiednie usługi Firebase

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

  • Cloud Firestore: udostępnij bazę danych NoSQL.
  • Firebase Authentication: skonfiguruj bezpieczne logowanie użytkowników.
  • Firebase Security Rules: generuj i ulepszaj Security Rules dla swojej aplikacji.
  • Firebase Hosting: skonfiguruj projekt na potrzeby wdrażania statycznej aplikacji internetowej.

Pełną listę dostępnych umiejętności znajdziesz w pełnej liście umiejętności agenta Firebase.

Ogólny przepływ pracy

Poniżej opisujemy uogólniony przepływ pracy, który pokazuje, jak używać umiejętności agenta Firebase do konfigurowania usług Firebase i korzystania z nich w aplikacji internetowej. W tle umiejętności agenta używają interfejsu wiersza poleceń Firebase 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 preferowanym edytorze za pomocą jednego prompta:

Antigravity

  • Opcja 1. Dostęp na poziomie globalnym

    Umiejętności agenta Firebase są zawarte we wtyczce Firebase w Antigravity Marketplace (oraz jako pakiet integracyjny Build with Google). Zainstaluj wtyczkę, korzystając z jednej z tych opcji:

    • W Antigravity Marketplace: kliknij Dostosowania, wybierz kartę Marketplace, a następnie kliknij + na karcie wtyczki Firebase.
    • W Antigravity CLI: uruchom /plugin install firebase@agent-marketplace (lub uruchom /plugin i zainstaluj Firebase z karty Odkrywaj). Wtyczki zainstalowane w Antigravity są też automatycznie synchronizowane z Antigravity CLI.
    • Podczas wprowadzania: zaznacz pole wyboru Firebase.
  • Opcja 2. Dostęp na poziomie projektu

    Uruchom to polecenie w katalogu projektu:

    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 zadania raz:

      1. Zarejestruj się za pomocą terminala:

        codex plugin marketplace add firebase/agent-skills
        
      2. Uruchom ponownie aplikację Codex.

      3. Otwórz Wtyczki.

      4. Wybierz platformę handlową lub źródło Firebase.

      5. Otwórz Firebase i kliknij + Zainstaluj.

    2. Rozpocznij nowe zadanie.

    3. Wpisz @Firebase, aby wybrać wtyczkę, lub poproś Codex o wykonanie zadania 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
    

Inni agenci

Uruchom w terminalu to polecenie:

npx skills add firebase/agent-skills

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

Chociaż wiele umiejętności agenta Firebase używa interfejsu wiersza poleceń Firebase do wykonywania zadań, zalecamy też połączenie agenta AI do kodowania z serwerem Firebase MCP. To połączenie zwiększa możliwości agenta w zakresie interakcji ze ś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 wystąpią problemy lub nie widzisz serwera MCP Firebase na liście, przejdź do metody ręcznej.

Sposób ręczny

Antigravity

Aby skonfigurować Antigravity do korzystania z serwera MCP Firebase:

  1. W Antigravity kliknij 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 nieprzetworzoną 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)

    Najłatwiejszym sposobem skonfigurowania serwera Firebase MCP w Claude Code jest zainstalowanie oficjalnej wtyczki Firebase:

    1. Dodaj Firebase Marketplace dla wtyczek Claude:

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

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

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

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

    1. Uruchom to polecenie w folderze aplikacji:

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

      claude mcp list

      Powinny być na nim widoczne:

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

Claude Desktop

Aby skonfigurować Claude Desktop do korzystania z serwera MCP Firebase, zmodyfikuj plik claude_desktop_config.json. Możesz otworzyć lub utworzyć ten plik w menu Claude > Ustawienia. Kliknij kartę Deweloper, a następnie 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 zapewnienie dostępu do 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:

Zainstaluj serwer 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 edytuj .cursor/mcp.json
  • W przypadku wszystkich projektów (globalnie) edytuj ~/.cursor/mcp.json
"mcpServers": {
  "firebase": {
    "command": "npx",
    "args": ["-y", "firebase-tools@latest", "mcp"]
  }
}

Cline

Aby skonfigurować Cline do korzystania z serwera MCP Firebase, zmodyfikuj 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 przycisk Configure MCP Servers (Skonfiguruj serwery MCP).

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

VS Code Copilot

Aby skonfigurować pojedynczy projekt, zmodyfikuj 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, na przykład:

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

Windsurfing

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 i narzędzi agenta możesz teraz 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 używać takich promptów:

    • Skonfiguruj Cloud Firestore jako bazę danych dla 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ć swoje dane.
    • Skonfiguruj Firebase Hosting i wdróż aplikację w środowisku produkcyjnym.
  2. Zapoznaj się z informacjami i postępuj zgodnie z instrukcjami, które może podać agent, takimi jak:

    1. Planuje: agent proponuje strategię na podstawie istniejącej bazy kodu.
    2. Łączenie: agent łączy kod lokalny z istniejącym projektem w Firebase lub pomaga 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 do danych w bazie danych) lub firebase.json (aby poinformować interfejs wiersza poleceń Firebase, które usługi mają zostać wdrożone i jak je skonfigurować).
    5. Wykonuje: agent przeprowadzi Cię przez dodatkowe kroki konfiguracji lub wdrażania.

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

Aby jak najlepiej wykorzystać możliwości agenta kodowania opartego na AI, zwłaszcza podczas pracy z wielowymiarowymi integracjami, takimi jak Firebase, traktuj interakcję jako współpracę, a nie pojedyncze polecenie.

Podawaj konkretne informacje i kontekst.

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

  • Nieprecyzyjny: „Napraw błąd bazy danych”.
  • Konkretne: „Podczas próby zapisu w kolekcji „użytkownicy” w Cloud Firestore pojawia się błąd „odmowa uprawnień”. Sprawdź moją regułę firestore.rules i zaproponuj poprawkę, która pozwoli uwierzytelnionym użytkownikom zapisywać dane we własnym dokumencie”.

Iteracja i doprecyzowanie

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 poprawna, kontynuuj rozmowę:

  • Podaj komunikaty o błędach: wklej na czacie błędy z terminala lub dzienniki konsoli.
  • Poproś o wprowadzenie zmian: „Ten kod używa starszego pakietu SDK w wersji 8. Przepisz go, używając modułowego pakietu SDK Firebase w wersji 9”.
  • Prośba o wyjaśnienia: „Wyjaśnij, jak te Firebase Security Rules chronią dane użytkowników”.

Weryfikacja 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: przed wdrożeniem w środowisku produkcyjnym zawsze przeczytaj wygenerowany kod, zwłaszcza Firebase Security Rules i pliki konfiguracji (takie jak firebase.json).
  • Testuj lokalnie: gdy tylko jest to możliwe, poproś agenta o pomoc w testowaniu zmian lokalnie przed ich opublikowaniem.

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: „Spójrz na mój plik src/web/index.html i pokaż mi, gdzie dodać standardowy skrypt inicjujący Firebase”.

Dalsze kroki