Integrare i servizi Firebase utilizzando l'assistenza AI

Semplifica la configurazione di Firebase per le app web utilizzando strumenti di sviluppo basati sull'AI come Antigravity, Claude Code, Codex e Cursor. Utilizzando le competenze dell'agente Firebase insieme all'interfaccia a riga di comando Firebase e al server MCP Firebase, puoi trasformare il tuo agente di programmazione AI in un esperto Firebase specializzato in grado di scrivere codice, configurare Firebase Security Rules e gestire le risorse live.

Questa guida illustra l'utilizzo di un agente di codifica AI per configurare Cloud Firestore, Firebase Authentication e Firebase Hosting per un'app web. Torna a trovarci presto per informazioni su app per iOS, Android e Flutter.

Perché utilizzare le skill e gli strumenti dell'agente Firebase?

Gli agenti di programmazione AI spesso hanno difficoltà con configurazioni di progetto specifiche o informazioni obsolete. Questo toolkit colma questa lacuna combinando istruzioni specializzate (skill dell'agente) con due tipi complementari di strumenti di esecuzione dell'agente (CLI e server MCP):

• Skill dell'agente Firebase: forniscono all'agente di programmazione competenze e flussi di lavoro del dominio. In qualità di livello di istruzioni, le skill guidano l'agente sulle best practice per l'utilizzo di Firebase, inclusa la scrittura di codice. Le competenze insegnano anche all'agente quando e come utilizzare l'interfaccia a riga di comando Firebase e il server MCP di Firebase.
• Strumenti di esecuzione degli agenti:
  • CLI Firebase (strumenti a riga di comando): fornisce strumenti per il ciclo di vita del progetto e le attività dell'ambiente. L'agente può eseguire comandi CLI in un ambiente terminale per configurare i servizi in un progetto Firebase, eseguire il deployment di siti completi o risorse di backend, avviare emulatori locali e altro ancora.
  • Server MCP Firebase (strumenti e risorse programmatici): Fornisce strumenti per l'ispezione e le operazioni sui dati in tempo reale. Tramite chiamate di strumenti strutturate, l'agente può eseguire query e aggiornamenti in modo programmatico sui documenti Cloud Firestore, gestire gli utenti Firebase Authentication, convalidare Security Rules, estrarre log o documentazione in tempo reale direttamente nel contesto e altro ancora.

L'utilizzo delle competenze dell'agente Firebase insieme all'interfaccia a riga di comando Firebase e al server MCP Firebase offre al tuo agente di programmazione AI ulteriori funzionalità:

• Passa all'azione: non limitarti a scrivere codice. Il tuo agente può inizializzare i servizi, gestire gli utenti Firebase Authentication, eseguire il deployment di nuovi Firebase Security Rules e lavorare direttamente con i tuoi dati Cloud Firestore.
• Rimani al passo: utilizza prompt ufficiali e consapevoli della versione per guidare l'agente durante le attività di configurazione.
• Migliorare l'accuratezza: accedi all'ambiente e agli schemi del tuo progetto per fornire un aiuto più pertinente e accurato.
• Ridurre i costi dei token: le skill dell'agente caricano la documentazione dettagliata solo quando un'attività specifica lo richiede, il che riduce al minimo l'overhead della sessione.

Servizi Firebase applicabili

Questa guida si concentra principalmente su come le skill dell'agente, la CLI Firebase e il server MCP di Firebase funzionano insieme per aiutarti a configurare rapidamente questi servizi e queste funzionalità:

• Cloud Firestore: esegui il provisioning di un database NoSQL.
• Firebase Authentication: configura l'accesso sicuro degli utenti.
• Firebase Security Rules: genera e perfeziona Security Rules per la tua app.
• Firebase Hosting: configura il progetto per il deployment dell'app web statica.

Per un elenco completo di ciò che è disponibile, consulta l'elenco completo delle competenze dell'agente Firebase.

Flusso di lavoro generale

I passaggi seguenti descrivono un flusso di lavoro generalizzato per l'utilizzo delle skill dell'agente Firebase per configurare e utilizzare i servizi Firebase in un'app web. Dietro le quinte, le skill dell'agente utilizzano la CLI Firebase e il server MCP Firebase per completare queste attività.

Passaggio 1: installa le skill dell'agente Firebase

Nella maggior parte dei casi, puoi installare le skill dell'agente Firebase nel tuo editor preferito con un unico prompt:

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

npx skills add firebase/agent-skills

Passaggio 2: connettiti al server MCP di Firebase

Sebbene molte competenze dell'agente Firebase utilizzino la CLI Firebase per le attività, è consigliabile anche connettere l'agente di codifica AI al server MCP Firebase. Questa connessione migliora la capacità dell'agente di interagire con l'ambiente Firebase, fornendo un'integrazione e un accesso più profondi.

Metodo assistito dall'AI

Nella maggior parte dei casi, puoi chiedere al tuo agente di programmazione AI di configurare il server Firebase MCP. Tuttavia, se ha difficoltà o non vedi il server MCP Firebase nell'elenco, passa al metodo manuale.

Metodo manuale

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

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

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

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

"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"]
    }
  }
}

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

Passaggio 3: inizializza i servizi Firebase

Una volta configurate le competenze e gli strumenti dell'agente, puoi utilizzare il linguaggio naturale per fare in modo che l'agente di programmazione AI configuri Cloud Firestore, Firebase Authentication e Firebase Hosting.

1. Chiedi all'agente di configurare un servizio. Ad esempio, puoi utilizzare prompt come questi:

   • Configura Cloud Firestore come database per questa app.
   • Crea una pagina di accesso utilizzando Authentication e aggiorna Security Rules per assicurarti che solo gli utenti autorizzati possano leggere e scrivere i propri dati.
   • Configura Firebase Hosting ed esegui il deployment dell'app in produzione.

2. Esamina le informazioni e segui i passaggi guidati che l'agente potrebbe fornirti, ad esempio:

   1. Piani: l'agente propone una strategia basata sulla tua codebase esistente.
   2. Connessioni: il tuo agente collega il codice locale a un progetto Firebase esistente o ti aiuta a crearne uno nuovo.
   3. Inizializza le risorse: l'agente aggiunge le librerie e la configurazione Firebase richieste al codebase.
   4. File di aggiornamento: l'agente crea e aggiorna tutti i file necessari, come firestore.rules (per definire chi può leggere, scrivere o eseguire query sui dati all'interno del database) o firebase.json (per comunicare alla CLI Firebase quali servizi distribuire e come configurarli).
   5. Esegue: l'agente ti guida attraverso ulteriori passaggi di configurazione o deployment.

Suggerimenti generali per la creazione di prompt per un agente di programmazione AI

Per ottenere il massimo dal tuo agente di codifica AI, soprattutto quando lavori con integrazioni sfaccettate come Firebase, considera l'interazione come una collaborazione piuttosto che un comando singolo.

Fornisci informazioni specifiche e un contesto

Anche se il server Firebase MCP fornisce all'agente un contesto significativo sul tuo progetto, i prompt in linguaggio naturale chiari e specifici producono i risultati migliori. Evita richieste vaghe.

• Vago: "Correggi l'errore del database".
• Specifico: "Ricevo l'errore "Autorizzazione negata" quando tento di scrivere nella raccolta "users" in Cloud Firestore. Rivedi il mio firestore.rules e suggerisci una correzione che consenta agli utenti autenticati di scrivere nel proprio documento."

Itera e perfeziona

Gli agenti di programmazione AI raramente generano codice perfetto al primo tentativo per attività complesse. Se una risposta non è del tutto corretta, continua la conversazione:

• Fornisci i messaggi di errore: incolla eventuali errori del terminale o log della console nella chat.
• Richiedi modifiche: "Questo codice utilizza l'SDK v8 precedente. Riscrivilo utilizzando l'SDK modulare Firebase v9."
• Richiedi spiegazioni: "Spiega in che modo questi Firebase Security Rules proteggono i dati degli utenti".

Verifica prima di eseguire

Gli agenti di programmazione AI sono potenti, ma possono commettere errori o "avere allucinazioni" (inventare funzioni o servizi con nomi errati).

• Rivedi il codice: leggi sempre il codice generato, in particolare i file di configurazione (come firebase.json) e Firebase Security Rules, prima di eseguire il deployment in produzione.
• Testare localmente: quando possibile, chiedi all'agente di aiutarti a testare le modifiche localmente prima di pubblicarle.

Utilizzare la connessione MCP

Poiché il server Firebase MCP offre all'agente visibilità diretta sulla struttura del progetto, puoi fare riferimento a file specifici per ricevere consigli di implementazione personalizzati.

• Esempio: "Guarda il mio file src/web/index.html e mostrami dove aggiungere lo script di inizializzazione standard di Firebase."

Passaggi successivi

• Sfoglia un elenco completo di tutte le skill dell'agente Firebase disponibili.
• Sfoglia un elenco completo di tutti i prompt, gli strumenti e le risorse disponibili forniti dal server MCP di Firebase.
• Scopri di più sugli strumenti forniti dall'interfaccia a riga di comando Firebase.