Billbee MCP mit ChatGPT verbinden

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

Billbee + ChatGPT

Lass deine KI mit Billbee arbeiten: Bestellungen aus allen Marktplätzen und Shops finden, Artikel per SKU oder EAN mit Preis und Bestand nachschlagen, die Bestellhistorie eines Kunden prüfen und Bestellungen bearbeiten: Status setzen, Trackingnummern hinterlegen, Versandlabels über die in Billbee angebundenen Versanddienstleister buchen, Bestände aktualisieren, Tags vergeben, Bestell- und Artikelfelder ändern und Rechnungen erstellen. Mit API-Key, Login-E-Mail und API-Passwort.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

BILLBEE_API_KEY, BILLBEE_LOGIN_EMAIL, BILLBEE_API_PASSWORD

Schritt 1 — Zugangsdaten holen

1. Melde dich bei Billbee an und öffne Einstellungen → Billbee API. Aktiviere dort in den allgemeinen Einstellungen den API-Zugriff und vergib ein API-Passwort. Das ist ein eigenes Passwort nur für die API, nicht dein Login-Passwort.
2. Fordere bei Billbee einen API-Key an: über das API-Anfrageformular oder per E-Mail an [email protected], mit einer kurzen Beschreibung, was du anbinden willst (hier: deine KI, die über AnythingMCP Bestellungen liest). Billbee schickt dir den Key zu.
3. Trage den Key in BILLBEE_API_KEY ein, die E-Mail-Adresse, mit der du dich bei Billbee anmeldest, in BILLBEE_LOGIN_EMAIL und das API-Passwort aus Schritt 1 in BILLBEE_API_PASSWORD.
4. Installiere den Connector. Es gibt keinen Schritt Authorize with Provider: Jeder Aufruf schickt den API-Key im Header X-Billbee-Api-Key und dazu E-Mail und API-Passwort per HTTP Basic Auth.
5. Beginne mit billbee_list_shipping_providers: Das Tool braucht keine Parameter und listet die Versandanbieter in deinem Konto. Kommt eine Antwort, passen alle drei Werte.

Drei Werte, alle Pflicht: Billbee lehnt einen Aufruf ab, der nur den API-Key oder nur E-Mail und API-Passwort mitbringt. Alle drei müssen im Connector eingetragen sein.

Angemeldet bleiben: Es gibt keine Tokens, die erneuert werden müssen; der Connector schickt die drei Werte bei jedem Aufruf mit. Wenn du das API-Passwort in Billbee änderst oder einen neuen API-Key bekommst, trag BILLBEE_API_PASSWORD bzw. BILLBEE_API_KEY auf der Connector-Seite neu ein.

Lesen und schreiben: 9 der 17 Tools lesen nur Bestellungen, Artikel, Kunden, Versandanbieter und Lager. Die anderen 8 ändern dein Live-Konto in Billbee, und Billbee gibt die meisten Änderungen an die angebundenen Shops und Marktplätze weiter. Alle 17 sind nach der Installation eingeschaltet. Für ein Nur-lesen-Setup schaltest du die schreibenden Tools auf der Connector-Seite ab; einzelne Lese-Tools kannst du ebenfalls deaktivieren, zum Beispiel billbee_list_customers und billbee_get_customer_orders, wenn die KI keine Kundendaten sehen soll.

Schreibende Tools:

• billbee_set_order_state setzt den Bestellstatus, zum Beispiel 3 bezahlt, 4 versendet, 8 storniert oder 13 gepackt. Der Shop oder Marktplatz schickt dem Käufer dann eventuell eine E-Mail.
• billbee_add_shipment_to_order hinterlegt eine Trackingnummer, die woanders erstellt wurde; es erstellt kein Label und ändert den Status nicht. billbee_ship_order_with_label bucht über einen in Billbee angebundenen Versanddienstleister (DHL, DPD, GLS, Deutsche Post und weitere) ein echtes, kostenpflichtiges Label auf deinem eigenen Vertrag; providerId und productId kommen aus billbee_list_shipping_providers, und die KI fragt dich vor dem Buchen.
• billbee_update_stock setzt den absoluten Bestand eines Artikels per SKU, keine Differenz; bei mehreren Lagern braucht es die stockId aus billbee_list_stocks. Billbee schickt den neuen Bestand an deine Shops und Marktplätze.
• billbee_add_order_tags vergibt Tags an eine Bestellung. billbee_update_order und billbee_update_product ändern nur die übergebenen Felder, mit den Feldnamen, die billbee_get_order und billbee_get_product liefern, etwa SellerComment oder Price.
• billbee_create_invoice erstellt die Rechnung zu einer Bestellung mit deiner Rechnungsvorlage, höchstens einmal pro Bestellung alle 5 Minuten, und kann das PDF mitliefern.

Die schreibenden Tools erwarten die interne Billbee-Bestell-ID, nicht die Shop-Bestellnummer: billbee_get_order_by_extref findet die ID zu einer Marktplatz-Bestellnummer.

Bestellungen: billbee_list_orders filtert nach Bestelldatum (minOrderDate, maxOrderDate) und nach letzter Änderung (modifiedAtMin, modifiedAtMax), mit Datumsangaben im Format ISO 8601 wie 2026-01-01. billbee_get_order liefert die vollständige Bestellung mit Positionen, Adressen, Zahlungs- und Versanddaten anhand der Billbee-Bestell-ID. billbee_get_order_by_extref findet eine Bestellung über die Bestellnummer des Marktplatzes oder Shops, etwa eine Amazon- oder eBay-Bestellnummer. Bestellstatus kommen als Zahlen zurück.

Artikel und Kunden: billbee_get_product schlägt einen Artikel über seine Billbee-ID nach, oder über SKU bzw. EAN, wenn lookupBy auf sku oder ean steht, und liefert Preise und Bestand. billbee_list_products lässt sich auf Artikel beschränken, die nach einem Datum angelegt wurden (minCreatedAt). billbee_list_customers hat keine Suche: Wer einen Kunden nach Namen sucht, blättert durch die Liste. Mit der Kunden-ID listet billbee_get_customer_orders die Bestellungen dieses Kunden.

Seiten und Rate-Limits: Listen-Tools liefern bis zu 250 Zeilen pro Seite (pageSize), mit Page, TotalPages und TotalRows in der Antwort; die KI fragt die nächste page ab, bis sie die letzte erreicht. Billbee erlaubt 2 Anfragen pro Sekunde je API-Key und Benutzer und antwortet darüber mit 429: Warte kurz und versuche es erneut. Billbee berechnet API-Nutzung oberhalb eines kostenlosen Kontingents, deshalb sind enge Zeiträume und modifiedAtMin besser, als immer wieder alles abzurufen.

Häufige Fehler: Lehnt Billbee die Zugangsdaten ab, prüfe, ob alle drei Variablen gesetzt sind, ob der API-Zugriff unter Einstellungen → Billbee API aktiviert ist und ob in BILLBEE_API_PASSWORD das API-Passwort steht und nicht dein Login-Passwort. 429 heißt, dass das Limit von 2 Anfragen pro Sekunde erreicht wurde.

Der Connector legt keine Bestellungen an und löscht keine, legt keine Kunden an und ändert keine, und er legt keine Artikel an und löscht keine.

Schritt 2 — Adapter 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

Schritt 3 — Connector in ChatGPT hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.

1. Geh zu chatgpt.com/plugins, klicke auf Add und dann auf Add custom MCP server.
2. Gib einen Namen ein, z. B. Name: Billbee.
3. Trag unter Connection als Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein und lass Authentication auf OAuth.
4. Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
5. Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.

Verfügbare Tools

Beispiel-Prompts

• „Welche Bestellungen sind in den letzten 7 Tagen eingegangen, und welche davon sind noch nicht versendet?“
• „Finde die Bestellung mit der Marktplatz-Bestellnummer 302-1234567-1234567 und zeig mir die Positionen, die Lieferadresse und die Zahlungsdaten.“
• „Wie viele Stück von SKU ABC-123 haben wir auf Lager, und was ist der Verkaufspreis?“
• „Liste alle Bestellungen des Billbee-Kunden 4567 mit Datum und Summe auf, die neuesten zuerst.“
• „Setz die Amazon-Bestellung 302-1234567-1234567 auf versendet und hinterleg die DHL-Trackingnummer 00340434161234567890.“
• „Erstell über Billbee ein DHL-Label für die eBay-Bestellung 14-12688-90311 und danach die Rechnung.“

FAQ

Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden