bimetricsEntwickler

Schreibzugriff

Was eine MCP-Verbindung mit Schreibzugriff in bimetrics ändern kann – seit MCP-Version 2026-10-05 sofort wie in der App, einschließlich Festschreiben nach der Vorschau.

Als Markdown ansehen

Seit MCP-Version 2026-10-05: wie in der App

Mit der Version 2026-10-05 wirkt jedes Schreibwerkzeug sofort wie die entsprechende Funktion der App, auch auf die Buchungen. Dazu gehören Zuordnungen, Belegkorrekturen und das Festschreiben von Rechnungsentwürfen nach Abruf der aktuellen Vorschau. Festschreiben ist endgültig; danach lässt sich eine Rechnung nur noch per Rechnungskorrektur mindern (per MCP ab Version 2026-10-11) oder stornieren (per MCP ab Version 2026-11-04, vorher in der App). Verbindungen älterer Versionen behalten ihren Umfang, bis du neu verbindest.

Für alle Schreibwerkzeuge gibt es genau eine zusätzliche Berechtigung: mcp:write. Seit dem 04.10.2026 (Version 2026-10-04) ist Schreibzugriff erlauben auf der Freigabeseite vorausgewählt, auch wenn die Anwendung nur Lesezugriff anfragt. Es erscheint überall, wo Schreiben möglich ist. Entfernst du das Häkchen, bleibt die Verbindung lesend. Jede Anwendung, die bimetrics zur Verbindung zulässt, erhält dieselben Buchhaltungswerkzeuge und denselben Schreibzugriff, ob Claude, ChatGPT, Codex, Cursor oder eine andere (siehe Gemeinsame Buchhaltungsfunktionen und Rechnungsansicht).

Bleibt der Schalter Ändern wie in der App an (bis Version 2026-10-16 das Häkchen Schreibzugriff erlauben), erhält die Verbindung mcp:write für jedes gewählte Unternehmen, in dem Schreiben möglich ist, auch ohne Anfrage der Anwendung. Die Token-Antwort nennt dann im Feld scope auch mcp:write, obwohl die Anwendung nur mcp:read angefragt hat (RFC 6749, Abschnitt 3.3); jede Erneuerung per Refresh-Token behält diesen Umfang. Bei mehreren Unternehmen gilt mcp:write nur in denen, für die Schreiben bei der Freigabe möglich war. Später ergänzte Schreibwerkzeuge verwenden dieselbe Berechtigung; das Festschreiben gehört dazu und hat keinen eigenen Schalter. Ein Schreibaufruf ohne mcp:write erhält insufficient_scope mit dem benötigten OAuth-Scope, damit der Client eine erneute Autorisierung anstoßen kann. Abbruch oder Ablehnung erweitert den bisherigen Zugang nicht.

Schon verbunden? Eine Leseverbindung erhält Schreibzugriff, wenn du in einer neuen Unterhaltung einen Schreibauftrag gibst: Die Anwendung öffnet dann die Freigabeseite. Eine Verbindung mit Schreibzugriff aus einer Version vor 2026-10-05 schlägt Zuordnungen und Belegkorrekturen weiter nur vor und kann nicht festschreiben. Für den neuen Umfang trennst du bimetrics in der Anwendung und verbindest neu. Die neue Freigabe ersetzt die bisherige Verbindung.

Wer schreiben darf

  • Schreiben darf eine Verbindung, die ein Inhaber oder ein Teammitglied mit MCP: lesen und schreiben freigegeben hat. Das gilt für jedes Schreibwerkzeug. Festschreiben lassen sich auch Entwürfe, die jemand in der App angelegt hat. Ändern lassen sich per MCP bis Version 2026-10-05 nur die eigenen, ab Version 2026-10-09 auch diese, wenn MCP sie vollständig zeigt (editable).
  • Jeder Aufruf prüft Verbindung, Mitgliedschaft, Inhaberrolle bzw. MCP-Recht und Tarif neu, ebenso ob Schreiben derzeit verfügbar und für das Unternehmen aktiviert ist. Welche Anwendung aufruft, spielt dafür keine Rolle.
  • Jede Änderung gilt nur im Unternehmen des Aufrufs. IDs aus einem anderen Unternehmen behandelt der Server wie unbekannte IDs.

Wenn Schreiben nicht erlaubt ist

