bimetricsEntwickler
Tools und Vorlagen

Tool-Übersicht, MCP-Version 2026-10-09

Werkzeuge einer MCP-Verbindung, Version 2026-10-09 – dazu Belege hochladen, suchen, Monatsabschluss prüfen und Rechnungsentwürfe wie im Editor bearbeiten.

Als Markdown ansehen

Diese Übersicht gehört zur MCP-Version 2026-10-09. Die Freigabeseite in bimetrics verlinkt sie bei jeder neuen Verbindung, zusammen mit der Anlage „MCP-Verbindungen“ aus dem Rechtspaket 2026-10-09-v1. Sie umfasst die Werkzeuge der Version 2026-10-05 und ergänzt:

  • prepare_document_upload lädt Belege hoch: Die Anwendung meldet die Dateien an und schickt jede per HTTP-PUT an einen eigenen Upload-Link, nie durch das Gespräch.
  • search sucht wie die Suche der App über Belege, Umsätze und Kontakte, nach Wörtern und nach Bedeutung.
  • get_export_check prüft einen Zeitraum vor dem DATEV-Export wie die Prüfliste der App.
  • preview_document zeigt eine Seite des Originalbelegs.
  • get_document und get_transaction nennen die aktuellen Buchungsfehler, get_document dazu Erkennungsstand, Lieferdatum und Seitenzahl.
  • search_documents filtert nach überfälligen Rechnungen, Erkennungsstand, fehlender Kategorie, Buchungsfehlern und Kontakt.
  • get_company_context nennt Steuerstatus, Art der Umsätze und Nummernkreise, list_bank_accounts den Zustand der Bankverbindung.
  • create_sales_draft, update_sales_draft und check_sales_draft arbeiten wie der Editor: auch an Entwürfen aus der App, mit Rabatt und Art je Position, Fußtext, Kundenreferenz, Ende des Leistungszeitraums, Skonto und § 13b/§ 4. Neue Entwürfe erhalten die Standardwerte der App.
  • copy_sales_document dupliziert Rechnungen und Angebote und macht aus einem ausgestellten Angebot eine Rechnung.

Verbindungen älterer Versionen behalten ihren Umfang; die Ergänzungen erhalten sie mit einer neuen Freigabe (Anlage 2.3). Ohne mcp:write liest eine Verbindung die Lesetools der Version 2026-10-05 mit den neuen Feldern und Filtern sowie search, get_export_check und preview_document; Kontakte erst mit mcp:write.

Neue Lesetools

WerkzeugTitelBereichDatenkategorienStufeScope
searchSuchenBelege, Bank, KontakteTreffer in denselben Feldern wie search_documents und search_transactions, Kontakte wie search_contacts, mit Trefferart; Wörter nur in Feldern, die MCP ausgibt, und so, wie MCP sie zeigt (kein erkannter Text, keine Gegen-IBAN, IBANs im Text maskiert). Für die Bedeutungssuche geht der Suchtext an Google Vertex AI (EU) und wird nicht gespeichert; sie erreicht auch den erkannten Text der Belege, gibt ihn aber nicht ausLesenmcp:read; Kontakte mit mcp:write
get_export_checkDATEV-Export prüfenBelegeAnzahl und bis zu 20 Beleg-IDs je Prüfpunkt: unvollständig, Erkennung fehlgeschlagen, in Erkennung, nicht zugeordnet, teilweise offen, mit Buchungsfehler; exportiert nichtsLesenmcp:read
preview_documentBeleg ansehenBelegeeine Seite des Originalbelegs; immer die erkannten Daten als Text wie get_document, Anwendungen mit Bildanzeige zusätzlich die Seite als Bild (mit allen Angaben des Belegs, auch zu Dritten)Lesenmcp:read

Neue Schreibtools

WerkzeugTitelRückfrageWirkung
prepare_document_uploadBelege hochladenneinBis zu zehn Dateien (PDF, JPEG, PNG oder E-Rechnung als XML, je bis 30 MiB) mit Name, Größe und SHA-256 anmelden. Je Datei kommt ein Upload-Link, 15 Minuten gültig und nur für genau diese Datei, oder der Hinweis, dass das Unternehmen sie schon hat. Wie Uploads in der App werden die Belege erkannt, können automatisch Zahlungen zugeordnet und gebucht werden und zählen zum Kontingent. Ohne Netzzugang der Anwendung lädt der Nutzer über den Link in die App hoch.
copy_sales_documentRechnung oder Angebot kopierenneinWie Duplizieren und In Rechnung umwandeln in der App: ein neuer Entwurf mit Käufer, Positionen und Texten, dem Datum von heute und derselben Zahlungsfrist bzw. Gültigkeit in Tagen wie das Original. Ein ausgestelltes Angebot wird einmal zur Rechnung, fällig nach dem Zahlungsziel der Firma (ohne Zahlungsziel nach 14 Tagen) und mit der Angebotsnummer als Referenz. Es wird nichts ausgestellt oder gebucht.

