Skip to main content

​
Fyvel MCP

Der Fyvel MCP-Server stellt Finanz- und Stammdaten aus Fyvel für MCP-Clients bereit. Ein Client kann damit zum Beispiel Unternehmen abrufen, Konten und Kategorien pflegen, Buchungen für die Zuordnung lesen oder Berichte auswerten. Für eine einführende Übersicht mit Nutzen, Setup-Schritten und kopierbaren Prompt-Vorlagen siehe die MCP-Übersichtsseite auf fyvel.io.

​
Was Fyvel MCP abdeckt

  • Unternehmen - rechtliche Einheiten der Organisation auflisten
  • Reporting-Bereiche - die Reportingstruktur lesen und verwalten
  • Konten, Kategorien und Kostenstellen - Stammdaten abrufen und pflegen
  • Kontobuchungen - Buchungen für ein Konto mit Zeitraum, Suche und Pagination lesen
  • Offene Posten - DATEV-Forderungen/Verbindlichkeiten lesen und Fyvel-Annotationen pflegen
  • Zuordnung - Buchungen für den Zuordnungs-Workflow lesen und Kategorien setzen
  • Eigene Buchungen - Bereiche anlegen sowie manuelle Buchungen lesen, ergänzen, ändern oder entfernen
  • Berichte - Berichte lesen, berechnen und strukturiert bearbeiten

​
Scoping

Der Bearer-Token legt die Organisation fest. MCP-Clients müssen deshalb keine Organisations-UUID vom Nutzer abfragen oder übergeben. Viele Tools arbeiten zusätzlich auf Ebene eines einzelnen Unternehmens. Dafür brauchst du eine companyUuid, die du mit list_companies abrufst.

​
Einstieg

  1. Setup & Authentifizierung
  2. Unternehmen & Scoping
  3. Danach je nach Anwendungsfall die passende Tool-Gruppe:

​
Organisation oder Unternehmen

  • Organisationsweit: Reporting-Bereiche, Kostenstellen und Berichte
  • Unternehmensbezogen: Konten, Kontobuchungen, Offene Posten, Kategorien, Zuordnung und Eigene Buchungen
  • Importierte Dateien: MCP-Tools ändern keine ursprünglichen Buchhaltungsdateien
  • Eigene Buchungen: Schreib-Tools arbeiten nur auf der manuellen Buchungsebene in Fyvel

​
Endpoint

Der Fyvel MCP-Server ist unter diesem Endpoint erreichbar: https://www.fyvel.io/mcp