easybill über MCP mit Meta Muse verbinden

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

easybill + Meta Muse

Lass deine KI mit deinem easybill-Konto arbeiten: Kunden finden und neu anlegen, Rechnungen, Gutschriften, Angebote, Zahlungserinnerungen und Lieferscheine nach Kunde, Datum oder Zahlungsstatus auflisten, Positionen und Summen lesen, Belege als PDF abrufen und deinen Artikelkatalog durchsuchen. Mit einem API-Schlüssel aus deinem easybill-Profil.

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:

EASYBILL_API_KEY

Schritt 1 — Zugangsdaten holen

1. Melde dich bei easybill an, klicke oben rechts auf dein Benutzersymbol und wähle Profil und Einstellungen.
2. Klicke im Fenster, das sich öffnet, im Bereich für den API-Schlüssel auf Neuen Schlüssel generieren und danach oben rechts auf Speichern. Siehst du keinen Bereich für den API-Schlüssel, bitte den easybill-Support, den API-Zugang für dein Konto freizuschalten.
3. Kopiere den Schlüssel in EASYBILL_API_KEY. Der Connector schickt ihn als Bearer-Token an https://api.easybill.de/rest/v1; eine URL, Kontonummer oder weitere Einstellung musst du nicht eintragen.
4. Installiere den Connector. Es gibt keinen Schritt Authorize with Provider: Der Schlüssel genügt, und AnythingMCP speichert ihn verschlüsselt.
5. Beginne mit easybill_list_customers und einem kleinen limit wie 5 und prüfe, ob der Schlüssel das richtige easybill-Konto erreicht.

Ein Tool für alle Belegarten: Rechnungen, Gutschriften, Angebote, Zahlungserinnerungen und Lieferscheine kommen alle aus easybill_list_documents, gefiltert über type (INVOICE, CREDIT, OFFER, REMINDER, DELIVERY, mehrere durch Komma getrennt). Außerdem filtert das Tool nach customer_id, nach document_date (ein einzelnes YYYY-MM-DD oder ein Zeitraum wie 2026-01-01,2026-03-31) und nach paid_at; der Wert null liefert nur unbezahlte Belege. easybill_get_document liest einen Beleg mit Positionen, Umsatzsteuer pro Position (vat_percent), Summen und Zahlungsstatus, und easybill_get_document_pdf liefert das fertige PDF, Base64-kodiert im Feld pdf.

IDs und Nummern: easybill vergibt für jeden Kunden und jeden Beleg neben der Nummer, die du in der Oberfläche siehst (Kundennummer, Rechnungsnummer), eine numerische id. easybill_get_customer, easybill_get_document, easybill_get_document_pdf und der Filter customer_id erwarten die id, deshalb sucht die KI sie zuerst mit einem Listen-Tool heraus. easybill_list_customers sucht nach Firmenname (company_name), Nachname (last_name), E-Mail (emails), Kundennummer (number) und Land (country, ISO-Code wie DE).

Kunden anlegen: easybill_create_customer ist das einzige Tool, das schreibt. Es braucht mindestens einen Firmennamen (company_name) oder einen Nachnamen (last_name) und nimmt außerdem Vorname, Adresse, E-Mail und die USt-IdNr. in vat_identifier entgegen. Lass dir die Daten von der KI zeigen, bevor sie den Kunden anlegt, damit keine Dubletten entstehen.

Berechtigungen und Nur lesen: Soll die KI nur lesen, deaktiviere easybill_create_customer auf der Connector-Seite. Die anderen sechs Tools lesen nur Kunden, Belege, PDFs und deinen Artikelkatalog (easybill_list_positions, mit Artikelnummer, Beschreibung, Einzelpreis und Steuersatz).

Lange Listen: Listen-Tools liefern standardmäßig 100 Einträge pro Seite, mit limit bis zu 1000. Die Antwort enthält page, pages und total, und die KI blättert mit page weiter. Beträge stehen in der Währung des jeweiligen Belegs.

Häufige Fehler: 401 heißt, dass der Schlüssel fehlt oder falsch ist: Kopiere ihn erneut aus Profil und Einstellungen oder generiere dort einen neuen und aktualisiere EASYBILL_API_KEY. 404 bei einem einzelnen Kunden oder Beleg heißt meist, dass die KI die in easybill angezeigte Nummer statt der numerischen id übergeben hat.

Der Connector erstellt, versendet, ändert oder storniert keine Rechnungen, Angebote oder anderen Belege, erfasst keine Zahlungen, verschickt keine Mahnungen, bearbeitet oder löscht keine Kunden und ändert deinen Artikelkatalog nicht.

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 easybill-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 Rechnungen sind noch nicht bezahlt, und wie viel schuldet uns jeder Kunde insgesamt?“
• „Such unseren Kunden Müller GmbH und hol mir das PDF seiner letzten Rechnung.“
• „Liste alle Angebote aus dem ersten Quartal 2026 mit Kunde, Datum und Summe auf.“
• „Leg einen neuen Kunden an: Schneider Holzbau GmbH, Hauptstraße 12, 79098 Freiburg, Deutschland, USt-IdNr. DE123456789, [email protected]. Zeig mir die Daten vorher.“

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