Zum Hauptinhalt springen

​
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
  • Kontengruppen - Kontengruppen 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
  • Personalkosten - Mitarbeiter lesen und pflegen (list_employees, update_employees, set_employee_fte): Planungsgruppe, FTE, Monats-Split und ob Umbuchungen erzeugt werden
  • Planung - Pläne und den Stand je Kostenstelle lesen sowie Personal- und Kostenplan einer Kostenstelle bearbeiten (list_plans, get_plan_overview, get_plan_cost_center, update_personnel_plan, update_cost_plan). Einreichen, Freigeben und Sperren bleiben in der Web-App

​
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. Claude anbinden (optional, für claude.ai)
  3. Unternehmen & Scoping
  4. Danach je nach Anwendungsfall die passende Tool-Gruppe:

​
Organisation oder Unternehmen

  • Organisationsweit: Kontengruppen, Kostenstellen, Reports und Pläne
  • Unternehmensbezogen: Konten, Kontobuchungen, Offene Posten, Kategorien, Zuordnung, Eigene Buchungen, Personalkosten und Planwerte
  • 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