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.
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_uploadlädt Belege hoch: Die Anwendung meldet die Dateien an und schickt jede per HTTP-PUTan einen eigenen Upload-Link, nie durch das Gespräch.searchsucht wie die Suche der App über Belege, Umsätze und Kontakte, nach Wörtern und nach Bedeutung.get_export_checkprüft einen Zeitraum vor dem DATEV-Export wie die Prüfliste der App.preview_documentzeigt eine Seite des Originalbelegs.get_documentundget_transactionnennen die aktuellen Buchungsfehler,get_documentdazu Erkennungsstand, Lieferdatum und Seitenzahl.search_documentsfiltert nach überfälligen Rechnungen, Erkennungsstand, fehlender Kategorie, Buchungsfehlern und Kontakt.get_company_contextnennt Steuerstatus, Art der Umsätze und Nummernkreise,list_bank_accountsden Zustand der Bankverbindung.create_sales_draft,update_sales_draftundcheck_sales_draftarbeiten 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_documentdupliziert 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
| Werkzeug | Titel | Bereich | Datenkategorien | Stufe | Scope |
|---|---|---|---|---|---|
search | Suchen | Belege, Bank, Kontakte | Treffer 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 aus | Lesen | mcp:read; Kontakte mit mcp:write |
get_export_check | DATEV-Export prüfen | Belege | Anzahl und bis zu 20 Beleg-IDs je Prüfpunkt: unvollständig, Erkennung fehlgeschlagen, in Erkennung, nicht zugeordnet, teilweise offen, mit Buchungsfehler; exportiert nichts | Lesen | mcp:read |
preview_document | Beleg ansehen | Belege | eine 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) | Lesen | mcp:read |
Neue Schreibtools
| Werkzeug | Titel | Rückfrage | Wirkung |
|---|---|---|---|
prepare_document_upload | Belege hochladen | nein | Bis 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_document | Rechnung oder Angebot kopieren | nein | Wie 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.
| Werkzeug | Neue Eingaben | Neue Felder im Ergebnis |
|---|---|---|
get_document | – | processingStatus, deliveryDate, bookingErrors (code, level, explanation), pageCount |
get_transaction | – | bookingErrors |
search_documents | overdue, 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_draft | je Position discount und kind; notes, reference, performancePeriodTo, cashDiscount, taxException | wie get_sales_document |
get_sales_document | – | je Position kind; notes, reference (nur im PDF, nicht im XML der E-Rechnung), performancePeriodTo, cashDiscount, taxException |
Upload-Link
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.deeinmalig 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:
| Bereich | Grenze |
|---|---|
search, get_export_check, preview_sales_document, get_match_suggestions | zusammen 10 je Minute und Verbindung, je Unternehmen einer gleichzeitig; search höchstens 20 Treffer je Aufruf |
| Upload-Links | höchstens zehn Dateien je Aufruf; 20 Versuche je Minute und Unternehmen; Uploads zählen zum Tagesbudget in Bytes und zu den Schreibbudgets |
get_export_check | Zeitraum höchstens ein Jahr |
Tool-Übersicht, MCP-Version 2026-10-05
Lesetools und Schreibwerkzeuge einer MCP-Verbindung, Version 2026-10-05 – was in der App geht, geht auch per MCP, einschließlich Festschreiben nach der Vorschau.
Tool-Übersicht, MCP-Version 2026-10-10
Optionale Auftragsbestätigungen, ausdrücklich gewählte Rechnungsquelle und vollständiger PDF-Download.