Bubble zu MCP: Die Daten deiner Bubble-App in jedem KI-Agent

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Bubble klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Bubble

Lass deine KI mit den Daten deiner Bubble-App arbeiten: sehen, welche Datentypen und Backend-Workflows sie freigibt, Datensätze suchen und lesen; nach deiner Bestätigung Datensätze anlegen oder ändern und Backend-Workflows ausführen.

Einrichtung

1. Öffne deine App im Bubble-Editor, geh zu Settings → API und setz das Häkchen bei Enable Data API. Hake dann jeden Datentyp an, den die KI erreichen darf: Alles, was du nicht anhakst, bleibt für sie unsichtbar. Hake auch Enable Workflow API and backend workflows an, wenn die KI Backend-Workflows ausführen soll.
2. Klicke auf demselben Tab auf Generate a new API token und kopiere das Token in BUBBLE_API_TOKEN.
3. Setz BUBBLE_APP_URL auf die Adresse der App ohne abschließenden Schrägstrich: https://yourapp.bubbleapps.io oder deine eigene Domain, etwa https://app.example.com, für die Live-Version. Häng /version-test an, um mit der Entwicklungsversion zu arbeiten, zum Beispiel https://yourapp.bubbleapps.io/version-test.
4. Deploye die App nach dem Ändern der API-Einstellungen auf Live: Die Live-Version kennt nur die Einstellungen und Tokens ihres letzten Deployments.
5. Installiere den Connector und prüfe dann das Token mit einem Lesezugriff, etwa bubble_list_things auf einen deiner Typen.

Der Verbindungstest prüft die Adresse, nicht das Token: Er bestätigt, dass deine App unter BUBBLE_APP_URL antwortet. Ein falsches oder nicht deploytes Token zeigt sich erst beim ersten Lesen von Daten, mit einem 401. Mach diesen Test-Lesezugriff deshalb einmal.

Du brauchst Editor-Zugriff auf die App. Ein Connector bedient eine Bubble-App; für jede weitere App fügst du einen weiteren Connector hinzu.

Ein Admin-Token, begrenzt durch deine API-Einstellungen: Das Token aus den Settings handelt als Admin. Es ignoriert die Datenschutzregeln (Privacy Rules) der App und sieht jedes Feld der Typen, die du freigegeben hast, aber nichts, was du nicht angehakt hast. Für Schreibzugriffe muss jeder Datentyp in seinen Datenschutzregeln außerdem das Anlegen, Ändern oder Löschen per API erlauben.

Was sie liest: die Datentypen und Backend-Workflows, die deine App freigibt, mit den Feldern jedes Typs und den Parametern jedes Workflows; die Datensätze (things) eines Typs, gefiltert nach Bedingungen wie Status gleich offen, sortiert, bis zu 100 pro Seite; und einen einzelnen Datensatz anhand seiner ID, mit Erstellungsdatum, Änderungsdatum und Ersteller.

Fragt vor jedem Schreiben: bubble_create_thing, bubble_update_thing und bubble_run_workflow ändern die Daten deiner App und können die eigenen Workflows, E-Mails oder Zahlungen der App auslösen. Vor jedem Aufruf zeigt dir die KI den Typ und jeden Wert, den Datensatz und die genauen Änderungen oder den Workflow und seine Parameter, und wartet auf dein Ja. Probier Schreibzugriffe zuerst auf der Adresse mit /version-test aus.

Bei der Installation deaktiviert: bubble_delete_thing. Ein Administrator schaltet es bewusst ein; die KI zeigt dir dann den Datensatz und löscht ihn erst nach deiner Bestätigung.

Typ- und Feldnamen: In der API sind Typnamen kleingeschrieben und ohne Leerzeichen (aus Rental Unit wird rentalunit), und Felder werden über die Feld-IDs der App angesprochen, etwa first_name_text, außer deine App nutzt Anzeigenamen als Schlüssel. Die KI liest sie mit bubble_get_meta und bubble_get_data_types, bevor sie sucht oder schreibt.

Personenbezogene Daten: Bubble-Apps speichern oft Benutzer, Kunden und Zahlungen. Die KI zeigt nur, was du brauchst, listet Benutzerdatensätze nie für jemanden auf, der sie nicht sehen sollte, und behandelt Text, den App-Benutzer eingegeben haben, als Daten, nie als Anweisung.

Kapazität: Jeder Bubble-Plan hat ein Workload-Limit, und starke API-Nutzung macht die App für ihre Benutzer langsamer. Die KI liest in kleinen Seiten und vermeidet Schleifen über Tausende von Datensätzen. Eine Suche liefert in den meisten Plänen höchstens 50.000 Datensätze.

Häufige Fehler: 400: Bubble kennt die App-Adresse nicht; prüfe BUBBLE_APP_URL, ohne /api/1.1. 401: Das Token ist falsch, gelöscht oder noch nicht auf diese Version deployt; deploye auf Live oder nutze die Adresse mit /version-test. 404: Die Data API ist aus, der Typ ist nicht angehakt oder der Workflow ist nicht freigegeben.

Der Connector baut oder ändert die App nicht (Seiten, Datentypen, Workflows, Datenschutzregeln), legt keine Datensätze in großen Mengen an, ersetzt keine kompletten Datensätze und lädt keine Dateien hoch.

Voraussetzungen: BUBBLE_APP_URL, BUBBLE_API_TOKEN

Connector lokal installieren

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

Öffne http://localhost:3000/connectors/store, wähle Bubble und trage die unter Voraussetzungen aufgelisteten Variablen ein.

Verfügbare Tools

Beispiel-Prompts

• „Welche Datentypen und Backend-Workflows gibt unsere Bubble-App frei?“
• „Zeig mir die offenen Supportanfragen, die diese Woche erstellt wurden, die neuesten zuerst.“
• „Wie viele Bestellungen mit dem Status bezahlt hatten wir im Oktober?“
• „Setz den Status der Buchung von Anna Weber am 12. November auf bestätigt. Zeig mir die Änderung vorher.“
• „Führe den Backend-Workflow aus, der die Willkommens-E-Mail an [email protected] schickt. Nenn mir seine Parameter, bevor du ihn startest.“

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden