MCP & API-Zugang

BirdBuild in Claude verbinden (empfohlen)

Geh auf Studio → Einstellungen → Integrationen und klick auf „Mit Claude verbinden“.

• Ein Klick: Claude öffnet sich im neuen Tab mit dem Dialog „Benutzerdefinierten Connector hinzufügen“ – Name BirdBuild und Adresse https://birdbuild.net/mcp sind schon eingetragen. Das klappt am Computer, Tablet und Handy. Der Konnektor gilt für dein ganzes Claude-Konto und steht danach auch in der Claude-App bereit.
• Lieber direkt in der Claude-App (Mac/Windows, „In der Claude-App einrichten“): Die App öffnet sich bei den Connectors und die Adresse ist schon kopiert. Rechts oben auf „Hinzufügen“ › „Benutzerdefinierten Connector hinzufügen“, Name BirdBuild, Adresse einfügen. Vorausfüllen lässt die Claude-App von außen nicht zu – deshalb ist der Weg über den Browser der schnellere.

Dann alles so lassen, wie Claude es erkennt – Authentifizierung „Jetzt anmelden“, OAuth-Client „Claudes veröffentlichte Identität verwenden“, Request-Header leer – und „Hinzufügen“, danach „Verbinden“.

Admin einer Claude-Organisation? Über „Für dein ganzes Claude-Team (Admins)“ fügst du BirdBuild gleich für alle hinzu; jede Person verbindet danach ihr eigenes BirdBuild-Konto. Öffnet sich der Dialog nicht, geh in Claude zu den Connectors, wähle „Benutzerdefinierten Connector hinzufügen“ und füge die Konnektor-Adresse aus der Karte ein.

Claude schickt dich dann zu BirdBuild. Bist du noch nicht angemeldet, meldest du dich an – mit Passwort, Code, Link oder Zwei-Faktor, ganz wie gewohnt; auch eine neue Registrierung führt nach der Bestätigung direkt zurück. Danach zeigt BirdBuild eine kurze Seite: welche App, wohin weitergeleitet wird und welches Konto verbunden wird. Ein Klick auf „Erlauben“, und du landest automatisch wieder in Claude. BirdBuild steht jetzt unter Konnektoren – in claude.ai, Claude Desktop, der App am Handy und in Cowork.

In Claude Code reicht ein Befehl: claude mcp add --transport http birdbuild https://birdbuild.net/mcp. Beim ersten Benutzen öffnet sich der Browser zum Anmelden und Erlauben.

Hast du dieselbe App schon einmal erlaubt, fragt BirdBuild beim erneuten Verbinden nicht noch einmal – es geht ohne Klick zurück zu Claude.

BirdBuild in ChatGPT verbinden

Unter Studio → Einstellungen → Integrationen ChatGPT wählen und auf „Mit ChatGPT verbinden“ klicken. ChatGPT öffnet sich bei Plugins (nur im ChatGPT-Web), die Adresse https://birdbuild.net/mcp ist schon kopiert.

• Auf „+“ und „Add custom MCP server“ klicken.
• Name BirdBuild, bei Server URL die Adresse einfügen, Authentifizierung OAuth lassen – sonst nichts eintragen.
• „I understand and want to continue“ → „Create as a plugin“ → Plugin installieren.

ChatGPT schickt dich zu BirdBuild: anmelden, „Erlauben“ – und du landest wieder in ChatGPT. Im Chat sprichst du BirdBuild mit @BirdBuild an. Ob eigene MCP-Server möglich sind, hängt von deinem ChatGPT-Konto bzw. den Workspace-Einstellungen ab.

Wer verbinden darf

Verbinden kann der Inhaber des Kontos – dieselben Personen, die auch API-Tokens anlegen. Team-Mitglieder und die Kundenansicht (Agentur/Support) können nicht verbinden. MCP & API-Zugang ist ab dem Tarif Business enthalten, in der Testphase ebenfalls. Fehlt er, zeigt BirdBuild einen Knopf zum Tarifwechsel – nach dem Wechsel geht die Verbindung automatisch weiter.

Verbundene Apps und Trennen

