Tool-Übersicht, Fassung 2026-10-05

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

• list_document_templates listet die Belegvorlagen, die create_match zuordnen kann.
• search_documents filtert nach Betrag, search_transactions nach Betrag und Richtung (Eingang oder Ausgang).
• dismiss_match_suggestion blendet einen Zuordnungsvorschlag aus wie Vorschlag ausblenden in der App.
• create_sales_draft und update_sales_draft legen auch Angebotsentwürfe an und ändern sie.
• update_contact ändert alle Felder, die das Kontaktformular der App ändert, auch Anschriften, Kundennummer, Kundentyp, IBAN und BIC. Kontakte lesen dazu Kundentyp, gekürzte IBAN und BIC.
• create_match, delete_match und update_document wirken sofort wie in der App, statt einen Vorschlag zur Freigabe in bimetrics anzulegen.
• get_match nennt die Belege, die bimetrics für die Zuordnung aus einer Belegvorlage erzeugt hat und die beim Aufheben entfallen.
• preview_sales_document zeigt eine Seite einer Rechnung, eines Angebots oder eines Entwurfs als Bild, so wie bimetrics sie druckt.
• finalize_sales_draft schreibt einen Rechnungsentwurf fest oder stellt ein Angebot aus wie Rechnung erstellen und Angebot erstellen in der App, aber nur in dem Stand, den die Vorschau gezeigt hat.

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 14 Lesetools der Fassung 2026-09-28 mit den neuen Filtern, list_companies und list_document_templates, mit mcp:write zusätzlich sieben weitere Lesetools.

Jedes Werkzeug arbeitet je Aufruf in einem der gewählten Unternehmen. Das optionale Argument company nennt es mit ID oder genauem Namen. Ohne company gilt bei einem Unternehmen dieses; bei mehreren lehnt der Server den Aufruf ab und nennt die Unternehmen.

LesetoolsLink zu diesem Abschnitt kopieren

Vorlagen und Produktwissen sind dieselben wie in der Fassung 2026-09-28.

SchreibtoolsLink zu diesem Abschnitt kopieren

mcp:write ist auf der Freigabeseite mit Schreibzugriff erlauben vorausgewählt, wo Schreiben möglich ist, auch wenn die Anwendung nur mcp:read anfragt. Ohne Häkchen bleibt die Verbindung lesend. Alle Schreibtools verwenden denselben Scope; das Festschreiben gehört dazu. Ohne ihn antwortet ein Schreibaufruf mit insufficient_scope; der Client kann zur Neuverbindung auffordern. Ist Schreiben derzeit nicht verfügbar oder für das Unternehmen nicht aktiviert, erhält der Aufruf ein Tool-Ergebnis mit Fehler und Grund. Jede zugelassene Anwendung erhält dieselben Werkzeuge, Schreiben eingeschlossen; nur ob ein Bild der Vorschau mitkommt, hängt von der Anwendung ab (Gleicher Umfang für jede Anwendung).

Alle Schreibtools wirken sofort wie die entsprechende Funktion der App (Stufe A). Ein Freigabekorb in bimetrics entsteht nicht mehr. „Rückfrage“ heißt: Das Werkzeug ist als destruktiv gekennzeichnet (destructiveHint), damit die Anwendung vorher bei dir nachfragen kann.

Jede Änderung braucht einen Idempotenzschlüssel (idempotencyKey); eine Wiederholung mit demselben Schlüssel ändert nichts erneut und liefert dasselbe Ergebnis. Rechte, Mandantentrennung, Schreibbudgets und Protokoll (Quelle mcp) gelten wie bei allen Schreibtools (siehe Schreibzugriff).

Festschreiben nach der VorschauLink zu diesem Abschnitt kopieren

1. preview_sales_document zeigt den Entwurf so, wie bimetrics ihn druckt: als Text mit Käufer, Daten, Referenz, Bemerkung, allen Positionen samt Beschreibung, Netto, USt, Brutto, Zahlungsbedingungen und Notizen, in Anwendungen mit Bildanzeige zusätzlich als Bild. Für einen offenen Rechnungs- oder Angebotsentwurf ohne blockierende Probleme, mit höchstens 20 Seiten und mit Positionen und Texten, die vollständig ins Ergebnis passen, liefert es previewToken und updatedAt.
2. Die Anwendung zeigt dir die Vorschau und fragt, ob sie festschreiben soll.
3. finalize_sales_draft nimmt previewToken, updatedAt als expectedUpdatedAt, grossTotal als expectedGrossTotal und buyerName als expectedBuyerName. bimetrics prüft unter Sperre, dass genau dieser Stand gedruckt wird. Hat sich der Entwurf oder das Gedruckte geändert, weichen Betrag oder Käufer ab oder ist die Vorschau älter als 15 Minuten, passiert nichts und es wird keine Nummer vergeben.

Ob die Anwendung vor einer Änderung bei dir nachfragt, stellst du in der Anwendung ein; ob du dort bestätigt hast, kann bimetrics nicht prüfen. Verbindlich ist die Ansicht in bimetrics über den Link (appUrl).

Was per MCP nicht gehtLink zu diesem Abschnitt kopieren

Stornieren, Zahlungen, Uploads, das Versenden an Kunden und das Löschen von Kontakten, Rechnungen und hochgeladenen Belegen gehen per MCP nicht. Festgeschriebene Buchungen – auch über Zuordnungen – bleiben geschützt; ausgestellte Rechnungen, Belege aus Vorlagen oder Verträgen und Belege mit erfassten Zahlungen lassen sich nicht berichtigen. Verbindungen älterer Fassungen schlagen Zuordnungen und Belegkorrekturen weiter zur Freigabe unter Freigaben vor.

Eingaben und Felder seit 2026-10-05Link zu diesem Abschnitt kopieren

LimitsLink zu diesem Abschnitt kopieren

Zusätzlich zu den Limits aller Tools:

Die Berechtigungsseite erklärt Verbindung, Laufzeiten und Widerruf, Schreibzugriff die Rechte und die Freigaben älterer Fassungen.