Ist Schreiben derzeit nicht verfügbar oder für das Unternehmen nicht aktiviert, erhält ein Schreibaufruf ein Tool-Ergebnis mit Fehler (isError) und einem kurzen Grund, kein 403. Der Grund nennt nie eine Anwendung. Eine neue Freigabe hilft dann nicht; Lesen bleibt möglich. Hat ein Teammitglied nur MCP: nur lesen, erhält ein Schreibaufruf ebenfalls ein Tool-Ergebnis mit Fehler (isError) und Grund. Fehlt der Tarif, wird der Aufruf schon vorher abgelehnt. Werden Inhaberrolle, MCP-Recht oder Mitgliedschaft entzogen, endet die Freigabe für dieses Unternehmen (siehe Wann eine Verbindung endet). Fehlt nur mcp:write, gilt weiter insufficient_scope wie oben.

Was Schreibzugriff seit MCP-Version 2026-10-05 erlaubt

BereichWerkzeugeWirkung
Kontaktecreate_contacts, update_contactKontakte anlegen und wie im Kontaktformular ändern, auch Anschrift, USt-IdNr., Land, Kundennummer, Kundentyp, IBAN und BIC. Neue Entwürfe übernehmen die Änderung, ausgestellte Rechnungen behalten ihre Angaben. Notizen nur in der App.
Rechnungen und Angebotecreate_sales_draft, update_sales_draftRechnungs- und Angebotsentwürfe anlegen und offene Entwürfe ändern: bis Version 2026-10-05 nur eigene, ab Version 2026-10-09 jeden Entwurf des Unternehmens, den MCP vollständig zeigt (editable), auch aus der App. Es wird nichts ausgestellt, gebucht oder versendet.
Rechnungen und Angebotepreview_sales_document, finalize_sales_draftEin Dokument so ansehen, wie bimetrics es druckt: als Text mit allen Positionen und Summen, in Anwendungen mit Bildanzeige auch als Bild. Einen Entwurf in genau diesem Stand festschreiben oder ein Angebot ausstellen (siehe Festschreiben).
Rechnungen und Angebotecopy_sales_documentAb Version 2026-10-09: Rechnungen und Angebote duplizieren und aus einem ausgestellten Angebot einen Rechnungsentwurf machen. Es wird nichts ausgestellt oder gebucht.
Zuordnungencreate_match, delete_match, dismiss_match_suggestionBelege und Umsätze zuordnen, auch zu einer Belegvorlage, Zuordnungen aufheben und Zuordnungsvorschläge ausblenden. Zuordnen und Aufheben buchen sofort; beim Aufheben löscht bimetrics die Belege, die es dafür aus Belegvorlagen erzeugt hat.
Belegeupdate_documentRechnungsnummer, Daten, Leistungszeitraum sowie Kategorie und USt-Satz vorhandener Positionen berichtigen; ab Version 2026-10-16 auch Beträge, Positionen, Steuerfall, Belegart und Gegenpartei wie in der App, vorher mit preview_document_change prüfen. bimetrics bucht den Beleg sofort neu.
Belegeprepare_document_uploadAb Version 2026-10-09: Belege über einen Upload-Link auf files.bimetrics.de hochladen. Wie Uploads in der App werden sie erkannt, können automatisch Zahlungen zugeordnet und gebucht werden und zählen zum Kontingent.
Auftragsbestätigungenderive_sales_document, delete_order_confirmation_draftAb Version 2026-10-10: aus einem ausgestellten Angebot eine Auftragsbestätigung oder aus Angebot bzw. Auftragsbestätigung einen Rechnungsentwurf erstellen und offene AB-Entwürfe verwerfen. AB-Entwürfe ändert und finalisiert der Assistent wie Rechnungsentwürfe mit update_sales_draft und finalize_sales_draft. Eine Auftragsbestätigung bucht nichts und erzeugt keine E-Rechnung.
Mahnungencreate_payment_reminder, update_payment_reminder, issue_payment_reminder, change_payment_reminder_statusAb Version 2026-10-11: Zahlungserinnerungen und Mahnungen zu überfälligen Rechnungen anlegen, ändern und nach der PDF-Vorschau ausstellen; offene Entwürfe löschen, ausgestellte zurückziehen oder einen bereits erfolgten Versand vermerken. Mahngebühr, Verzugszinsen und Pauschale nach den Einstellungen der Firma stehen auf dem PDF, je Mahnung abwählbar; Buchungen und Nachrichten entstehen nicht.
Rechnungskorrekturencreate_invoice_correction, update_invoice_correction, prepare_correction_reversalAb Version 2026-10-11: eine ausgestellte Rechnung je Position um Bruttobeträge mindern. Ausgestellt wird wie beim Festschreiben, mit eigenem Beleg und Buchungen. Eine ausgestellte Korrektur lässt sich vollständig aufheben; das Original bleibt erhalten.
Erstattungen und Verrechnungenrecord_correction_settlementAb Version 2026-10-11: eine bereits ausgeführte Rückzahlung aus einer Rechnungskorrektur festhalten, das Guthaben mit einer offenen Rechnung desselben Kunden verrechnen oder eine solche Erfassung zurücknehmen. Überwiesen wird nichts.
Zahlungenrecord_document_payment, reverse_document_paymentAb Version 2026-11-01, sobald bimetrics die Zahlungserfassung einschaltet: eine schon erfolgte Zahlung eines Belegs erfassen, bar, privat von einem Gesellschafter oder Inhaber oder über einen anderen Weg, und wieder zurücknehmen. bimetrics bucht sofort und wählt das Konto; ändern lässt sich die Zahlung nur per Rücknahme. Überwiesen wird nichts.
Stornos und Entwürfeprepare_invoice_cancellation, delete_sales_draftAb Version 2026-11-04: eine ausgestellte Rechnung vollständig stornieren, erst als Entwurf, dann nach der Vorschau mit finalize_sales_draft, und offene Entwürfe von Rechnungen, Stornorechnungen, Angeboten und Auftragsbestätigungen löschen.
Versandsend_document_mailAb Version 2026-11-04: ausgestellte Rechnungen, Stornorechnungen, Rechnungskorrekturen, Angebote, Auftragsbestätigungen und Mahnungen per E-Mail senden, genau so, wie preview_document_mail sie gezeigt hat. Unumkehrbar.
Zuordnungenextend_matchAb Version 2026-11-04: eine Zuordnung um weitere Belege oder Umsätze erweitern, etwa die zweite Teilzahlung. bimetrics bucht sofort neu.
Firmendatenupdate_company_profileAb Version 2026-11-04: Firmendaten wie in den Einstellungen der App ändern, ohne Kontenrahmen, Versteuerung und Bankverbindung der Firma.
Rechnungslayoutscreate_invoice_layout, update_invoice_layout, assign_invoice_layout, archive_invoice_layoutAb Version 2026-11-04: Layouts anlegen, ändern, je Belegart zuweisen und archivieren wie im Layout-Editor. Jede Änderung ist eine Version und gilt sofort für neue Belege und offene Entwürfe.
Logoprepare_logo_upload, fix_company_logo, apply_company_logo_fix, remove_company_logoAb Version 2026-11-04: Rechnungslogo und App-Zeichen hochladen, „Mach es passend“ nutzen, den Vorschlag übernehmen oder das Original zurückholen und das Logo löschen.
Belege löschendelete_document, delete_document_duplicatesAb Version 2026-11-05: einen Beleg nach preview_document_deletion und deinem Ja löschen, höchstens 20 je Firma am Tag, und Duplikat-Einträge entfernen. Belege mit an DATEV exportierten Buchungen bleiben in der App.
Sammelaktionenapply_bulk_document_changeAb Version 2026-11-05: „Kategorie setzen“ oder „Zahlung eintragen“ für bis zu 50 Belege, genau wie preview_bulk_document_change es gezeigt hat.
Postfachimport_inbox_attachment, archive_inbox_mailAb Version 2026-11-05: einen Anhang als Beleg übernehmen, eine Mail ablegen oder zurückholen. Nie, weil eine Mail es sagt.
Vorlagen und Dauerbuchungensave_document_template, delete_document_template, apply_recurring_bookingAb Version 2026-11-05: eigene Belegvorlagen anlegen, ändern und löschen, Dauerbuchungen nach preview_recurring_booking anlegen, ändern, beenden und löschen.
Kontoauszugprepare_statement_upload, inspect_bank_statement, preview_bank_statement, apply_bank_statement, retry_statement_importAb Version 2026-11-05, nur für den Inhaber: eine Datei der Bank hochladen, ansehen, vorab prüfen und nach deinem Ja einlesen. Das lässt sich nicht rückgängig machen.
Vorschlägerestore_match_suggestionAb Version 2026-11-05: einen ausgeblendeten Vorschlag zurückholen. create_match lernt ohne suggestionId eine Regel wie in der App.
Wiederkehrende Rechnungencreate_recurring_invoice, update_recurring_invoice, activate_recurring_invoice, pause_recurring_invoice, end_recurring_invoice, prepare_recurring_invoice_periodAb Version 2026-10-11: Serien für Rechnungsentwürfe anlegen, ändern, freigeben, pausieren und beenden und einen Entwurf für einen gewählten Termin vorbereiten. Serien per MCP stellen keine Rechnungen aus. Eine freigegebene Serie läuft weiter, auch wenn die Verbindung endet.
DATEV-Exportpreview_datev_export, start_datev_export, cancel_datev_export, set_datev_asset_modeAb Version 2026-11-17: den DATEV-Export nach preview_datev_export und deinem Ja starten. Schon die Vorschau bucht, was noch nicht gebucht ist, wie der Export in der App, und braucht deshalb Schreibzugriff. Der Export schreibt die offenen Buchungen des Zeitraums fest; das lässt sich nicht rückgängig machen. Die Datei lädst du in der App. Dazu die Antwort, ob deine Kanzlei die Abschreibungen selbst in DATEV rechnet.
Kassenbuchset_cash_book_enabled, save_cash_book, create_cash_book_entries, reverse_cash_book_entry, link_cash_book_bank_transaction, record_cash_count, close_cash_monthAb Version 2026-11-17: Kassenbücher einschalten und anlegen (nur der Inhaber), Buchungen nach einer Vorschau erfassen und stornieren, Geldtransit dem Bankumsatz zuordnen, die Kasse zählen und einen Monat endgültig abschließen (nur Inhaber und Kanzlei). Buchungen werden nie geändert oder gelöscht.
Anlagencreate_asset, import_assets, change_asset_plan, dispose_asset, reverse_asset_disposal, reverse_assetAb Version 2026-11-17: Anlagen aus Belegpositionen anlegen, Altbestand übernehmen, die Nutzungsdauer ändern, einen Abgang buchen und zurücknehmen, eine Anlage zurücknehmen oder stornieren, jeweils nach einer Vorschau. Die AfA bis heute wird nachgebucht.
Kostenstellensave_cost_centerAb Version 2026-11-17: Kostenstellen und Verteilungen anlegen, umbenennen, archivieren und zurückholen. Benutzte behalten Nummer und Anteile.
Zuordnungensettle_match_cash_discount, settle_match_reminder_charges, settle_match_exchange_difference, apply_match_euro_amount, write_off_documentAb Version 2026-11-17: an einer Zuordnung Skonto, Mahnkosten, eine Kursdifferenz oder den Euro-Betrag der Zahlung buchen, ohne sie vorher aufzuheben, und einen Rest als Rundung oder Forderungsverlust ausbuchen, jeweils nach einer Vorschau. Bei schon an DATEV exportierten Buchungen nur in der App.
Automatikset_rule_learning, set_document_template_auto_assignAb Version 2026-11-17: „Aus Zuordnungen lernen“ ein- oder ausschalten und eine Belegvorlage Bankumsätze selbst zuordnen lassen.
Mahnwesenset_reminder_hold, apply_reminder_run, release_retentionAb Version 2026-11-17: die Mahnsperre einer Rechnung setzen und aufheben, für bis zu 25 Rechnungen nach preview_reminder_run je eine Mahnung der nächsten Stufe ausstellen und einen Sicherheitseinbehalt ab heute fällig stellen. Gesendet wird dabei nichts.
Angeboteset_proposal_outcomeAb Version 2026-11-17: ein ausgestelltes Angebot annehmen, ablehnen oder das Ergebnis zurücknehmen. Angebot, PDF und Nummer bleiben.
Kontaktemerge_contacts, dismiss_similar_contactAb Version 2026-11-17: Belege nach preview_contact_merge zu einem anderen Kontakt verschieben und den geleerten Kontakt löschen, oder festhalten, dass zwei ähnliche Kontakte verschiedene Firmen sind.
Belegeretry_document_reading, prepare_mail_attachment_uploadAb Version 2026-11-17: das Lesen eines fehlgeschlagenen Belegs neu starten und eigene Dateien für den Mailversand hochladen; sie werden kein Beleg.
Kassensystemprepare_cash_import_upload, apply_cash_import, reverse_cash_import, attach_cash_book_document, remove_cash_book_documentAb Version 2026-11-22: Z-Bons hochladen, nach der Prüfung und deinem Ja übernehmen, verwerfen oder als Ganzes stornieren und einer Auszahlung ihren Beleg geben oder ihn zurücknehmen. Inhaber und Nutzer, nicht die Steuerberatung.
Kassendateiconfirm_cash_import_accounts, apply_cash_import_file, discard_cash_import_fileAb Version 2026-11-22, sobald bimetrics den Dateiimport einschaltet: die Konten einer Datei des Kassensystems zuordnen (nur der Inhaber), ihre bereiten Tage nach deinem Ja buchen oder die Datei verwerfen.
Kassenbuchcorrect_cash_book_entry, preview_cash_in_from_bank, book_cash_in_from_bank, preview_cash_deposit_to_bank, book_cash_deposit_to_bankAb Version 2026-11-22: eine Buchung nach preview_cash_book_correction korrigieren, mit Storno und richtigem Eintrag, und Bargeld zwischen Bank und Kasse nach einer Vorschau in einem Schritt buchen und zuordnen. Schon die Vorschauen für Bargeld zwischen Bank und Kasse brauchen Schreibzugriff, preview_cash_book_correction nicht.
Automatisierungensave_automation, set_automation_active, apply_automation_to_existingAb Version 2026-11-22: Automatisierungen mit festen und freien Regeln anlegen, ändern und ein- oder ausschalten, nur wie du es im Chat bestätigst. Löschen nur in der App. Feste Regeln nach einem Probelauf auf vorhandene Belege der letzten 12 Monate anwenden, nur für die Belege, die du bestätigst; jeder zählt gegen das tägliche Änderungslimit der Firma.
Vorgemerkte Belegeset_receipt_request, clear_receipt_requestAb Version 2026-11-22: an einem Umsatz ohne Zuordnung vormerken, dass ein Beleg fehlt, mit Wiedervorlage und optionaler Notiz, und den Merker wieder entfernen, nur auf deinen Wunsch. Gebucht oder zugeordnet wird nichts, und nach außen geht keine Nachricht; fällige Merker meldet bimetrics einmal pro Woche per Mail an die Inhaber und die Person, die sie gesetzt hat.
Bankumsätzepreview_transaction_duplicate, mark_transaction_duplicateAb Version 2026-11-22, nur für aktive Inhaber: einen doppelten Bankumsatz nach der Vorschau und deinem Ja entfernen. Das lässt sich nicht selbst rückgängig machen. Schon die Vorschau braucht Schreibzugriff.
Belegedismiss_possible_duplicate, restore_possible_duplicateAb Version 2026-11-22: „Kein Doppelbeleg“ für zwei Belege festhalten und wieder zurücknehmen. Gebucht oder gelöscht wird nichts.
Eigene Sachkontensave_ledger_accountAb Version 2026-11-22: eigene Sachkonten anlegen, umbenennen, archivieren und aus dem Archiv holen, nur wie du es im Chat bestätigst. Die Nummer steht nach dem Anlegen fest, löschen lässt sich ein Konto nie. Die Bezeichnung geht mit dem nächsten DATEV-Export an DATEV, auch bei archivierten Konten.
Bankkontenset_bank_account_enabledAb Version 2026-11-23: ein Bankkonto aktivieren oder deaktivieren wie in der App, nur auf deinen ausdrücklichen Wunsch. Ein aktives Konto belegt einen Platz im Tarif; ohne freien Platz bleibt es aus. Umsätze und Buchungen bleiben. Verbinden und Trennen gehen nur in der App.
Belegnachfragensend_receipt_request_mail, cancel_receipt_request_follow_upAb Version 2026-11-23, solange bimetrics den Versand eingeschaltet hat: nach preview_receipt_request_mail und deinem Ja eine Anfrage nach einem fehlenden Beleg an den Kontakt senden, auf Wunsch mit einer Erinnerung, und eine geplante Erinnerung abbrechen. Die Mail geht an Dritte und lässt sich nicht zurückholen.
Feedbacksend_feedbackAb Version 2026-11-23, auch ohne Schreibzugriff: Feedback zu bimetrics an das bimetrics-Team senden, nur wenn du es möchtest. In deiner Firma ändert sich nichts.
Angebotecreate_proposal_version, create_proposal_addendumAb Version 2026-11-22: den Entwurf einer neuen Version eines Angebots anlegen und, sobald bimetrics Nachträge einschaltet, den Entwurf eines Nachtrags zu einem Auftrag. Ausgestellt, versendet oder gebucht wird nichts.

