Tool-Übersicht, Fassung 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: die Werkzeuge der Fassung 2026-09-30 und list_companies. Neu ist: Schreibzugriff erlauben ist vorausgewählt (siehe Schreibtools), und Teammitglieder mit MCP-Recht können selbst verbinden (siehe Berechtigungen und Freigabe). Ohne mcp:write liest eine Verbindung die 14 Lesetools der Fassung 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.
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 erklärt Verbindung, Laufzeiten und Widerruf. Schreibzugriff beschreibt die Vorschau und ihre Grenzen.