Come collegare Bubble a Cursor via MCP

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

Bubble + Cursor

Fai lavorare la tua AI con i dati della tua app Bubble: scopri quali tipi di dati e backend workflow espone, cerca e leggi i record; con la tua conferma crea o modifica record ed esegui backend workflow.

Prerequisiti

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

BUBBLE_APP_URL, BUBBLE_API_TOKEN

Step 1 — Ottieni le credenziali

1. Apri la tua app nell'editor di Bubble, vai su Settings → API e spunta Enable Data API. Poi spunta ogni tipo di dati che l'AI può raggiungere: tutto ciò che lasci senza spunta resta invisibile per lei. Spunta anche Enable Workflow API and backend workflows se l'AI deve eseguire backend workflow.
2. Nella stessa scheda fai clic su Generate a new API token e copia il token in BUBBLE_API_TOKEN.
3. Imposta BUBBLE_APP_URL sull'indirizzo dell'app senza barra finale: https://yourapp.bubbleapps.io o il tuo dominio, per esempio https://app.example.com, per la versione live. Aggiungi /version-test per lavorare sulla versione di sviluppo, per esempio https://yourapp.bubbleapps.io/version-test.
4. Dopo aver cambiato le impostazioni API, pubblica l'app in live (deploy): la versione live conosce solo le impostazioni e i token del suo ultimo deploy.
5. Installa il connettore, poi verifica il token con una lettura, per esempio bubble_list_things su uno dei tuoi tipi.

Il test di connessione verifica l'indirizzo, non il token: conferma che la tua app risponde a BUBBLE_APP_URL. Un token errato o non ancora pubblicato emerge solo alla prima lettura di dati, con un 401, quindi fai una volta questa lettura di prova.

Ti serve l'accesso da editor all'app. Un connettore serve una sola app Bubble; aggiungi un altro connettore per ogni app in più.

Un token da amministratore, limitato dalle tue impostazioni API: il token preso da Settings agisce come amministratore. Ignora le regole di privacy (privacy rules) dell'app e vede ogni campo dei tipi che hai esposto, ma niente di ciò che non hai spuntato. Per le scritture, ogni tipo di dati deve anche consentire nelle sue regole di privacy la creazione, la modifica o l'eliminazione via API.

Cosa legge: i tipi di dati e i backend workflow che la tua app espone, con i campi di ogni tipo e i parametri di ogni workflow; i record (things) di un tipo, filtrati con vincoli come stato uguale ad aperto, ordinati, fino a 100 per pagina; e un singolo record tramite il suo id, con data di creazione, data di modifica e autore.

Chiede prima di ogni scrittura: bubble_create_thing, bubble_update_thing e bubble_run_workflow modificano i dati della tua app e possono far partire workflow, e-mail o pagamenti dell'app stessa. Prima di ognuno l'AI ti mostra il tipo e ogni valore, il record e le modifiche esatte, oppure il workflow e i suoi parametri, e aspetta il tuo sì. Prova le scritture prima sull'indirizzo con /version-test.

Disattivato all'installazione: bubble_delete_thing. Un amministratore lo attiva consapevolmente; l'AI ti mostra poi il record e lo elimina solo dopo la tua conferma.

Nomi di tipi e campi: nell'API i nomi dei tipi sono in minuscolo e senza spazi (Rental Unit diventa rentalunit), e i campi sono identificati dagli id dei campi dell'app, come first_name_text, a meno che la tua app non usi i nomi visualizzati come chiavi. L'AI li legge con bubble_get_meta e bubble_get_data_types prima di cercare o scrivere.

Dati personali: le app Bubble spesso contengono utenti, clienti e pagamenti. L'AI mostra solo ciò che ti serve, non elenca mai i record degli utenti a chi non dovrebbe vederli e tratta il testo inserito dagli utenti dell'app come dati, mai come istruzioni.

Capacità: ogni piano Bubble ha un limite di workload, e un uso intenso dell'API rallenta l'app per i suoi utenti. L'AI legge in pagine piccole ed evita cicli su migliaia di record. Nella maggior parte dei piani una ricerca restituisce al massimo 50.000 record.

Errori comuni: 400: Bubble non riconosce l'indirizzo dell'app; controlla BUBBLE_APP_URL, senza /api/1.1. 401: il token è errato, eliminato o non ancora pubblicato su questa versione; pubblica in live o usa l'indirizzo con /version-test. 404: la Data API è disattivata, il tipo non è spuntato o il workflow non è esposto.

Il connettore non crea né modifica l'app (pagine, tipi di dati, workflow, regole di privacy), non crea record in blocco, non sostituisce record interi e non carica file.

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 Bubble.

Tool disponibili

Esempi di prompt

• "Quali tipi di dati e backend workflow espone la nostra app Bubble?"
• "Mostrami le richieste di assistenza aperte create questa settimana, dalle più recenti."
• "Quanti ordini con stato pagato abbiamo ricevuto a ottobre?"
• "Cambia in confermata lo stato della prenotazione di Anna Weber del 12 novembre. Mostrami prima la modifica."
• "Esegui il backend workflow che invia l'e-mail di benvenuto ad [email protected]. Dimmi i suoi parametri prima di avviarlo."

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