Falco über MCP mit Meta Muse verbinden

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

Falco + Meta Muse

Falco, belgische Buchhaltung und Peppol-E-Rechnungen: Einkaufs- und Verkaufsbelege mit ihren Dateien, über Peppol empfangene Rechnungen, Abfragen von Peppol-Teilnehmern sowie Kunden, Artikel und Rechnungen des Falco-Fakturierungsmoduls. Größtenteils nur lesend; das Setzen des Zahlstatus von Einkaufsbelegen und Peppol-Rechnungsantworten sind bei der Installation ausgeschaltet.

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:

FALCO_APP_SECRET, FALCO_API_KEY

Schritt 1 — Zugangsdaten holen

Der Connector braucht zwei Schlüssel, und beide sind Pflicht: ein Application Secret vom Integrator und einen API-Schlüssel vom Falco-Kunden.

1. Der Integrator legt im Falco-Entwicklerportal (dev.falco-app.be) eine Anwendung an, beantragt die nötigen Scopes, zum Beispiel documents:purchases:read, documents:sales:read, peppol:inbound:read, peppol:participants:read, customers:read, articles:read und invoices:read, und stellt sie auf Public. Ihr produktives Application Secret (as_live_...) kommt in FALCO_APP_SECRET.
2. Der Falco-Kunde, ein Administrator der Organisation im Tarif Expert Essential oder Expert Premium, öffnet in der Falco-Desktop-Anwendung unter seinen Initialen API access, wählt diese Anwendung über ihre ID (app_...) und erzeugt einen API key (sk_live_...) für seine Organisation. Er kommt in FALCO_API_KEY.
3. Installiere den Connector und rufe falco_get_organization auf, um beide Schlüssel zu prüfen. Der Connector ruft die Produktions-API auf, https://api.falco-app.be/v1; Sandbox-Schlüssel (as_test_, sk_test_) funktionieren nur auf dem Sandbox-Host und werden hier abgelehnt.

Was er liest: die Organisation hinter dem Schlüssel (Name, USt-Nummer, Peppol-Kennung, Adresse, IBANs, Tarif); Einkaufsbelege (Lieferantenrechnungen und Gutschriften) mit Zahl- und Peppol-Status, Ereignisverlauf und angehängten Dateien; Verkaufsbelege, auch als PDF oder UBL importierte; über Peppol empfangene Belege mit Absender, Beträgen, Fälligkeitsdatum, Zahlungsreferenz und Bankkonto; und Kunden, Artikel und Rechnungen des Falco-Fakturierungsmoduls mit Rechnungspositionen, MwSt-Zwischensummen und Peppol-Status. Außerdem lädt er Dateien herunter: die Hauptdatei, das UBL-XML oder einen Anhang eines Einkaufsbelegs, das UBL eines über Peppol empfangenen Belegs und das PDF einer Rechnung aus dem Fakturierungsmodul.

So arbeitet die KI damit: Für Lieferantenrechnungen beginnt sie mit falco_list_peppol_inbound (was über Peppol eingegangen ist) und falco_list_purchase_documents (alle Einkaufsbelege mit ihren Dateien); für den Verkauf mit falco_list_sale_documents oder, bei Belegen aus dem Fakturierungsmodul, falco_list_invoices. Ob eine Firma E-Rechnungen empfangen kann, prüft sie mit falco_find_peppol_participant über die USt-Nummer oder mit falco_check_peppol_participant über eine Teilnehmer-ID wie 0208:0123456789.

Bei der Installation ausgeschaltet: falco_set_purchase_payment_status und falco_send_invoice_response. Das erste ersetzt den Zahlstatus eines Einkaufsbelegs durch not_paid, partially_paid oder paid, etwa nachdem ein Lieferant bezahlt wurde. Das zweite schickt dem Absender eines empfangenen Belegs eine Rechnungsantwort über Peppol (acknowledged, in_process, under_query, conditionally_accepted, rejected, accepted oder paid); der Lieferant erhält sie sofort, und sie lässt sich nicht zurückziehen. Ein Administrator schaltet sie bewusst ein. Auch dann zeigt dir die KI den Beleg und den neuen Status oder die Antwort und wartet auf dein Ja.

Datum und Beträge: Filter nehmen YYYY-MM-DD. Beträge sind Zeichenketten in der Belegwährung, meist EUR. Listen kommen seitenweise mit page (ab 0) und page_size (20 bis 200, Rechnungen bis 100), und die KI fragt die nächste Seite ab, solange eine Seite voll zurückkommt.

Limits: 60 Anfragen pro Minute und Application Secret. Darüber antwortet Falco mit 429, und die KI wartet und versucht es erneut.

Häufige Fehler: Fehler folgen RFC 9457 mit title, detail und code. 401 heißt, dass das Application Secret oder der API-Schlüssel falsch ist oder ein Sandbox-Schlüssel auf der Produktion verwendet wird. 403 heißt, dass dem Schlüssel der Scope für diesen Bereich fehlt; der Kunde vergibt die Scopes beim Erzeugen des Schlüssels. 404 bei einer Teilnehmerabfrage heißt, dass die Firma über Peppol nicht erreichbar ist.

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 Falco-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 über Peppol empfangenen Lieferantenrechnungen aus diesem Monat sind noch offen, und wann sind sie fällig?“
• „Zeig mir die Einkaufsbelege der letzten 30 Tage mit Lieferant, Betrag und Zahlstatus.“
• „Kann die Firma mit der USt-Nummer BE0123456789 E-Rechnungen über Peppol empfangen?“
• „Liste die Rechnungen aus dem Fakturierungsmodul auf, die verschickt, aber noch nicht bezahlt sind, mit ihren Bruttobeträgen.“
• „Lade das PDF der Rechnung 2026-0142 aus dem Fakturierungsmodul herunter.“

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
• Mit Microsoft Copilot verbinden