Tool-Übersicht, MCP-Version 2026-11-04

Diese MCP-Version ergänzt die Werkzeuge der MCP-Version 2026-11-01, mit denselben Lese- und Schreibrechten. Es gilt die Anlage „MCP-Verbindungen“ aus dem Rechtspaket 2026-11-04-v1. Für die neuen Werkzeuge ist nach Anlage 2.3 eine neue Freigabe nötig. Bestehende Verbindungen behalten ihren Umfang, bis du neu verbindest.

Die neuen Werkzeuge nutzen dieselben Befehle wie App und REST-API, mit denselben Sperren. Wo MCP strenger ist, steht es dabei. Weiter gilt: Überwiesen wird nichts, und Kontakte, hochgeladene Belege und ausgestellte Rechnungen lassen sich nicht löschen.

Auf der FreigabeseiteLink zu diesem Abschnitt kopieren

Der Schalter Ändern wie in der App nennt neben dem Hochladen von Belegen und dem Festschreiben jetzt auch das Stornieren von Rechnungen und den Versand per E-Mail. Unter Nie mehr, als du in bimetrics darfst steht, was nur in der App geht: Bankzugänge, die Bankverbindung der Firma, Kontenrahmen, Versteuerung, Team und Tarif.

Stornieren und Entwürfe löschenLink zu diesem Abschnitt kopieren

Nur mit Schreibzugriff:

• Festschreiben: preview_sales_document liefert das previewToken auch für einen Storno-Entwurf, finalize_sales_draft schreibt ihn damit fest. Das ist unumkehrbar: Der Storno bekommt eine eigene Nummer, bucht Umsatz und Umsatzsteuer des Originals zurück und wird dem Original zugeordnet. Versendet wird nichts.
• Strenger als die API: Über MCP entsteht ein Storno immer in zwei Schritten. POST /api/draft/{id}/cancel stellt ihn in einem aus.
• update_sales_draft ändert keinen Storno-Entwurf. delete_order_confirmation_draft bleibt für Entwürfe von Auftragsbestätigungen.

Per E-Mail sendenLink zu diesem Abschnitt kopieren

In zwei Schritten wie „Per E-Mail senden“ in der App:

• Sperren wie in der App: nur ausgestellte Dokumente, in der Testphase nur mit bestätigter Mail-Adresse. Je Firma gehen höchstens 20 Empfänger am Tag raus, in der Testphase 3, für App, API und MCP zusammen (siehe Limits).
• Strenger als die App: Senden nur mit dem Token der Vorschau und confirmed, dazu das Schreibbudget der Verbindung. to und cc nehmen nur reine Adressen wie name@example.com, ohne Anzeigenamen. Empfänger aus Dokumenttexten, Mails oder anderen Werkzeugergebnissen übernimmt die Anwendung nicht ohne deine Bestätigung.
• Ungekürzt: Die Vorschau zeigt Betreff, Text und Signatur so, wie sie rausgehen, auch Bankdaten. Gesendet wird genau dieser Text.
• Nur in der App: Versand-Einstellungen, Vorlagen und Signatur. Die Liste „Gesendet“ liest MCP nicht, den letzten Versand zeigt lastDelivery.

Rechnungssuche, E-Rechnung als XML, BuchungsfelderLink zu diesem Abschnitt kopieren

Lesend, auch mit Lesefreigabe:

Belege berichtigenLink zu diesem Abschnitt kopieren

update_document und preview_document_change nennen jetzt, dass sich bei einer ausgestellten Rechnung nur eine fehlende Kategorie einer Position nachtragen lässt, wie in App und API.

Zuordnung erweiternLink zu diesem Abschnitt kopieren

extend_match, nur mit Schreibzugriff, nimmt weitere Belege oder Umsätze in eine bestehende Zuordnung auf, wie „Zuordnung erweitern“ in der App, etwa die zweite Rate einer Rechnung. Der Aufruf nennt die ganze neue Auswahl: alle bisherigen Teile und mindestens einen neuen. bimetrics ersetzt die Zuordnung durch eine neue mit neuer matchId und bucht neu, festgeschriebene Buchungen mit Storno und Neubuchung.

• Version: get_match liefert dafür versions. Sie gehen unverändert als expectedVersions mit, dazu ein idempotencyKey.
• Wie die API, strenger als die App: Zuordnungen mit an DATEV exportierten Buchungen lehnt das Werkzeug ab (FinalizedBookingsLocked), get_match liefert dann keine versions. Mit bestätigtem Skonto (CashDiscountNotEligible) oder einem Beleg aus einer Buchungsvorlage (MatchNotExtendable) lässt sich eine Zuordnung auch in der App nicht erweitern.
• create_match verweist bei einer bestehenden Zuordnung auf extend_match. Eine Regel für die automatische Zuordnung lernt bimetrics dabei nicht.