Nicht per MCP möglich, wohl aber in der App: Serien mit automatischer Ausstellung anlegen oder freigeben, Kontakte, ausgestellte Rechnungen, Mails im Belegpostfach oder Automatisierungen löschen (bis Version 2026-11-04 auch hochgeladene Belege) und Kontenrahmen, Versteuerung oder Bankverbindung der Firma ändern. Ausnahme ab Version 2026-11-17: merge_contacts löscht auf deinen ausdrücklichen Wunsch den beim Zusammenführen geleerten Kontakt, sofern kein Beleg daran bleibt. Zahlungen und Überweisungen löst bimetrics nicht aus. Rechnungen stornieren, Dokumente per E-Mail senden und Entwürfe von Rechnungen und Angeboten löschen geht erst ab Version 2026-11-04; vorher lassen sich nur offene Entwürfe von Auftragsbestätigungen (ab Version 2026-10-10) und Mahnungen (ab Version 2026-10-11) verwerfen. Belege mit an DATEV exportierten Buchungen berichtigst du bis Version 2026-11-05 in der App; ab Version 2026-11-17 storniert update_document sie und bucht neu, die Monate gehen mit einem erneuten Export als Nachtrag an DATEV.

Die Tool-Übersichten der Versionen 2026-10-05, 2026-10-09, 2026-10-10, 2026-10-11, 2026-10-16, 2026-11-01, 2026-11-04, 2026-11-05, 2026-11-17 und 2026-11-22 nennen je Werkzeug Titel, Eingaben und Folgen.

Festschreiben

  1. preview_sales_document zeigt den Entwurf so, wie bimetrics ihn druckt: Käufer, Daten, Referenz, Bemerkung, alle Positionen mit Beschreibung, Menge, Einzelpreis und USt-Satz, Netto, USt, Brutto, Zahlungsbedingungen und Notizen. Anwendungen mit Bildanzeige erhalten die Seite zusätzlich als Bild. Für einen offenen Rechnungs- oder Angebotsentwurf ohne blockierende Probleme, mit höchstens 20 Seiten und mit Positionen und Texten, die vollständig ins Ergebnis passen, liefert es einen Vorschau-Nachweis (previewToken), 15 Minuten gültig.
  2. Die Anwendung zeigt dir die Vorschau und fragt, ob sie festschreiben soll.
  3. finalize_sales_draft schreibt fest, wenn Nachweis, Version, Bruttobetrag und Käufer noch zum Gedruckten passen. Sonst passiert nichts, und es wird keine Nummer vergeben.

Was dann passiert, ist dasselbe wie bei Rechnung erstellen in der App: Die Rechnung erhält die nächste Rechnungsnummer, bimetrics bucht den Umsatz und erzeugt die E-Rechnung. Das ist endgültig; danach lässt sich die Rechnung nur noch per Rechnungskorrektur mindern (per MCP ab Version 2026-10-11) oder stornieren (per MCP ab Version 2026-11-04). Die automatische Zuordnung kann sie sofort einer eingehenden Zahlung zuordnen; vor einem Storno muss diese Zuordnung aufgehoben werden. Ein Angebot erhält seine Nummer und bucht nichts. Versendet wird nichts, weder per Mail noch an ein Portal; per E-Mail sendet ab Version 2026-11-04 erst send_document_mail nach einer eigenen Vorschau. Stornorechnungen schreibt finalize_sales_draft ab Version 2026-11-04 ebenso fest, vorher nur die App.

Denselben Ablauf aus preview_sales_document und finalize_sales_draft nutzen ab Version 2026-10-10 Auftragsbestätigungen (eigene Nummer, keine Buchung) und ab Version 2026-10-11 Rechnungskorrekturen. Mahnungen haben einen eigenen Ablauf: preview_payment_reminder zeigt das PDF, issue_payment_reminder stellt genau diesen Stand nach deiner Bestätigung aus.

Gemeinsame Buchhaltungsfunktionen und zusätzliche Rechnungsansicht

bimetrics macht Buchhaltungsfunktionen und Rechte nicht von der Anwendung abhängig. Jede Anwendung, die sich über die Zulassung verbinden darf, erhält dieselben Buchhaltungswerkzeuge und denselben Schreibzugriff: Anwendungen mit Metadatendokument auf einem bekannten Host (heute claude.ai, claude.com, chatgpt.com, cursor.com und cursor.sh) und bei bimetrics hinterlegte Anwendungen. Cursor nutzt kein Metadatendokument und meldet sich mit der hinterlegten Client-ID bimetrics-cursor an. Was du erlaubst, entscheidest du auf der Freigabeseite; danach gelten Tarif, Rolle, MCP-Recht, Budgets, Versionsprüfung und Protokoll für alle gleich.

Die zusätzliche Rechnungsansicht mit open_invoice_draft und amend_invoice_draft ist für ChatGPT und andere Apps über die OpenAI-Connector-Plattform vorgesehen, die sich mit https://chatgpt.com/oauth/client.json verbinden. Entscheidend ist die Client-ID, nicht der Name der App. Andere Verbindungen bearbeiten Rechnungsentwürfe weiterhin im Chat mit den gemeinsamen Buchhaltungswerkzeugen. Es braucht dafür keine neue Berechtigung oder Freigabe.

Neben den zwei Werkzeugen für die Rechnungsansicht unterscheidet sich die Darstellung der Ergebnisse je Anwendung. preview_sales_document liefert allen Anwendungen den vollständigen Text; ein Bild der Seite erhalten nur Anwendungen, die Bilder anzeigen, etwa Claude. In Testumgebungen dürfen sich auch Anwendungen von nicht gelisteten Hosts verbinden; sie bleiben lesend, und die Freigabeseite warnt vor ihnen.

Zwei Risiken bleiben, und die Entscheidung liegt bei dir. Eine Anwendung auf deinem Rechner (Claude Code, Codex, Cursor) kann sich nicht ausweisen; ein anderes Programm auf demselben Rechner könnte ihre öffentliche Client-ID nutzen. Die Freigabeseite weist auf solche lokalen Anwendungen hin. Außerdem kann dich jemand mit einem gefälschten Link zu einer Freigabe verleiten. Erlaube eine Verbindung deshalb nur, wenn du sie gerade selbst in deiner Anwendung gestartet hast.

Rückfragen und Bestätigung

Werkzeuge mit spürbaren Folgen sind als destruktiv gekennzeichnet (destructiveHint): update_contact, update_sales_draft, dismiss_match_suggestion, create_match, delete_match, update_document und finalize_sales_draft. Ab Version 2026-10-10 kommt delete_order_confirmation_draft dazu, ab Version 2026-10-11 kommen update_payment_reminder, issue_payment_reminder, change_payment_reminder_status, update_invoice_correction, record_correction_settlement, update_recurring_invoice, pause_recurring_invoice und end_recurring_invoice dazu, ab Version 2026-11-01 mit eingeschalteter Zahlungserfassung record_document_payment und reverse_document_payment, ab Version 2026-11-04 delete_sales_draft, send_document_mail, extend_match, update_company_profile, create_invoice_layout, update_invoice_layout, assign_invoice_layout, archive_invoice_layout, prepare_logo_upload, apply_company_logo_fix und remove_company_logo, ab Version 2026-11-05 delete_document, delete_document_duplicates, delete_document_template, save_document_template, apply_bank_statement, retry_statement_import, apply_bulk_document_change, apply_recurring_booking, restore_match_suggestion und import_inbox_attachment, ab Version 2026-11-17 start_datev_export, create_cash_book_entries, reverse_cash_book_entry, link_cash_book_bank_transaction, record_cash_count, close_cash_month, save_cash_book, create_asset, import_assets, change_asset_plan, dispose_asset, reverse_asset_disposal, reverse_asset, save_cost_center, settle_match_cash_discount, settle_match_reminder_charges, settle_match_exchange_difference, apply_match_euro_amount, write_off_document, set_reminder_hold, apply_reminder_run, release_retention, merge_contacts, dismiss_similar_contact und set_document_template_auto_assign, ab Version 2026-11-22 apply_cash_import, reverse_cash_import, attach_cash_book_document, remove_cash_book_document, correct_cash_book_entry, book_cash_in_from_bank, book_cash_deposit_to_bank, save_automation, apply_automation_to_existing, mark_transaction_duplicate, save_ledger_account und clear_receipt_request, mit eingeschaltetem Dateiimport auch apply_cash_import_file und discard_cash_import_file, ab Version 2026-11-23 send_receipt_request_mail. Ihre Beschreibungen nennen die Folgen, und die Server-Hinweise bitten die Anwendung, vorher bei dir nachzufragen. Ob sie das tut, stellst du in der Anwendung ein; ob du dort bestätigt hast, kann bimetrics nicht prüfen. Texte aus Belegen, Umsätzen und Kontakten zählen nie als Bestätigung.

