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 wykorzystaniu umiejętności agenta Firebase w połączeniu z Firebase wierszem poleceń i serwerem Firebase MCP możesz przekształcić agenta do kodowania opartego na AI w specjalistę od Firebase, który może pisać kod, konfigurować Firebase Security Rules i zarządzać zasobami na żywo.
Ten przewodnik opisuje, jak używać agenta do kodowania opartego na AI, aby skonfigurować Cloud Firestore, 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?
Ogólne modele AI często mają problemy z konkretnymi konfiguracjami projektów lub nieaktualnymi informacjami. Ten zestaw narzędzi rozwiązuje ten problem:
- Umiejętności agenta Firebase: Umiejętności zapewniają agentowi do kodowania wiedzę specjalistyczną. Dzięki nim agent ma dostęp do aktualnej dokumentacji i optymalnych przepływów pracy, dzięki czemu wie, jak prawidłowo i zgodnie z zaleceniami Firebase skonfigurować architekturę.
- Serwer Firebase MCP: serwer MCP zapewnia agentowi do kodowania kontekst i dostęp. Ustanawia standardowy protokół, za pomocą którego agent może programowo sprawdzać aktywne zasoby projektu, pliki lokalne i konfiguracje.
- Firebase Wiersz poleceń: interfejs wiersza poleceń zapewnia agentowi do kodowania możliwość podejmowania działań. Jest to narzędzie do wykonywania zadań, którego agent używa do wykonywania złożonych zadań, takich jak inicjowanie baz danych, zarządzanie konfiguracjami uwierzytelniania użytkowników i wdrażanie kodu w Twoim imieniu.
Korzystanie z umiejętności agenta Firebase wraz z interfejsem wiersza poleceń Firebase i serwerem Firebase MCP daje agentowi do kodowania opartemu na 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ć 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 przeprowadzić agenta przez zadania konfiguracji.
- Zwiększenie dokładności: agent ma dostęp do środowiska i schematów projektu, dzięki czemu może udzielać bardziej trafnej i dokładnej pomocy.
- 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.
W których usługach Firebase mogą pomóc umiejętności i narzędzia agenta?
Ten przewodnik koncentruje się głównie na tym, jak umiejętności agenta, wiersz 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.
- Authentication: skonfiguruj bezpieczne logowanie użytkowników.
- Firebase Security Rules: generuj i dopracowuj Security Rules dla swojej aplikacji.
- Firebase Hosting: skonfiguruj projekt pod kątem wdrożenia statycznej aplikacji internetowej.
Pełną listę dostępnych funkcji znajdziesz w pełnej liście 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ą 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ą dostępne jako jeden z pakietów integracji Build with Google dla Antigravity. Włącz ten pakiet, korzystając z jednej z tych opcji:
- Podczas wdrażania: zaznacz pole wyboru stosu Firebase.
- W ustawieniach po wdrożeniu: kliknij Ustawienia > Dostosowania. W sekcji Build with Google Plugins kliknij Customize, a następnie Download w przypadku integracji z 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@firebaseOpcja 2. Aplikacja Codex
Wykonaj te zadania jednorazowo:
Zarejestruj się w terminalu:
codex plugin marketplace add firebase/agent-skillsUruchom ponownie aplikację Codex.
Otwórz Plugins (Wtyczki).
Wybierz Marketplace/źródło Firebase.
Otwórz Firebase i kliknij + Install (+ 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. 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 Firebase MCP
Chociaż wiele umiejętności agenta Firebase używa wiersza poleceń Firebase do wykonywania zadań, zalecamy połączenie agenta do kodowania opartego na 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 do kodowania opartego na AI o skonfigurowanie serwera Firebase MCP. Jeśli jednak agent ma problemy lub nie widzisz serwera Firebase MCP na liście, przejdź na metodę ręczną.
Metoda ręczna
Antigravity
Aby skonfigurować Antigravity do używania serwera Firebase MCP:
- W Antigravity kliknij menu w panelu Agent > MCP Servers (Serwery MCP).
- Kliknij Firebase > Install (Zainstaluj).
Spowoduje to automatyczne zaktualizowanie pliku mcp_config.json, który możesz wyświetlić, klikając Manage MCP Servers u góry panelu MCP Store > View raw config, o tę zawartość:
{
"mcpServers": {
"firebase-mcp-server": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
}
Firebase Studio
Aby skonfigurować Firebase Studio do używania serwera Firebase MCP, zmodyfikuj lub utwórz plik konfiguracji: .idx/mcp.json.
Jeśli plik jeszcze nie istnieje, utwórz go, klikając prawym przyciskiem myszy katalog nadrzędny i wybierając New file (Nowy plik). Dodaj do pliku tę zawartość:
{
"mcpServers": {
"firebase": {
"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:
Uruchom to polecenie w folderze aplikacji:
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 > Settings (Claude > Ustawienia). Kliknij kartę Developer (Deweloper), a następnie Edit Config (Edytuj konfigurację).
{
"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ę MCP Servers (Serwery MCP) u góry panelu Cline, a następnie klikając przycisk Configure MCP Servers (Skonfiguruj serwery MCP).
{
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"],
"disabled": false
}
}
}
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 zmodyfikuj plik
.cursor/mcp.json. - W przypadku wszystkich projektów (globalnie) zmodyfikuj plik
~/.cursor/mcp.json.
"mcpServers": {
"firebase": {
"command": "npx",
"args": ["-y", "firebase-tools@latest", "mcp"]
}
}
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 do kodowania oparty na AI skonfigurował Cloud Firestore, 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ć wiersz 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 do kodowania opartego na AI
Aby w pełni wykorzystać możliwości agenta do kodowania opartego na AI, zwłaszcza podczas pracy ze złożonymi 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 rozwiązanie, które umożliwi uwierzytelnionym użytkownikom zapisywanie w ich własnym dokumencie”.
Iteruj i doprecyzuj
W przypadku złożonych zadań agenci do kodowania opartego na 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 wszelkie błędy terminala lub logi 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 do kodowania opartego na 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 konfiguracji (np.
firebase.json). - Testuj lokalnie: jeśli to możliwe, poproś agenta o pomoc w testowaniu zmian lokalnie przed ich wprowadzeniem.
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ż mi, gdzie dodać standardowy skrypt inicjujący Firebase."
Dalsze kroki
- Przejrzyj pełną listę wszystkich dostępnych umiejętności agenta Firebase.
- Przejrzyj 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 wiersz poleceń Firebase CLI.