Tool-Übersicht, Fassung 2026-10-09
Werkzeuge einer MCP-Verbindung, Fassung 2026-10-09 – dazu Belege hochladen, suchen, Monatsabschluss prüfen und Rechnungsentwürfe wie im Editor bearbeiten.
Diese Übersicht gehört zur Freigabe-Fassung 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 Fassung 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 Fassungen behalten ihren Umfang; die Ergänzungen erhalten sie mit einer neuen Freigabe (Anlage 2.3). Ohne mcp:write liest eine Verbindung die Lesetools der Fassung 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; ein ausgestelltes Angebot einmal als Rechnung mit Datum heute, fällig in 14 Tagen und 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 Zeilenumbrüche, IBANs und Überlänge; 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.
Eingaben und Felder seit 2026-10-09
| 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 |
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://app.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.
Limits
Zusätzlich zu den Limits der Fassung 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, Fassung 2026-10-05
Lesetools und Schreibwerkzeuge einer MCP-Verbindung, Fassung 2026-10-05 – was in der App geht, geht auch per MCP, einschließlich Festschreiben nach der Vorschau.
Schreibzugriff
Was eine MCP-Verbindung mit Schreibzugriff in bimetrics ändern kann – seit Fassung 2026-10-05 sofort wie in der App, einschließlich Festschreiben nach der Vorschau.