Come collegare Firebase a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Firebase, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Firebase + Cursor

Fai lavorare la tua AI con Firebase: elenca progetti e app, sfoglia e interroga Cloud Firestore, crea e aggiorna documenti, cerca e disattiva utenti di Authentication, leggi Remote Config e (funzioni disattivate per impostazione predefinita) pubblica Remote Config o invia notifiche push. Accede con il tuo account Google.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

Step 1 — Ottieni le credenziali

1. Apri console.cloud.google.com e seleziona il progetto Google Cloud del tuo progetto Firebase (ha lo stesso project id). Creare lì il client OAuth è la via più semplice, perché le chiamate API vengono conteggiate sul progetto del client e quel progetto deve avere le API abilitate.
2. Vai su APIs & Services → Library e abilita le API che userai: Firebase Management API, Cloud Firestore API, Identity Toolkit API, Firebase Remote Config API e Firebase Cloud Messaging API.
3. Apri APIs & Services → OAuth consent screen. Scegli Internal se usi Google Workspace (la via più semplice), altrimenti External. Con External imposta lo stato di pubblicazione su In production: finché l'app è in Testing, Google revoca i refresh token dopo 7 giorni e il connettore smette di funzionare ogni settimana.
4. Apri APIs & Services → Credentials → Create credentials → OAuth client ID, scegli il tipo di applicazione Web application e aggiungi l'URI di reindirizzamento autorizzato https://cloud.anythingmcp.com/api/mcp-oauth/callback. Se ospiti AnythingMCP in proprio, inserisci invece https://tuo-host-anythingmcp/api/mcp-oauth/callback.
5. Inserisci il client ID in GOOGLE_CLIENT_ID e il client secret in GOOGLE_CLIENT_SECRET, installa il connettore, poi clicca su Authorize with Provider e accedi con un account che sia membro del progetto Firebase.

Un solo client Google per tutti i connettori Google: lo stesso progetto Cloud e lo stesso client OAuth servono tutti i connettori Google, da Gmail e Google Sheets fino a Search Console e BigQuery. Abilita ogni API in quel progetto, riusa lo stesso client ID e lo stesso secret e autorizza ogni connettore una volta.

Scope e ruoli: il connettore chiede https://www.googleapis.com/auth/cloud-platform, perché gli scope Firebase più ristretti non coprono l'amministrazione degli utenti e Remote Config. Ciò che l'AI può fare è limitato dai ruoli dell'account nel progetto: per un uso in sola lettura assegnagli Firebase Viewer e Cloud Datastore Viewer; per le modifiche servono ruoli come Cloud Datastore User, Firebase Authentication Admin, Firebase Remote Config Admin e Firebase Cloud Messaging Admin.

Cosa fa: elenca i progetti e le loro app Android, iOS e web; sfoglia raccolte e documenti di Firestore e li interroga con filtri, ordinamento e un limite; crea e aggiorna documenti; cerca ed elenca gli utenti di Authentication e ne disattiva o riattiva l'accesso; legge il template di Remote Config e la cronologia delle sue versioni.

Le modifiche aspettano il tuo sì: prima di firebase_create_document, firebase_update_document o firebase_set_user_disabled, l'AI ti dice esattamente cosa cambierà e aspetta un sì chiaro. Le modifiche arrivano subito alla tua app in produzione. Le regole di sicurezza di Firestore qui non si applicano: il connettore agisce con i diritti dell'account con cui hai effettuato l'accesso, come l'Admin SDK.

Disattivati all'installazione: firebase_delete_document (elimina in modo definitivo), firebase_publish_remote_config (sostituisce la configurazione attiva di ogni app) e firebase_send_message (invia una vera notifica push a dispositivi reali). Un amministratore li attiva uno per uno se servono; anche allora l'AI verifica prima la modifica con un'esecuzione di convalida e pubblica o invia solo dopo il tuo sì.

Le letture di Firestore si pagano: ogni documento restituito conta come una lettura nella tua fattura Firebase, quindi l'AI tiene le pagine piccole (20 documenti per impostazione predefinita) e chiede solo i campi che le servono. Un filtro su un campo combinato con l'ordinamento su un altro richiede un indice composito, e il messaggio di errore contiene il link alla pagina che lo crea. Hash e salt delle password degli utenti non vengono mai restituiti.

Non incluso: Crashlytics non ha un'API REST pubblica documentata, quindi i dati sui crash non sono disponibili. Anche file di Cloud Storage, Realtime Database, Data Connect, App Check e Analytics sono esclusi.

Errori comuni: 401 significa che l'autorizzazione è scaduta o è stata revocata: clicca di nuovo su Authorize with Provider. 403 PERMISSION_DENIED con "API has not been used in project" o SERVICE_DISABLED: abilita quell'API nel progetto Cloud del client OAuth; gli altri 403 significano che all'account manca il ruolo. 404: project id, database id o percorso sbagliato (un percorso di documento dove è atteso un percorso di raccolta, o viceversa). 400 FAILED_PRECONDITION "The query requires an index": apri il link nel messaggio per creare l'indice. 409 alla pubblicazione di Remote Config: nel frattempo il template è cambiato, quindi l'AI lo rilegge. 429: è stata raggiunta una quota; attendi e riprova.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Firebase.

Tool disponibili

Esempi di prompt

• "Elenca i miei progetti Firebase e le app Android, iOS e web di ciascuno."
• "In Firestore, mostrami i dieci documenti più recenti in orders con lo stato open."
• "Esiste un utente con l'email [email protected] in Firebase Authentication? Quando ha effettuato l'ultimo accesso?"
• "Disattiva l'accesso per l'account [email protected]. Dimmi di quale account si tratta prima di farlo."
• "Cosa contiene il nostro template di Remote Config e chi ha pubblicato le ultime tre versioni?"

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT