bimetricsEntwickler
Tools und Vorlagen

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

Die Werkzeuge der MCP-Version 2026-10-23, nutzbar auch in der kostenlosen Testphase, und das Erfassen von Zahlungen.

Als Markdown ansehen

Diese MCP-Version gilt, sobald das Rechtspaket 2026-11-01-v1 veröffentlicht ist, mit dessen Anlage „MCP-Verbindungen“. Sie hat dieselben Werkzeuge wie die MCP-Version 2026-10-23, mit denselben Lese- und Schreibrechten. Neu ist, dass sich KI-Assistenten dann auch in der kostenlosen Testphase verbinden können. Mit eingeschalteter Zahlungserfassung kommen drei Werkzeuge für Zahlungen dazu.

Was sich ändert

  • get_company_context: Liefert in der Testphase zusätzlich trial mit dem Ende (endsAt) und den Belegen (documentsUsed von documentsLimit). Mit einem Tarif fehlt das Feld.
  • prepare_document_upload: Nennt die 100 Belege der Testphase, die für alle Wege zusammen gelten, und sagt, was bei 402 LimitReached und 429 WriteBudgetExceeded zu tun ist. Der Befehl im Feld curl nutzt --fail-with-body und zeigt so auch die Antwort eines abgelehnten PUT.

In der Testphase

  • Tagesgrenzen: Die Grenzen für Abfragen, Änderungen und Festschreibversuche gelten je Unternehmen für KI-Assistenten und API zusammen. Die Werte stehen unter Limits.
  • Serien: Bleiben wie in jeder Version Entwürfe. Ausstellende Serien richtest du in der App ein.
  • Nach dem Ende: Werkzeuge antworten mit einem Hinweis, Verbindungsaufbau und Werkzeugliste mit 403. In der App bleiben Verbindungen sichtbar und lassen sich trennen. Mit einem Tarif funktionieren sie wieder, die Anwendung kann dafür ein neues Verbinden verlangen.

Zahlungen erfassen

Sobald bimetrics die Zahlungserfassung einschaltet, kommen drei Werkzeuge dazu. Bis dahin fehlen sie in der Werkzeugliste. Ältere Versionen erhalten sie nicht.

WerkzeugInhalt
get_document_paymentZahlungsstand eines Belegs wie unter „Als bezahlt markieren“ in der App: offener Betrag (amountOpenMinor), Version, ob Buchungen schon an DATEV exportiert sind, wie die Firma eine private Zahlung bucht (private.treatment, bei GmbH und UG mit dem Betrag, den sie den Gesellschaftern schuldet), die Geschäftsführung aus den Einstellungen und die erfassten Zahlungen mit ID. Lesefreigabe genügt.
record_document_paymentNur mit mcp:write: eine schon erfolgte Zahlung erfassen, method cash (bar aus der Kasse), private (privat bezahlt, nur Eingangsbelege, optional mit paidBy) oder clearing (anderer Weg über das Verrechnungskonto). Das Konto wählt bimetrics wie bei der API.
reverse_document_paymentNur mit mcp:write: eine erfasste Zahlung mit einer Gegenbuchung zurücknehmen, auch nach einem DATEV-Export. Erstattungen und Verrechnungen aus Rechnungskorrekturen nimmt weiter record_correction_settlement zurück.
  • Bucht sofort: Beide Schreibwerkzeuge buchen gleich, wie in der App. Eine erfasste Zahlung lässt sich nicht ändern, nur zurücknehmen und neu erfassen. Überwiesen wird nichts. Eine Zahlung, die schon als Bankumsatz da ist, ordnet create_match zu.
  • Bestätigung: Beide sind als destruktiv gekennzeichnet (destructiveHint), damit die Anwendung vorher bei dir nachfragt. Erst wenn du die Zahlung gesehen und ausdrücklich beauftragt hast, setzt der Assistent confirmed: true.
  • Version: expectedVersion und expectedAmountOpenMinor kommen unverändert aus get_document_payment. Hat sich der Beleg seitdem geändert, antwortet das Werkzeug mit VersionConflict und bucht nichts. idempotencyKey wiederholt nur genau denselben Auftrag.
  • Erstattung: Erstattet die GmbH den Betrag, ordnet create_match die Überweisung der Vorlage „Gesellschafter-Verrechnung“ zu (documentSeriesIds aus list_document_templates).
  • Grenzen: wie in der App. Nicht für Belege aus Vorlagen oder Verträgen, Belege mit Buchungsfehlern und Belege, die zusammen mit anderen zugeordnet sind. Belege mit an DATEV exportierten Buchungen nehmen seit dem 06.11.2026 eine Zahlung an; sie geht mit dem nächsten DATEV-Export ihres Monats an die Kanzlei. In der Testphase zählen die Aufrufe zu den Tagesgrenzen.

Auf dieser Seite