Unter Einstellungen → Integrationen steht „Verbunden mit Claude“ bzw. „Verbunden mit ChatGPT“ samt Liste der verbundenen Apps mit „verbunden seit“ und „zuletzt genutzt“. „Trennen“ beendet den Zugriff sofort. Verbindest du eine App neu (Klick auf „Erlauben“), bekommst du eine E-Mail mit App, Zeitpunkt, Gerät und ungefährem Ort – warst du das nicht, führt dich der Knopf „Verbundene Apps ansehen“ direkt zum Trennen. Claude und ChatGPT erneuern ihre Anmeldung von selbst; ein kurzer Netzwerk-Aussetzer trennt dabei nichts, ein später erneut benutztes altes Anmelde-Token dagegen trennt die Verbindung sicherheitshalber. Setzt du dein Passwort zurück oder änderst es (andere Geräte werden abgemeldet), werden die Verbindungen ebenfalls getrennt – in Claude bzw. ChatGPT verbindest du dann einfach neu.

Was Claude und ChatGPT können

Alles, was du im Studio im Browser machst – mit denselben Rechten wie du: Websites, Seiten, Header, Popups, SEO, Domains und Übersetzungen; Blog, Medien, Formulare und Funnels; Kontakte, Listen, Tags und Zugangsgruppen; E-Mail-Kampagnen, Vorlagen, Automatisierungen und System-Mails; Shop mit Produkten, Bestellungen, Rabatten und Einstellungen; Termine, Leistungen und Veranstaltungen; Communitys mit Kursen, Beiträgen und Mitgliedern; Projekte, Team und Agentur. Löschen, Versenden und Veröffentlichen sind als solche gekennzeichnet, damit Claude bzw. ChatGPT vorher nachfragt. Tarif-Grenzen, Team-Bereiche und eine Kontosperre gelten genauso wie im Browser.

Vorschau im Chat: Baut oder ändert Claude bzw. ChatGPT eine Seite, einen Blog-Beitrag oder eine Kampagne, erscheint das Ergebnis direkt im Chat – Seiten und Beiträge als Entwurf im Design deiner Website, Mails mit Betreff, Vorschautext und Absender, jeweils umschaltbar zwischen Desktop und Handy. „Im Baukasten öffnen“ bzw. „Im Studio öffnen“ springt zum Bearbeiten. Zeigen statt beschreiben: Klick in der Seiten-Vorschau auf eine Überschrift, ein Bild oder eine Sektion – sie wird pink markiert und Claude weiß genau, was gemeint ist. Dann einfach „mach das größer“ schreiben oder direkt oben im Feld eintippen, was sich ändern soll.

Fertige Abläufe: Im Menü des BirdBuild-Konnektors stehen Befehle wie „Website erstellen“, „Newsletter schreiben“, „Blog-Beitrag schreiben“, „Shop einrichten“, „Website-Check“ und „Online-Termine einrichten“. Sie fragen fehlende Angaben selbst ab und führen Schritt für Schritt bis zum Ergebnis – veröffentlicht oder versendet wird erst nach deiner Zustimmung.

Statistik als Diagramm: Fragst du nach Besuchern, Shop-Umsatz oder den Ergebnissen einer Kampagne, erscheinen Kennzahlen mit Vergleich zum Vorzeitraum, ein Verlauf und die Top-Listen direkt im Chat.

Knöpfe in den Vorschauen: In der Mail-Vorschau schickt „Testmail an mich“ die Kampagne an deine eigene Adresse, in der Seiten- und Beitrags-Vorschau stellt „Veröffentlichen“ alles live – beides erst nach einer Rückfrage.

Website-Check: „Prüf meine Website“ genügt: Claude prüft SEO, Barrierefreiheit (Alternativtexte, Überschriften, Buttons, Farbkontraste), Ladezeit (Google PageSpeed, nur veröffentlicht) und Rechtstexte und zeigt eine Liste nach Wichtigkeit. „SEO automatisch optimieren“ setzt Seitentitel, Beschreibungen, Alternativtexte, Vorschaubild und Favicon in einem Schritt (rückgängig machbar); mit „Beheben“ erledigt Claude die übrigen Punkte gleich.

Immer der neueste Stand: Was Claude oder ChatGPT ändert, siehst du in BirdBuild sofort – auch wenn der Baukasten, eine Kampagne oder Einstellungen gerade offen sind. Hast du dort nichts Ungespeichertes, lädt BirdBuild den neuen Stand von selbst („Neueste Version geladen“). Arbeitest du gerade selbst daran, bleibt deine Arbeit stehen und ein Hinweis bietet „Neueste laden“ an – nichts wird still überschrieben, in keine Richtung.

Bausteine statt Code: Claude und ChatGPT bauen mit den echten Bausteinen des Baukastens statt mit HTML-Code. So bleibt alles, was sie erstellen, im Baukasten anpassbar. Code-Module gibt es nur, wenn du ausdrücklich eine Einbettung oder ein fremdes Widget willst.

Was nur im Browser geht

