# Tool-Übersicht, Fassung 2026-10-09 (https://developer.bimetrics.de/mcp/tools/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](https://bimetrics.de/rechtliches/2026-10-09-v1/avv#anlage-mcp-verbindungen). Sie umfasst die Werkzeuge der [Fassung 2026-10-05](/mcp/tools/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 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://files.bimetrics.de/api/uploads/` und nimmt genau die angemeldete Datei einmal per `PUT` mit passender Länge an, zum Beispiel mit `curl --fail -T beleg.pdf ''`. 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](https://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 Fassung 2026-10-05](/mcp/tools/2026-10-05#limits): | 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 |