Falco über MCP mit Microsoft Copilot 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 + Microsoft Copilot

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 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 Falco-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 ü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

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