bimetricsEntwickler
Tools und Vorlagen

Tool-Übersicht, Fassung 2026-10-04

Lesetools und Schreibwerkzeuge einer MCP-Verbindung mit einem oder mehreren Unternehmen, Schreibzugriff vorausgewählt, Fassung 2026-10-04.

Als Markdown ansehen

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

WerkzeugTitelBereichDatenkategorienStufeScopeSeit Fassung
list_companiesFirmen auflistenUnternehmenID und Name der Unternehmen der Verbindung, die gerade nutzbar sindLesenmcp:read2026-10-03
get_company_contextFirma lesenUnternehmenName, Kontenrahmen, BuchhaltungswährungLesenmcp:read2026-09-28
search_documentsBelege suchenBelegeBelegart, Rechnungsnummer, Datum, Leistungszeitraum, Rechnungspartner, Betrag, Kategorien, ZuordnungsstatusLesenmcp:read2026-09-28
get_documentBeleg lesenBelegewie oben, dazu bis zu 30 Positionen mit Bezeichnung, Betrag, USt-Satz, KategorieLesenmcp:read2026-09-28
search_transactionsUmsätze suchenBankBuchungs- und Wertstellungsdatum, Status, Gegenpartei, Verwendungszweck (IBAN gekürzt), Betrag, Währung, Bankkonto, ZuordnungLesenmcp:read2026-09-28
get_transactionUmsatz lesenBankeinzelner Umsatz wie obenLesenmcp:read2026-09-28
get_matchZuordnung lesenZuordnungKategorie, offener Betrag, Skonto, IDs der Belege und UmsätzeLesenmcp:read2026-09-28
get_match_suggestionsZuordnungsvorschläge lesenZuordnungVorschläge der App mit Gegenstück und Bewertung; nichts wird zugeordnetLesenmcp:read2026-09-28
get_open_amountOffenen Betrag berechnenZuordnungoffener Betrag einer Auswahl; nichts wird gespeichertLesenmcp:read2026-09-28
list_categoriesKategorien auflistenBuchhaltungKategorienkatalog mit Konten im KontenrahmenLesenmcp:read2026-09-28
list_accountsSachkonten auflistenBuchhaltungverwendete Konten mit Bezeichnung; Personenkonten ohne KontaktnamenLesenmcp:read2026-09-28
list_bank_accountsBankkonten auflistenBankBank, Produkt, Kontoinhaber, gekürzte IBAN, Währung, SaldoLesenmcp:read2026-09-28
get_bank_accountBankkonto lesenBankeinzelnes Bankkonto wie obenLesenmcp:read2026-09-28
search_bookingsBuchungen suchenBuchhaltungvorbereitete Buchungen: Datum, Leistungszeitraum, Betrag, Soll/Haben, Konto, Gegenkonto, Steuerkennzeichen, Buchungstext, BezügeLesenmcp:read2026-09-28
get_bookingBuchung lesenBuchhaltungeinzelne Buchung wie obenLesenmcp:read2026-09-28
search_contactsKontakte suchenKontakteKontaktnummer, Name, Typ, externe Referenz, bis zu zehn Adressen, Ansprechpartner, E-Mail, Telefon, Website, USt-IdNr., Leitweg-ID; ohne Bankdaten und NotizenLesenmcp:read + mcp:write2026-09-30
get_contactKontakt lesenKontakteeinzelner Kontakt wie obenLesenmcp:read + mcp:write2026-09-30
search_sales_documentsRechnungen und Entwürfe suchenAusgangsdokumenteNummer, Art, Status, Kontakt-ID, externe Referenz, Anzahl der Positionen; ohne PositionsdetailsLesenmcp:read + mcp:write2026-09-30
get_sales_documentRechnung oder Entwurf lesenAusgangsdokumentewie 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 DateienLesenmcp:read + mcp:write2026-09-30
check_sales_draftEigenen Rechnungsentwurf prüfenAusgangsdokumenteSteuerfall-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 nichtsLesenmcp:read + mcp:write2026-09-30
get_approval_statusFreigabestatus lesenFreigabenStatus eines Freigabekorbs dieser Verbindung; bestätigt und startet keine AktionLesenmcp:read + mcp:write2026-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.

StufeToolsWirkung
A – direktcreate_contacts, update_contactKontakte anlegen und erlaubte Felder ändern; keine Bankdaten.
A – direktcreate_sales_draft, update_sales_draftRechnungsentwü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 – Freigabecreate_match, delete_matchZuordnungen 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 – Freigabeupdate_documentErlaubte 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.

Auf dieser Seite