create_sales_draft, update_sales_draft und check_sales_draft heißen jetzt Rechnungs- oder Angebotsentwurf anlegen, … ändern und … prüfen: Sie arbeiten an jedem offenen Rechnungs- oder Angebotsentwurf des Unternehmens, auch wenn er in der App entstanden ist. Ändern lässt sich ein Entwurf, wenn MCP ihn vollständig und unverändert zeigt (editable): höchstens 50 Positionen und Texte ohne IBANs und Überlänge (Positionstexte dürfen seit 17.11.2026 Zeilenumbrüche haben, Referenzen nicht); Stornos bleiben in der App. update_sales_draft ersetzt Käufer, Rechnungsdatum, Leistungsdatum, Preisart und Positionen; alle anderen Felder nur, wenn sie gesendet werden, ein leerer Wert entfernt sie. Beim selben Kontakt bleiben Name und Anschrift des Käufers wie gespeichert; ein anderer Kontakt bringt seinen Namen und seine erste Anschrift, Bestätigungen zur USt-IdNr. entfallen dann. Skonto gibt es nur auf Rechnungen mit Fälligkeit, und die Skontofrist endet spätestens mit ihr; § 13b und § 4 nur auf Rechnungen von Unternehmen, für die bimetrics den Steuerfall ableitet.

Nachtrag 04.10.2026: Was per MCP nicht geht

Anders als in der Version 2026-10-05 lassen sich Belege ab dieser Version hochladen. Noch nicht per MCP möglich: Rechnungen stornieren oder versenden, Zahlungen auslösen und Kontakte, Rechnungen oder hochgeladene Belege löschen.

Eingaben und Felder seit 2026-10-09

Nachtrag 07.10.2026: Rechnungsansicht im Chat

Bei aktivierter Rechnungsansicht zeigt open_invoice_draft einen gespeicherten offenen Rechnungsentwurf mit Vorschau. amend_invoice_draft übernimmt ausdrücklich beauftragte Änderungen an einzelnen Feldern oder Positionen; andere Angaben bleiben erhalten. Beide Werkzeuge nutzen die bestehende Schreibfreigabe. Sie stellen keine Rechnung aus und versenden nichts. Für nicht unterstützte Änderungen öffnest du denselben Entwurf in bimetrics.

Nachtrag 10.10.2026: Rechnungsansicht über die OpenAI-Connector-Plattform

Die Rechnungsansicht mit diesen beiden Zusatzwerkzeugen steht ChatGPT und anderen Apps über die OpenAI-Connector-Plattform zur Verfügung, die sich mit https://chatgpt.com/oauth/client.json verbinden. Die gemeinsamen Buchhaltungswerkzeuge und Rechte bleiben für alle zugelassenen Anwendungen gleich.

WerkzeugNeue EingabenNeue Felder im Ergebnis
get_document–processingStatus, deliveryDate, bookingErrors (code, level, explanation), pageCount
get_transaction–bookingErrors
search_documentsoverdue, processingStatus, categoryMissing, hasBookingErrors, contactId–
get_company_context–smallBusiness, freeOfVatLiability, salesKind, invoiceNumbers, proposalNumbers; seit 01.11.2026 nach einem Wechsel der Versteuerung taxStatusHistory, seit 02.11.2026 die Stammdaten der Rechnung: legalForm, legalFormName, managingDirectors, register, address, vatId, taxNumber
list_bank_accounts–connection mit status, validUntil, lastSync
create_sales_draft, update_sales_draftje Position discount und kind; notes, reference, performancePeriodTo, cashDiscount, taxExceptionwie get_sales_document
get_sales_document–je Position kind; notes, reference (nur im PDF, nicht im XML der E-Rechnung), performancePeriodTo, cashDiscount, taxException

Der Link hat die Form https://files.bimetrics.de/api/uploads/<token> und nimmt genau die angemeldete Datei einmal per PUT mit passender Länge an, zum Beispiel mit curl --fail -T beleg.pdf '<uploadUrl>'. Eine andere Datei lehnt er mit 409 ab und bleibt gültig. Ein zweiter PUT derselben Datei nach Erfolg liefert bis zum Ablauf denselben Beleg. Nach Ablauf antwortet er mit 410, auch nach erfolgreichem Upload, nach dem Widerruf der Verbindung mit 403. Die Antwort nennt documentId und den Erkennungsstand; die erkannten Daten liest get_document. Gespeichert wird nur ein Prüfwert des Links.

Belege per Claude hochladen

Claude schickt die Datei aus seiner Code-Umgebung an den Upload-Link. Erlaubt diese Umgebung keine Verbindung zu files.bimetrics.de, nennt nextStep im Ergebnis zwei Wege:

  • In bimetrics auswählen: appUrl öffnet die Belege des Unternehmens mit der Dateiauswahl. Du tippst auf Datei auswählen und wählst den Beleg aus.
  • Domain erlauben: Unter claude.ai/settings/capabilities erlaubst du files.bimetrics.de einmalig für die Code-Ausführung. In Team- und Enterprise-Plänen übernimmt das ein Admin. Danach lädt Claude Belege direkt hoch.

Limits

Zusätzlich zu den Limits der Version 2026-10-05:

BereichGrenze
search, get_export_check, preview_sales_document, get_match_suggestionszusammen 10 je Minute und Verbindung, je Unternehmen einer gleichzeitig; search höchstens 20 Treffer je Aufruf
Upload-Linkshöchstens zehn Dateien je Aufruf; 20 Versuche je Minute und Unternehmen; Uploads zählen zum Tagesbudget in Bytes und zu den Schreibbudgets
get_export_checkZeitraum höchstens ein Jahr

Auf dieser Seite