bimetricsEntwickler
Tools und Vorlagen

Tool-Übersicht, Fassung 2026-10-03

Lesetools und Schreibwerkzeuge einer MCP-Verbindung mit einem oder mehreren Unternehmen, Fassung 2026-10-03.

Als Markdown ansehen

Diese Übersicht gehört zur Freigabe-Fassung 2026-10-03. 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 die Werkzeuge der Fassung 2026-09-30 und list_companies. 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:read2026-09-30
get_contactKontakt lesenKontakteeinzelner Kontakt wie obenLesenmcp:read2026-09-30
search_sales_documentsRechnungen und Entwürfe suchenAusgangsdokumenteNummer, Art, Status, Kontakt-ID, externe Referenz, Anzahl der Positionen; ohne PositionsdetailsLesenmcp:read2026-09-30
get_sales_documentRechnung oder Entwurf lesenAusgangsdokumentewie oben, dazu höchstens 50 Positionen mit Bezeichnung, Beschreibung, Menge, Einheit, Einzelpreis, USt-Satz; ohne Käuferadressen, Käufer-Steuerkennungen, Bankdaten und DateienLesenmcp:read2026-09-30
check_sales_draftEigenen Rechnungsentwurf prüfenAusgangsdokumenteSteuerfall-Vorprüfung eines offenen Entwurfs dieses MCP-Clients und Inhabers; verändert nichtsLesenmcp:read2026-09-30
get_approval_statusFreigabestatus lesenFreigabenStatus eines Freigabekorbs dieser Verbindung; bestätigt und startet keine AktionLesenmcp:read2026-09-30

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

Schreibtools

Einmal neu verbinden und mcp:write ausdrücklich wählen. Alle späteren Schreibtools verwenden denselben Scope. Ohne ihn antwortet ein Schreibaufruf mit insufficient_scope; der Client kann zur Neuverbindung auffordern.

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 ein Inhaber 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