Aus Sicherheitsgründen nie über eine Verbindung: Passwort, Login-E-Mail, Zwei-Faktor, Geräte, API-Tokens und verbundene Apps; Abo, Add-ons und Zahlungsarten; Zugangsdaten von Zahlungs- und SMS-Anbietern; Google-, Apple-, Instagram- und Facebook-Konten verbinden; Personen ins Team einladen oder ihren Zugriff erweitern; Bankverbindung und Fußnote der Shop-Rechnungen; die Zieladresse der Benachrichtigungen und die Test-Umleitung aller Mails; die Kundenansicht von Agenturen. Während Wartungsarbeiten ändert eine Verbindung nichts, lesen geht weiter. Den Ultra-Admin-Bereich erreicht eine Verbindung nie.

Ältere Verbindungen

Verbindungen, die vor dem Ausbau auf alle Studio-Funktionen erlaubt wurden, gelten weiter nur für Websites, Seiten, Medien und Projekte. In der Liste der verbundenen Apps steht dann „Eingeschränkt – neu verbinden“: Über „Neu verbinden“ trennst du BirdBuild in Claude bzw. ChatGPT und verbindest es wieder – nach dem Klick auf „Erlauben“ steht alles zur Verfügung.

API-Token für eigene Programme

Geh auf Studio → Einstellungen (/studio/einstellungen) und scroll runter zum Abschnitt „Integrationen“. Dort findest du die Karte „API & Zugangsdaten“. Tipp ins Feld einen sprechenden Namen ein, damit du später weißt, wozu der Token gehört (zum Beispiel „Import-Skript“), und klick auf „Token erstellen“. Zur Sicherheit bestätigst du das mit dem Code aus deiner E-Mail.

Der Token wird dir jetzt genau einmal im Klartext angezeigt und beginnt immer mit bb_. Klick auf „Kopieren“ und leg ihn sofort an einem sicheren Ort ab. Danach klickst du auf „Gesichert – ausblenden“. Später lässt er sich nicht erneut einsehen – aus Sicherheitsgründen speichert BirdBuild nur einen verschlüsselten Fingerabdruck, nie den Token selbst.

Tokens verwalten und widerrufen

Unter dem Eingabefeld listet BirdBuild alle deine Tokens auf: Name, die ersten Zeichen zur Wiedererkennung (zum Beispiel bb_1a2b3c…), das Erstelldatum und wann der Token zuletzt benutzt wurde. So erkennst du schnell, welcher Token noch aktiv ist. Ein Token gilt fürs gesamte Konto, nicht nur für ein einzelnes Projekt.

Willst du einen Token abschalten, klick in der Liste auf „Widerrufen“ und bestätige die Rückfrage. Der Token wird sofort ungültig, und jedes Programm, das ihn nutzt, verliert augenblicklich den Zugriff. Wenn ein Token versehentlich öffentlich geworden ist, widerrufst du ihn hier und erstellst einfach einen neuen. Ein API-Token schaltet übrigens nie den Ultra-Admin-Bereich frei – er arbeitet immer nur mit deinen normalen Konto-Rechten.

Für Entwickler: MCP mit API-Token

Ohne Anmeldefenster – etwa in Skripten oder CI – verbindest du dieselbe Adresse mit einem Token: claude mcp add --transport http birdbuild https://birdbuild.net/mcp --header "Authorization: Bearer bb_…". Ein lokaler stdio-Server mit denselben Werkzeugen liegt im BirdBuild-Quellcode (Ordner mcp); den brauchst du nur bei eigenen Installationen.

Eigene Programme anbinden

Neben dem Konnektor kann jedes eigene Skript oder Werkzeug die BirdBuild-API auch direkt ansprechen. Schick deine Anfragen an die Endpunkte unter /server/… (alle Studio-Bereiche, zum Beispiel Kontakte, Bestellungen, Kampagnen oder Websites) und leg deinen Token als Kopfzeile Authorization: Bearer bb_… bei. BirdBuild erkennt den Token, ordnet ihn deinem Konto zu und behandelt die Anfrage so, als wärst du angemeldet – mit denselben Rechten und denselben Ausnahmen wie beim Konnektor.

Weil ein Token die volle Berechtigung deines Kontos hat, gib ihn nie in fremde Hände, häng ihn nicht an eine URL an und leg ihn nicht in einem öffentlichen Code-Verzeichnis ab. Am saubersten ist es, für jedes Werkzeug einen eigenen, benannten Token zu erstellen – so kannst du einen einzelnen jederzeit widerrufen, ohne die anderen zu stören.