Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge Falco mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
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.
Frag einfach
Beispiel-Prompts für Falco
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 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
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.
Einrichtung
Der Connector braucht zwei Schlüssel, und beide sind Pflicht: ein Application Secret vom Integrator und einen API-Schlüssel vom Falco-Kunden.
- 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:readundinvoices:read, und stellt sie auf Public. Ihr produktives Application Secret (as_live_...) kommt inFALCO_APP_SECRET. - 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 inFALCO_API_KEY. - Installiere den Connector und rufe
falco_get_organizationauf, 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.
Fragt vor jeder Änderung: FALCO_APP_SECRET, FALCO_API_KEY
Connector lokal 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
Öffne http://localhost:3000/connectors/store, wähle Falco und trage die unter Voraussetzungen aufgelisteten Variablen ein.
Verfügbare Tools
| Tool | What it does |
|---|---|
falco_get_organization | Get the Falco organization the API key belongs to: name, VAT number, Peppol identifier, address, IBANs, profiles, plan (expert_essential or… |
falco_list_purchase_documents | List purchase documents (supplier invoices and credit notes) in Falco, newest first: id, number, invoice and due date, currency, amount… |
falco_get_purchase_document | Get one purchase document by id: number, dates, amount, supplier, payment and Peppol status, its event history and the list of attached… |
falco_download_purchase_document_file | Download a file of a purchase document: the main file (usually the PDF), the UBL XML, or one attached file |
falco_list_sale_documents | List sale documents (sales invoices and credit notes, including those imported as PDF or UBL), newest first: id, number, dates, currency… |
falco_get_sale_document | Get one sale document by id: number, dates, amount, customer, payment status, Peppol send status, event history and attached files |
falco_list_peppol_inbound | List documents received over Peppol (incoming e-invoices and credit notes), newest first: id, received date, invoice and due date, amount… |
falco_get_peppol_inbound_document | Get one document received over Peppol by id: sender, amounts, dates, payment reference, bank account, invoice reference and payment status |
falco_download_peppol_inbound_document | Download the file of a document received over Peppol (the UBL XML as received) |
falco_find_peppol_participant | Look up the Peppol participant identifier registered for a VAT number, to see whether a company can receive e-invoices over Peppol |
falco_check_peppol_participant | Check whether a Peppol participant identifier (e.g. 0208:0123456789) is registered to receive invoices or credit notes |
falco_list_customers | List customers of the Falco invoicing module: id, name, VAT and company number, language, e-mails, phone, contact, address and Peppol… |
falco_get_customer | Get one customer of the invoicing module by id with full address, contacts and Peppol identifier |
falco_list_articles | List articles (products and services) of the invoicing module: id, descriptions, unit price excluding and including VAT, unit, category… |
falco_list_invoices | List sales invoices and credit notes created in the Falco invoicing module: id, number, type, status (draft, sent, locked), document and… |
falco_get_invoice | Get one invoice or credit note of the invoicing module with its lines (article, quantity, unit price, VAT rate, amounts), VAT subtotals… |
falco_download_invoice_pdf | Download the PDF of an invoice or credit note of the invoicing module |
falco_set_purchase_payment_status | Set the payment status of a purchase document to not_paid, partially_paid or paid, e.g. after paying a supplier |
falco_send_invoice_response | Send a Peppol invoice response for a received document to its sender: acknowledged, in_process, under_query, conditionally_accepted… |
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.“
Nächste Schritte
War dieser Guide hilfreich?