Billbee über MCP mit Meta Muse 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 + Meta Muse

Lass deine KI mit Billbee arbeiten: Bestellungen aus allen Marktplätzen und Shops nach Datum oder Marktplatz-Bestellnummer finden, Artikel per SKU oder EAN mit Preis und Bestand nachschlagen, die Bestellhistorie eines Kunden prüfen und deine Versandanbieter auflisten. Nur lesend, 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.

Nur lesen: Alle 8 Tools lesen nur Bestellungen, Artikel, Kunden und Versandanbieter. Der Connector kann in Billbee nichts anlegen oder ändern, für ein Nur-lesen-Setup musst du also nichts abschalten. Einzelne Tools kannst du trotzdem auf der Connector-Seite deaktivieren, zum Beispiel billbee_list_customers und billbee_get_customer_orders, wenn die KI keine Kundendaten sehen soll.

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 bearbeitet keine, ändert keine Bestellstatus und keine Bestände, erstellt keine Sendungen oder Versandlabels und keine Rechnungen oder anderen Dokumente.

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

Muse bindet Remote-MCP-Server als Custom Connectors ein und meldet sich per OAuth bei ihnen an.

1. Öffne in Muse Settings → Connectors und wähle Add custom connector.
2. Füge die MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein.
3. Muse öffnet die Anmeldeseite von AnythingMCP: Melde dich an und bestätige den Zugriff.
4. Bitte Muse im Chat um etwas, wofür es die Billbee-Tools braucht.

Du kannst den Connector auch per Chat einrichten, im Web, in den Apps für iOS und Android oder in WhatsApp. Schick Muse diese Nachricht:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Muse verbindet sich aus der Cloud von Meta, localhost funktioniert deshalb nicht.

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

FAQ

Wo ist Muse verfügbar? Meta bietet Muse derzeit in den USA und in Kanada an, im Web, in den Apps für iOS und Android und in WhatsApp.

Prüft Meta diesen Connector? Nein. Meta prüft Custom Connectors nicht. Muse sieht nur die Tools, die du in AnythingMCP für diesen MCP-Server eingeschaltet hast, und du kannst den Connector jederzeit unter Settings → Connectors trennen.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden