Billbee MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot 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.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Billbee-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, 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.“
• „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

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

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