# Tool-Übersicht, Fassung 2026-10-04 (https://developer.bimetrics.de/mcp/tools/2026-10-04) Lesetools und Schreibwerkzeuge einer MCP-Verbindung mit einem oder mehreren Unternehmen, Schreibzugriff vorausgewählt, Fassung 2026-10-04. Diese Übersicht gehört zur Freigabe-Fassung **2026-10-04**. Die Freigabeseite in bimetrics verlinkt sie bei jeder neuen Verbindung. Auf der Freigabeseite wählst du ein oder mehrere Unternehmen; jedes erhält eine eigene Freigabe. Die Fassung umfasst dieselben Werkzeuge wie die [Fassung 2026-10-03](/mcp/tools/2026-10-03): die Werkzeuge der [Fassung 2026-09-30](/mcp/tools/2026-09-30) und `list_companies`. Neu ist: **Schreibzugriff erlauben** ist vorausgewählt (siehe [Schreibtools](#schreibtools)), und Teammitglieder mit MCP-Recht können selbst verbinden (siehe [Berechtigungen und Freigabe](/mcp/permissions)). Ohne `mcp:write` liest eine Verbindung die 14 Lesetools der [Fassung 2026-09-28](/mcp/tools/2026-09-28) und `list_companies`, mit `mcp:write` zusätzlich sechs 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. ## Lesetools | Werkzeug | Titel | Bereich | Datenkategorien | Stufe | Scope | Seit Fassung | | ------------------------ | ------------------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | ------------------------ | ------------ | | `list_companies` | Firmen auflisten | Unternehmen | ID und Name der Unternehmen der Verbindung, die gerade nutzbar sind | Lesen | `mcp:read` | 2026-10-03 | | `get_company_context` | Firma lesen | Unternehmen | Name, Kontenrahmen, Buchhaltungswährung | Lesen | `mcp:read` | 2026-09-28 | | `search_documents` | Belege suchen | Belege | Belegart, Rechnungsnummer, Datum, Leistungszeitraum, Rechnungspartner, Betrag, Kategorien, Zuordnungsstatus | Lesen | `mcp:read` | 2026-09-28 | | `get_document` | Beleg lesen | Belege | wie oben, dazu bis zu 30 Positionen mit Bezeichnung, Betrag, USt-Satz, Kategorie | Lesen | `mcp:read` | 2026-09-28 | | `search_transactions` | Umsätze suchen | Bank | Buchungs- und Wertstellungsdatum, Status, Gegenpartei, Verwendungszweck (IBAN gekürzt), Betrag, Währung, Bankkonto, Zuordnung | Lesen | `mcp:read` | 2026-09-28 | | `get_transaction` | Umsatz lesen | Bank | einzelner Umsatz wie oben | Lesen | `mcp:read` | 2026-09-28 | | `get_match` | Zuordnung lesen | Zuordnung | Kategorie, offener Betrag, Skonto, IDs der Belege und Umsätze | Lesen | `mcp:read` | 2026-09-28 | | `get_match_suggestions` | Zuordnungsvorschläge lesen | Zuordnung | Vorschläge der App mit Gegenstück und Bewertung; nichts wird zugeordnet | Lesen | `mcp:read` | 2026-09-28 | | `get_open_amount` | Offenen Betrag berechnen | Zuordnung | offener Betrag einer Auswahl; nichts wird gespeichert | Lesen | `mcp:read` | 2026-09-28 | | `list_categories` | Kategorien auflisten | Buchhaltung | Kategorienkatalog mit Konten im Kontenrahmen | Lesen | `mcp:read` | 2026-09-28 | | `list_accounts` | Sachkonten auflisten | Buchhaltung | verwendete Konten mit Bezeichnung; Personenkonten ohne Kontaktnamen | Lesen | `mcp:read` | 2026-09-28 | | `list_bank_accounts` | Bankkonten auflisten | Bank | Bank, Produkt, Kontoinhaber, gekürzte IBAN, Währung, Saldo | Lesen | `mcp:read` | 2026-09-28 | | `get_bank_account` | Bankkonto lesen | Bank | einzelnes Bankkonto wie oben | Lesen | `mcp:read` | 2026-09-28 | | `search_bookings` | Buchungen suchen | Buchhaltung | vorbereitete Buchungen: Datum, Leistungszeitraum, Betrag, Soll/Haben, Konto, Gegenkonto, Steuerkennzeichen, Buchungstext, Bezüge | Lesen | `mcp:read` | 2026-09-28 | | `get_booking` | Buchung lesen | Buchhaltung | einzelne Buchung wie oben | Lesen | `mcp:read` | 2026-09-28 | | `search_contacts` | Kontakte suchen | Kontakte | Kontaktnummer, Name, Typ, externe Referenz, bis zu zehn Adressen, Ansprechpartner, E-Mail, Telefon, Website, USt-IdNr., Leitweg-ID; ohne Bankdaten und Notizen | Lesen | `mcp:read` + `mcp:write` | 2026-09-30 | | `get_contact` | Kontakt lesen | Kontakte | einzelner Kontakt wie oben | Lesen | `mcp:read` + `mcp:write` | 2026-09-30 | | `search_sales_documents` | Rechnungen und Entwürfe suchen | Ausgangsdokumente | Nummer, Art, Status, Kontakt-ID, externe Referenz, Anzahl der Positionen; ohne Positionsdetails | Lesen | `mcp:read` + `mcp:write` | 2026-09-30 | | `get_sales_document` | Rechnung oder Entwurf lesen | Ausgangsdokumente | wie oben, dazu Rechnungs-, Leistungs- und Fälligkeitsdatum, Preisart, Bemerkung und höchstens 50 Positionen mit Bezeichnung, Beschreibung, Menge, Einheit, Einzelpreis, USt-Satz, Rabatt und Betrag nach Rabatt; ohne Käuferadressen, Käufer-Steuerkennungen, Bankdaten und Dateien | Lesen | `mcp:read` + `mcp:write` | 2026-09-30 | | `check_sales_draft` | Eigenen Rechnungsentwurf prüfen | Ausgangsdokumente | Steuerfall-Vorprüfung eines offenen Entwurfs, den dieser MCP-Client für diese Person angelegt hat; meldet auch fehlenden Firmennamen und unvollständige Anschriften als blockierend; verändert nichts | Lesen | `mcp:read` + `mcp:write` | 2026-09-30 | | `get_approval_status` | Freigabestatus lesen | Freigaben | Status eines Freigabekorbs dieser Verbindung; bestätigt und startet keine Aktion | Lesen | `mcp:read` + `mcp:write` | 2026-09-30 | Vorlagen und Produktwissen sind dieselben wie in der [Fassung 2026-09-28](/mcp/tools/2026-09-28#vorlagen). ## Schreibtools `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 späteren Schreibtools verwenden denselben Scope. Ohne ihn antwortet ein Schreibaufruf mit `insufficient_scope`; der Client kann zur Neuverbindung auffordern. Lässt bimetrics Schreiben für die Anwendung oder das Unternehmen nicht zu, erhält der Aufruf ein Tool-Ergebnis mit Fehler und Grund. | Stufe | Tools | Wirkung | | ------------ | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | A – direkt | `create_contacts`, `update_contact` | Kontakte anlegen und erlaubte Felder ändern; keine Bankdaten. | | A – direkt | `create_sales_draft`, `update_sales_draft` | Rechnungsentwürfe anlegen und eigene offene Entwürfe ändern, bis ein Nutzer sie im Editor übernimmt. Notizen, Steuertext und Skonto bleiben bei MCP-Änderungen erhalten. | | B – Freigabe | `create_match`, `delete_match` | Zuordnungen vorschlagen; erst die Bestätigung in bimetrics führt sie aus. Beim Aufheben können Belege aus Vorlagen entfallen; die Freigabe nennt sie ausdrücklich. | | B – Freigabe | `update_document` | Erlaubte Belegkorrekturen vorschlagen; Ausführung erst nach Bestätigung. | Festschreiben, Stornieren und eigenständiges Löschen von Rechnungen oder Belegen sind per MCP nicht möglich. Buchungswirksame Änderungen bestätigt die Person, die die Verbindung freigegeben hat, unter **Freigaben**. Festgeschriebene Buchungen – auch über Zuordnungen – bleiben geschützt. Nicht ausgewählte Einträge einer Teilfreigabe werden verworfen. Die [Berechtigungsseite](/mcp/permissions) erklärt Verbindung, Laufzeiten und Widerruf. [Schreibzugriff](/mcp/write-access) beschreibt die Vorschau und ihre Grenzen.