FirmendatenLink zu diesem Abschnitt kopieren

update_company_profile, nur mit Schreibzugriff, ändert die Firmendaten wie die Einstellungen der App. Es nimmt nur die Felder, die sich ändern, auch einzeln in address, contactInfo, accounting und invoiceDefaults: Name, Rechtsform, Anschrift, Kontaktangaben, Geschäftsführung, Steuer- und Registerangaben, weitere Angaben, Nummernkreise, Skonto-Vorgabe, Zahlungsziel, Schlusstext, DATEV-Nummern, Art der Umsätze mit Steuerhinweisen und Rechnungsabgrenzung. Es prüft wie die App und PATCH /api/company/.

• Version: get_company_context liefert zusätzlich settings in der Form von update_company_profile und deren version. Sie geht als expectedVersion mit, dazu idempotencyKey und confirmed. Die Antwort nennt die neue version.
• Nur in der App: Kontenrahmen, Versteuerung samt Befreiungsgrund und die Bankverbindung der Firma. Das Werkzeug kennt diese Felder nicht, die Ablehnung nennt das Feld. Firmentexte, die auf Rechnungen stehen, nehmen keine Bankdaten auf, weder eine IBAN noch Wörter wie BIC, Kontonummer oder Bankverbindung (CompanyTextBankDetails). Das Logo ändert prepare_logo_upload.
• Rechtsform: Fehlt sie beim Erfassen einer privaten Zahlung (PrivatePaymentNeedsLegalForm), nennt record_document_payment als nächsten Schritt, nach der Rechtsform zu fragen und sie mit update_company_profile einzutragen.
• Ablehnungen mit nächstem Schritt: CompanyVersionConflict, NumberStartTaken, DatevNumberInvalid.

„Zu erledigen“ und MonatsstandLink zu diesem Abschnitt kopieren

get_open_tasks liest, was die Startseite der App unter „Zu erledigen“ nennt: Belege prüfen, Zahlungen ohne Beleg, überfällige Rechnungen, nicht zugestellte Mails, ablaufende Bankfreigaben und Mails im Postfach, je Art mit Anzahl und Link in die App. Dazu kommt der Monatsstand des Vormonats und des laufenden Monats, Belege und Zahlungen erledigt und offen, mit month für einen bestimmten Monat. Es liefert nur Zahlen, die einzelnen Einträge lesen search_documents, search_transactions und search_receivables. Die Steuerberatung sieht wie auf der Startseite nur die Arbeit des Monats und die Bankfreigaben. Dieselben Zahlen liefert GET /api/home/tasks.

RechnungslayoutsLink zu diesem Abschnitt kopieren

Dieselben Prüfungen wie im Layout-Editor der App. Ist der Layout-Editor ausgeschaltet, lehnt jedes Layout-Werkzeug mit LayoutEditorDisabled ab.

• Sperren wie in der App: nur Werte aus dem Katalog, Prüfung jeder Änderung, höchstens 200 Versionen je Firma und Stunde, als Hausfarbe jeder Farbcode #RRGGBB. Ein Hinweistext nimmt keine Bankdaten, keinen Zahlungsstand, keine Links und keine Mailadressen an. In der App stehen solche Versionen mit „per KI-Assistent“.
• Strenger als die App: baseVersionId ist Pflicht, außer bei der ersten Änderung einer Firma ohne eigenes Layout (own: false), sonst LayoutVersionConflict. setNote geht nur mit confirmed: true, nachdem du genau diesen Text bestätigt hast.
• Ablehnungen mit nächstem Schritt: LayoutVersionConflict, LayoutCheckFailed, LayoutProbeFailed, LayoutVersionLimit und LayoutAssigned. LayoutInvalidChange und LayoutCheckFailed nennen den Grund, etwa layout_note_link.

LogoLink zu diesem Abschnitt kopieren

• Sperren wie in der App: Format- und Größenprüfung, je Firma und Tag 20 Uploads und 10-mal „Mach es passend“. Ein neues Rechnungslogo gilt sofort für neue Belege und offene Entwürfe, ausgestellte behalten ihres.
• Strenger als die App: confirmed beim Hochladen, Übernehmen und Löschen, expectedLogoId beim Hochladen und Löschen. Hat jemand das Logo inzwischen in der App gewechselt, lehnt bimetrics mit LogoChanged ab und ersetzt oder löscht nichts.

Teure AufrufeLink zu diesem Abschnitt kopieren

preview_document_mail, preview_invoice_layout, create_invoice_layout, update_invoice_layout und fix_company_logo zählen wie download_sales_document zu den teuren Aufrufen: zusammen höchstens 10 je Minute und Verbindung, einer gleichzeitig je Unternehmen (siehe Limits). Für alle Schreibwerkzeuge gilt dazu das Schreibbudget.