Usprawnij konfigurację Firebase dla aplikacji internetowych, korzystając z narzędzi programistycznych opartych na AI , takich jak Antigravity, Claude Code, Codex i Cursor. Dzięki połączeniu umiejętności agenta Firebase z Firebase interfejsem wiersza poleceń i serwerem MCP Firebase możesz przekształcić swojego agenta kodowania AI w specjalistę od Firebase, który będzie mógł pisać kod, konfigurować Firebase Security Rules i zarządzać zasobami na żywo.
Ten przewodnik zawiera informacje o korzystaniu z agenta kodowania AI, który pomoże Ci skonfigurować Cloud Firestore, Firebase Authentication i Firebase Hosting w aplikacji internetowej. Wkrótce opublikujemy informacje o aplikacjach na iOS, Androida i Fluttera.
Dlaczego warto korzystać z umiejętności i narzędzi agenta Firebase?
Agenci kodowania AI często mają problemy z konkretnymi konfiguracjami projektów lub nieaktualnymi informacjami. Ten zestaw narzędzi rozwiązuje ten problem, łą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 kodowania wiedzę o domenie i przepływy pracy. Umiejętności, jako warstwa instrukcji, wskazują agentowi najlepsze praktyki dotyczące pracy z Firebase, w tym pisania kodu. Umiejętności uczą też agenta, kiedy i jak używać interfejsu wiersza poleceń Firebase i serwera Firebase MCP.
- Narzędzia do wykonywania zadań przez agenta:
- Firebase Interfejs wiersza poleceń Firebase (narzędzia wiersza poleceń): udostępnia narzędzia do zarządzania cyklem życia projektu i zadaniami środowiskowymi. 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ć lokalne emulatory i wykonywać inne czynności.
- Serwer MCP Firebase (narzędzia i zasoby programowe): udostępnia narzędzia do inspekcji w czasie rzeczywistym i operacji na danych. Dzięki uporządkowanym wywołaniom narzędzi agent może programowo wysyłać zapytania i aktualizować Cloud Firestore dokumenty, zarządzać Firebase Authentication użytkownikami, weryfikować Security Rules, pobierać dzienniki 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 daje agentowi kodowania AI dodatkowe możliwości:
- Podejmowanie działań: agent może robić więcej niż tylko pisać kod. Może inicjować usługi, zarządzać Firebase Authentication użytkownikami, wdrażać nowe Firebase Security Rules, i pracować bezpośrednio z danymi Cloud Firestore.
- Aktualność: używaj oficjalnych promptów uwzględniających wersję, aby prowadzić agenta przez zadania konfiguracji.
- Zwiększanie dokładności: uzyskaj dostęp do środowiska i schematów projektu, aby zapewnić 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 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 Firebase MCP 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 dopracowuj Security Rules aplikacji.
- Firebase Hosting: skonfiguruj projekt pod kątem wdrożenia statycznej aplikacji internetowej.
Aby zobaczyć pełną listę dostępnych funkcji, zapoznaj się z pełną listą umiejętności agenta Firebase.
Ogólny przepływ pracy
Poniższe kroki opisują ogólny przepływ pracy związany z używaniem 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 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 umiejętności agenta Firebase możesz zainstalować w preferowanym edytorze za pomocą jednego prompta:
Antigravity
Opcja 1. Dostęp na poziomie globalnym
Umiejętności agenta Firebase są dostępne w wtyczce Firebase w Antigravity Marketplace (oraz w pakiecie integracyjnym Build with Google ). Zainstaluj wtyczkę, korzystając z jednej z tych opcji:
- W Antigravity Marketplace: kliknij Dostosowania, wybierz kartę Marketplace, a potem kliknij + na karcie wtyczki Firebase.
- W Antigravity CLI: Uruchom
/plugin install firebase@agent-marketplace(lub uruchom/plugini zainstaluj Firebase na karcie Odkryj). Wtyczki zainstalowane w Antigravity są też automatycznie synchronizowane z Antigravity CLI. - Podczas wdrażania: zaznacz pole wyboru stosu Firebase.
Opcja 2. Dostęp na poziomie projektu
W katalogu projektu uruchom to polecenie:
npx skills add firebase/agent-skills --agent=antigravity
Claude Code
W terminalu uruchom te polecenia:
claude plugin marketplace add firebase/agent-skills
claude plugin install firebase@firebase
Codex
Opcja 1. Terminal Codex
W terminalu uruchom te polecenia:
codex plugin marketplace add firebase/agent-skills codex plugin add firebase@firebaseOpcja 2. Aplikacja Codex
Wykonaj te czynności jednorazowo:
Zarejestruj się w terminalu:
codex plugin marketplace add firebase/agent-skillsCałkowicie uruchom ponownie aplikację Codex.
Otwórz Wtyczki.
Wybierz Marketplace/źródło Firebase.
Otwórz Firebase i kliknij + Zainstaluj.
Rozpocznij nowe zadanie.
Wpisz
@Firebase, aby wybrać wtyczkę, lub poproś Codex o wykonanie zadania Firebase.
Cursor
Opcja 1: Zainstaluj wtyczkę bezpośrednio z Cursor Marketplace.
Opcja 2. W terminalu uruchom to polecenie:
npx skills add firebase/agent-skills --agent=cursor
Inni agenci
W terminalu uruchom to polecenie:
npx skills add firebase/agent-skills
Krok 2. Połącz się z serwerem Firebase MCP
Chociaż wiele umiejętności agenta Firebase używa interfejsu wiersza poleceń Firebase do wykonywania zadań, zalecamy też połączenie agenta kodowania AI 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 z pomocą AI
W większości przypadków możesz poprosić agenta kodowania AI o skonfigurowanie serwera Firebase MCP. Jeśli jednak agent ma problemy lub nie widzisz serwera Firebase MCP na liście, przejdź do metody ręcznej.
Metoda ręczna
Antigravity
Aby skonfigurować Antigravity do używania serwera Firebase MCP:
- W Antigravity kliknij menu w panelu Agent > Serwery MCP.
- Kliknij 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ę, o tę zawartość:
{
"mcpServers": {
"firebase-mcp-server": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Claude
Claude Code
Opcja 1: Zainstaluj za pomocą wtyczki (zalecane)
Najłatwiejszym sposobem skonfigurowania serwera Firebase MCP w Claude Code jest zainstalowanie oficjalnej wtyczki Firebase:
Dodaj Marketplace Firebase dla wtyczek Claude:
claude plugin marketplace add firebase/firebase-toolsZainstaluj wtyczkę Claude dla Firebase:
claude plugin install firebase@firebaseSprawdź instalację:
claude plugin marketplace list
Opcja 2: Skonfiguruj serwer MCP ręcznie
Możesz też ręcznie skonfigurować serwer Firebase MCP:
W folderze aplikacji uruchom to polecenie:
claude mcp add firebase npx -- -y firebase-tools@latest mcpSprawdź instalację:
claude mcp listPowinno się wyświetlić:
firebase: npx -y firebase-tools@latest mcp - ✓ Connected
Claude Desktop
Aby skonfigurować Claude Desktop do używania serwera Firebase MCP, zmodyfikuj plik claude_desktop_config.json. Możesz otworzyć lub utworzyć ten plik w menu Claude > Ustawienia. Wybierz kartę Deweloper, a potem kliknij Edytuj konfigurację.
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Cursor
Opcja 1. Wtyczka Marketplace (zalecana)
Zainstaluj wtyczkę Firebase z Cursor Marketplace. Spowoduje to automatyczne skonfigurowanie serwera MCP i zapewni dostęp do umiejętności agenta Firebase.
Opcja 2. Konfiguracja MCP jednym kliknięciem
Jeśli chcesz tylko dodać serwer MCP do konfiguracji globalnej, kliknij ten przycisk:
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 plik
.cursor/mcp.json. - W przypadku wszystkich projektów (globalnie) edytuj plik
~/.cursor/mcp.json.
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
Cline
Aby skonfigurować Cline do używania serwera Firebase MCP, zmodyfikuj plik cline_mcp_settings.json. Możesz otworzyć lub utworzyć ten plik, klikając ikonę Serwery MCP u góry panelu Cline, a potem 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, 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, zmodyfikuj ustawienia użytkownika, na przykład:
"mcp": {
"servers": {
"firebase": {
"type": "stdio",
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Windsurf
Aby skonfigurować Windsurf Editor, 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 kodowania AI skonfigurował Cloud Firestore, Firebase Authentication i Firebase Hosting.
Poproś agenta o skonfigurowanie usługi. Możesz na przykład użyć tych promptów:
- Skonfiguruj Cloud Firestore jako bazę danych tej aplikacji.
- Utwórz stronę logowania za pomocą Authentication i zaktualizuj Security Rules, aby tylko autoryzowani użytkownicy mogli odczytywać i zapisywać własne dane.
- Skonfiguruj Firebase Hosting i wdróż aplikację w środowisku produkcyjnym.
Sprawdź wszystkie informacje i wykonaj wszystkie kroki, które może podać agent, takie jak:
- Plany: agent proponuje strategię na podstawie istniejącej bazy kodu.
- Połączenia: agent łączy Twój kod lokalny z istniejącym projektem w Firebase lub pomaga utworzyć nowy projekt w Firebase.
- Inicjowanie zasobów: agent dodaje do bazy kodu wymagane biblioteki i konfigurację Firebase.
- Aktualizowanie plików: 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) lubfirebase.json(aby poinformować interfejs wiersza poleceń Firebase, które usługi mają zostać wdrożone i jak je skonfigurować). - Wykonywanie: agent przeprowadzi Cię przez dodatkowe kroki konfiguracji lub wdrożenia.
Ogólne wskazówki dotyczące promptów dla agenta kodowania AI
Aby w pełni wykorzystać możliwości agenta kodowania AI, zwłaszcza podczas pracy z wieloaspektowymi integracjami, takimi jak Firebase, traktuj interakcję jako współpracę, a nie jednorazowe polecenie.
Pisz konkretnie i podawaj kontekst
Chociaż serwer Firebase MCP zapewnia agentowi znaczący kontekst dotyczący Twojego projektu, najlepsze wyniki uzyskasz, używając jasnych i konkretnych promptów w języku naturalnym. Unikaj niejasnych próśb.
- Niejasne: "Napraw błąd bazy danych".
- Konkretne: "Podczas próby zapisu w
kolekcji „users” w Cloud Firestorepojawia się błąd „permission denied”. Sprawdź mój plik
firestore.rulesi zaproponuj poprawkę, która umożliwi uwierzytelnionym użytkownikom zapisywanie w ich własnym dokumencie”.
Iteruj i doprecyzuj
W przypadku złożonych zadań agenci kodowania AI rzadko generują idealny kod za pierwszym razem. Jeśli odpowiedź nie jest do końca prawidłowa, kontynuuj rozmowę:
- Podaj komunikaty o błędach: wklej do czatu wszystkie błędy terminala lub dzienniki konsoli.
- Poproś o wprowadzenie zmian: "Ten kod używa starszego pakietu SDK w wersji 8. Przepisz go za pomocą modułowego pakietu SDK Firebase w wersji 9”.
- Poproś o wyjaśnienia: "Wyjaśnij, jak te Firebase Security Rules chronią dane użytkowników."
Sprawdź przed wykonaniem
Agenci kodowania AI są potężni, 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 konfiguracyjne (np.
firebase.json). - Testuj lokalnie: jeśli to możliwe, poproś agenta o pomoc w testowaniu zmian lokalnie przed ich opublikowaniem.
Użyj połączenia MCP
Ponieważ serwer Firebase MCP zapewnia agentowi bezpośredni wgląd w strukturę projektu, 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.htmli pokaż, gdzie dodać standardowy skrypt inicjujący Firebase”.
Dalsze kroki
- Zapoznaj się z pełną listą wszystkich dostępnych umiejętności agenta Firebase.
- Zapoznaj się z pełną listą wszystkich dostępnych promptów, narzędzi i zasobów udostępnianych przez serwer Firebase MCP.
- Dowiedz się więcej o narzędziach udostępnianych przez interfejs wiersza poleceń Firebase CLI.