Wiederholungen, Versionen und Protokoll

  • Jede Änderung braucht einen Idempotenzschlüssel (idempotencyKey). Eine Wiederholung mit demselben Schlüssel ändert nichts erneut und liefert dasselbe Ergebnis.
  • Kontakte, Entwürfe und Belege ändern sich nur in der gelesenen Version (expectedUpdatedAt, expectedVersion). Bei VersionConflict liest die Anwendung neu und prüft die Änderung mit dir, statt sie mit der neuen Version still zu wiederholen. Zuordnungen arbeiten wie in der App über die IDs.
  • Jede Änderung läuft über dieselben Befehle wie die App und wird mit der Quelle mcp, der Verbindung und der Person protokolliert. Das Änderungsprotokoll im DATEV-Export nennt in der Spalte via die Anwendung mit Name und Client-ID, auch wenn die Verbindung längst beendet ist.
  • Je Verbindung gehen höchstens 10 Schreibaufrufe je Minute und 60 je Stunde, je Unternehmen höchstens 300 ausgeführte Änderungen je Tag (UTC). Danach lehnt der Server weitere Änderungen ab, mit 429 oder dem Tool-Fehler „Action refused: WriteBudgetExceeded“.

MCP-Versionen bis 2026-10-04

Bis zur Version 2026-10-04 gibt es zwei Stufen. Stufe A erlaubt Kontakte und eigene Entwürfe direkt; Stufe B verlangt eine Freigabe für Zuordnungen und Belegkorrekturen. Der Assistent kann dort keine Rechnung festschreiben, stornieren, versenden oder löschen und keine Zahlung auslösen; Rechnungsentwürfe werden in der App geprüft und abgeschlossen. Kontakte lassen sich nur eingeschränkt ändern, ohne Bankverbindung. Die Tool-Übersicht 2026-10-04 beschreibt den Umfang.

RechtToolsWirkung
mcp:read + mcp:writesearch_contacts, get_contactKontakte ohne Bankverbindungen und Notizen lesen.
mcp:writecreate_contacts, update_contactKontakte nach der Rechtefreigabe direkt anlegen oder eingeschränkt ändern.
mcp:read + mcp:writesearch_sales_documents, get_sales_documentRechnungen und Entwürfe mit begrenzten, aufbereiteten Daten lesen.
mcp:writecreate_sales_draft, update_sales_draftRechnungsentwürfe anlegen und eigene, noch offene MCP-Entwürfe ändern.
mcp:read + mcp:writecheck_sales_draftEigene, noch offene MCP-Entwürfe prüfen, ohne sie zu verändern.
mcp:writecreate_match, delete_matchZuordnungen zur Prüfung in bimetrics vorschlagen.
mcp:writeupdate_documentErlaubte Belegkorrekturen zur Prüfung in bimetrics vorschlagen.
mcp:read + mcp:writeget_approval_statusDen Stand einer bereits vorgeschlagenen Freigabe lesen.

Sammelfreigabe in bimetrics

Bei Zuordnungen und Belegkorrekturen in diesen MCP-Versionen liefert der Assistent einen Link zur Freigabe. Der Vorschlag allein verändert keine Buchhaltungsdaten. In der App zeigt jeder Eintrag den bisherigen und vorgeschlagenen Stand, Buchungssummen je Konto und Umsatzsteuersatz sowie erkannte Buchungsprobleme.

Bestätigen kann die Person, die die Verbindung freigegeben hat: ein Inhaber oder ein Teammitglied mit MCP: lesen und schreiben. Wähle die Einträge aus, die ausgeführt werden sollen, und bestätige sie. Nicht ausgewählte Einträge werden verworfen. Gelöschte Serienbelege werden mit Belegnummer genannt und erfordern eine weitere Bestätigung. Bankumsätze zeigen Datum, Betrag, Gegenpartei, gekürzte IBAN und Verwendungszweck. Die Bestätigung gilt nur für genau die angezeigte Vorschau. Neu hinzugekommene oder veränderte Vorschläge erfordern eine neue Prüfung. Ein Korb umfasst höchstens 50 Einträge, sammelt höchstens 30 Minuten und läuft nach 48 Stunden ab.

Nach der Zustimmung führt ein Hintergrundprozess die gewählten Aktionen aus. Jede Aktion prüft die aktuellen Rechte, die Gültigkeit der Freigabe und die betroffenen Objektversionen erneut. Zwischenzeitliche Änderungen können einzelne Aktionen stoppen. Bereits ausgeführte Aktionen werden bei einem technischen Wiederholungsversuch nicht doppelt ausgeführt. Das Lesen des Status startet oder wiederholt keine Aktion.

Zugriff einschränken

Unter Einstellungen › KI-Assistenten können Inhaber eine Verbindung auf Lesen beschränken oder ganz widerrufen. Teammitglieder widerrufen nur ihre eigenen Verbindungen. Auch der Verlust von Inhaberrolle oder MCP-Recht, abgelaufene Freigaben, fehlender Tarif oder eine abgeschaltete Schreibfreigabe stoppen neue Schreibaktionen. Die bestehenden Leserechte richten sich weiterhin nach der ursprünglichen Verbindung.

Wissensressourcen

bimetrics://wissen/glossary, bimetrics://wissen/data-types und bimetrics://wissen/bookkeeping liefern die gemeinsam gepflegten Texte aus productknowledge/glossary.md, productknowledge/data-types.md und productknowledge/bookkeeping.md. Glossar und Datentypen erscheinen auch in Glossar und Datentypen. Sie sind fachliche Referenztexte und erteilen keine Schreibberechtigung.

Auf dieser Seite