bimetricsEntwickler

Berechtigungen und Freigabe

Was eine MCP-Freigabe erlaubt, wer sie erteilen kann und wann sie endet.

Als Markdown ansehen

Wer freigeben kann

  • Ein Nutzer mit der Rolle Inhaber, eingeloggt im eigenen Browser. API-Schlüssel können keine MCP-Verbindung freigeben.
  • Ein Teammitglied (Rolle Nutzer oder Steuerberater), dem ein Inhaber unter Einstellungen › Team das MCP-Recht gegeben hat: MCP: nur lesen oder MCP: lesen und schreiben. Mit MCP: nur lesen bietet die Freigabeseite keinen Schreibzugriff an; Schreibaufrufe erhalten ein Tool-Ergebnis mit Fehler und Grund. Inhaber werden über jede neue Verbindung eines Teammitglieds per Mail informiert.
  • Jede Freigabe gilt für genau ein Unternehmen. Auf der Freigabeseite kannst du mehrere Unternehmen wählen; die Verbindung bündelt dann je Unternehmen eine eigene Freigabe. Jedes Unternehmen wird bei jedem Aufruf einzeln geprüft und lässt sich unter Einstellungen › KI-Assistenten einzeln entfernen.
  • Das Unternehmen braucht einen bezahlten Tarif, eine Freischaltung durch bimetrics oder eine laufende Testphase.

MCP für Teammitglieder

  1. Ein Inhaber öffnet Einstellungen › Team (app.bimetrics.de/settings/team) und wählt beim Teammitglied unter MCP-Recht MCP: nur lesen oder MCP: lesen und schreiben. bimetrics speichert, wer das Recht wann vergeben hat.
  2. Das Teammitglied verbindet seine KI-Anwendung selbst, wie unter Verbinden beschrieben. Alle Inhaber erhalten eine Mail, das Teammitglied eine Bestätigung.
  3. Unter Einstellungen › KI-Assistenten sieht das Teammitglied nur seine eigenen Verbindungen und kann sie widerrufen. Mit MCP: lesen und schreiben kann seine Anwendung ab MCP-Version 2026-10-05 per MCP dasselbe ändern wie die Anwendung eines Inhabers, Festschreiben eingeschlossen; Vorschläge von Verbindungen älterer Versionen bestätigt es selbst unter Freigaben. Inhaber sehen alle Verbindungen des Unternehmens und können jede auf Lesen beschränken oder widerrufen.
  4. Setzt ein Inhaber das Recht auf Kein MCP-Recht, enden die Verbindungen des Teammitglieds für dieses Unternehmen; mit MCP: nur lesen verlieren sie den Schreibzugriff.

Berechtigungen (Scopes)

BerechtigungErlaubt
mcp:readdie Lesetools und Vorlagen der freigegebenen Version: 14 Lesetools mit Version 2026-09-28, 20 mit Version 2026-09-30; ab Version 2026-10-03 zusätzlich list_companies, die sechs Lesetools der Version 2026-09-30 nur mit mcp:write; ab Version 2026-10-05 zusätzlich list_document_templates und Betrags- und Richtungsfilter, mit mcp:write auch preview_sales_document; ab Version 2026-10-09 zusätzlich search, get_export_check und preview_document (Originalbelege als Bild) sowie neue Felder und Filter, Kontakte in search nur mit mcp:write; ab Version 2026-10-10 außerdem Vertriebsdokumente einschließlich Auftragsbestätigungen lesen, prüfen, vollständig ansehen und mit download_sales_document als PDF herunterladen; ab Version 2026-10-11 auch Forderungen, Mahnungen, Rechnungskorrekturen, Erstattungs- und Verrechnungsstände sowie Serienvorlagen lesen und ausgestellte Zahlungserinnerungen und Mahnungen mit download_payment_reminder als PDF herunterladen; ab Version 2026-10-16 liest get_document die Angaben für eine Berichtigung, mit mcp:write kommt preview_document_change dazu; ab Version 2026-11-01 mit eingeschalteter Zahlungserfassung den Zahlungsstand eines Belegs (get_document_payment); ab Version 2026-11-04 „Zu erledigen“ (get_open_tasks), Rechnungslayouts, Logo, die vorbereitete E-Mail (preview_document_mail) und ausgestellte E-Rechnungen als XML, mit mcp:write auch preview_invoice_layout; ab Version 2026-11-05 das Belegpostfach mit Anhängen, eingelesene Kontoauszüge, Dauerbuchungen, Duplikate und die Vorschauen zum Löschen, zu Dauerbuchungen und zu Sammelaktionen
mcp:writezusätzlich die Schreibwerkzeuge; seit Version 2026-10-04 auf der Freigabeseite vorausgewählt und abwählbar. Ab Version 2026-10-05 wirken sie sofort wie in der App, das Festschreiben von Rechnungsentwürfen nach der Vorschau eingeschlossen; ab Version 2026-10-09 auch Belege hochladen, Entwürfe aus der App bearbeiten und Rechnungen oder Angebote kopieren. Ab Version 2026-10-10 mit derive_sales_document eine AB aus einem finalen Angebot oder eine Rechnung aus einer finalen AB erstellen, AB-Entwürfe bearbeiten und finalisieren sowie mit delete_order_confirmation_draft offene AB-Entwürfe verwerfen. Ab Version 2026-10-11 Mahnungen erstellen, ausstellen und zurückziehen, Rechnungskorrekturen erstellen und aufheben, auf deinen Auftrag bereits erfolgte Erstattungen erfassen und Guthaben mit offenen Rechnungen desselben Kunden verrechnen sowie Serien für Rechnungsentwürfe einrichten, pausieren und beenden. Ab Version 2026-10-16 Belege berichtigen wie in der App, auch Beträge, Positionen, Belegart, Gegenpartei und Steuerfall. Ab Version 2026-11-01 mit eingeschalteter Zahlungserfassung schon erfolgte Zahlungen erfassen und zurücknehmen. Ab Version 2026-11-04 Rechnungen stornieren, Dokumente per E-Mail senden, offene Entwürfe löschen, Zuordnungen erweitern, Firmendaten, Rechnungslayouts und Logo ändern. Ab Version 2026-11-05 Belege löschen, Kontoauszüge einlesen (nur der Inhaber), Anhänge aus dem Belegpostfach übernehmen, Belegvorlagen und Dauerbuchungen pflegen und bis zu 50 Belege auf einmal ändern. Voraussetzungen und Folgen unter Schreibzugriff
offline_accessein Refresh-Token, damit die Anwendung ohne neue Anmeldung weiterlesen kann, bis die Verbindung endet; jede Anwendung mit Grant-Typ refresh_token erhält es bei der Freigabe, auch ohne es anzufragen

Die Lesefreigabe umfasst die Lesetools des Scope A. Einzelne Lesetools lassen sich nicht abwählen. Die Kontakt-, Ausgangsdokument- und Statusabfragen kamen mit Version 2026-09-30. Bis Version 2026-10-09 liest eine Verbindung sie nur mit Schreibzugriff. Ab Version 2026-10-10 umfasst bereits die Lesefreigabe Ausgangsdokumente, Entwurfsprüfung, Druckvorschau und vollständigen PDF-Download; Kontakte und Freigabekörbe brauchen weiterhin Schreibzugriff. Bestehende Verbindungen behalten ihren freigegebenen Umfang.

Schreibzugriff bei der Freigabe

Seit Version 2026-10-04 ist Schreibzugriff erlauben (seit Version 2026-10-23 der Schalter Ändern wie in der App) auf der Freigabeseite vorausgewählt, wo Schreiben möglich ist, auch wenn die Anwendung nur mcp:read anfragt. Entfernst du das Häkchen, bleibt die Verbindung lesend; ein späterer Schreibauftrag fordert die Freigabe erneut an. Bestehende Leseverbindungen erhalten Schreibzugriff mit einer neuen Freigabe. Das Häkchen erscheint für jede zugelassene Anwendung gleich; die Berechtigungen hängen nie davon ab, welche Anwendung sich verbindet (Gleicher Umfang für jede Anwendung).

Ab Version 2026-10-05 wirkt jedes Schreibwerkzeug sofort wie in der App: Kontakte, Rechnungs- und Angebotsentwürfe, Zuordnungen, Belegkorrekturen und das Festschreiben von Rechnungsentwürfen nach Abruf der aktuellen Vorschau. Die Freigabeseite nennt das Festschreiben ausdrücklich unter dem Häkchen. Es ist endgültig; danach lässt sich eine festgeschriebene Rechnung nur noch per Rechnungskorrektur mindern (per MCP ab Version 2026-10-11) oder in bimetrics stornieren. Das Vollstorno geht per MCP ab Version 2026-11-04, das Löschen hochgeladener Belege ab Version 2026-11-05, vorher nur in bimetrics. Kontakte und ausgestellte Rechnungen löschst du nur in bimetrics; Zahlungen löst bimetrics nicht aus. Bis Version 2026-10-04 trennt die Tool-Übersicht Stufe A (Kontakte und eigene Entwürfe direkt) von Stufe B (Zuordnungen und Belegkorrekturen nach Freigabe); dort bleibt auch das Festschreiben in bimetrics. Eine Verbindung dieser Versionen erhält den neuen Umfang, wenn du sie neu verbindest. Ab Version 2026-10-09 kommen das Hochladen von Belegen, das Bearbeiten von Entwürfen aus der App und das Kopieren von Rechnungen und Angeboten dazu.

Ab Version 2026-10-10 ist die Auftragsbestätigung ein optionales Vertriebsdokument mit eigener Nummer und unveränderlichem PDF. Sie erzeugt keine Buchungen und keine E-Rechnungs-XML. Die Rechnung entsteht ausdrücklich aus der finalen AB; der direkte Weg vom Angebot zur Rechnung bleibt verfügbar. Finalisierte ABs sind unveränderlich, nur offene AB-Entwürfe lassen sich verwerfen. Versand, Kundenzusage und ein Versandstatus gehören nicht dazu. Die neue Tool-Übersicht gilt mit dem bestehenden Rechtspaket 2026-10-09-v1 gemäß Anlage 2.3. Eine alte Verbindung erhält keine zusätzlichen Rechte automatisch.

Ab Version 2026-10-11 erstellt die Anwendung mit Schreibzugriff Zahlungserinnerungen und Mahnungen und stellt sie nach der PDF-Vorschau aus, ohne Versand und ohne Buchung. Mahngebühr, Verzugszinsen und Pauschale fordert sie nur so, wie dein Unternehmen sie eingestellt hat, und kann sie je Mahnung weglassen. Rechnungskorrekturen werden wie Rechnungen nach der Vorschau ausgestellt und gebucht. Erstattungen und Verrechnungen hält sie nur fest; überwiesen wird nichts. Serien bereiten ausschließlich Rechnungsentwürfe vor. Die Freigabe einer Serie hängt an deiner Mitgliedschaft im Unternehmen, nicht an der Verbindung: Trennst oder widerrufst du die Verbindung, läuft die Serie weiter, bis du sie pausierst oder beendest. Die Tool-Übersicht gilt mit dem Rechtspaket 2026-10-09-v1.

Ab Version 2026-10-16 berichtigt die Anwendung Belege wie in der App, auch Beträge, Positionen, Belegart, Gegenpartei und Steuerfall. Die Berichtigung bucht sofort neu; preview_document_change zeigt die Folgen vorher, ohne zu speichern. Belege mit an DATEV exportierten Buchungen bleiben gesperrt; nur festgeschriebene storniert bimetrics und bucht neu. Die Tool-Übersicht gilt mit dem Rechtspaket 2026-10-10-v1.

Ab Version 2026-11-04 storniert die Anwendung Rechnungen, erst als Entwurf und nach der Vorschau endgültig, löscht offene Entwürfe, erweitert Zuordnungen und ändert Firmendaten, Rechnungslayouts und Logo. Ausgestellte Dokumente sendet sie per E-Mail, genau so, wie die Vorschau sie gezeigt hat. Der Schalter nennt dazu das Hochladen, Festschreiben, Stornieren und Senden. Kontenrahmen, Versteuerung, die Bankverbindung der Firma, Team und Tarif bleiben in der App; Zahlungen löst bimetrics nicht aus. Die Tool-Übersicht gilt mit dem Rechtspaket 2026-11-04-v1.

Ab Version 2026-11-05 löscht die Anwendung auch Belege, liest Kontoauszüge ein, pflegt Dauerbuchungen und ändert bis zu 50 Belege auf einmal, jeweils erst nach einer Vorschau. Direkt übernimmt sie Anhänge aus dem Belegpostfach und pflegt eigene Belegvorlagen. Aus direkten Zuordnungen lernt bimetrics Regeln wie in der App. Der Schalter nennt dazu das Löschen und Einlesen, die Zeile „Lesen“ die Mails im Belegpostfach. Kontoauszüge liest nur der Inhaber ein. Mails löschst du nur in der App. Die Tool-Übersicht gilt mit dem Rechtspaket 2026-11-05-v1.

Was die Anwendung lesen kann

Die Anwendung kann die beschriebenen Ansichten gespeicherter Belege, Bankumsätze, Bankkonten, Buchungen, Sachkonten, Kategorien und Zuordnungen des freigegebenen Unternehmens lesen, mit Version 2026-09-30 auch Geschäftskontakte und Ausgangsdokumente einschließlich Rechnungen, Entwürfen und Angeboten, ab Version 2026-10-05 auch Belegvorlagen, nicht nur die zu deiner aktuellen Frage. IBANs in Texten sind gekürzt. Ab Version 2026-10-09 sieht sie mit preview_document auch die Originalbelege: immer die erkannten Daten als Text, in Anwendungen mit Bildanzeige auch die Seite als Bild mit allen Angaben, auch zu Dritten und mit vollständigen IBANs; mit search sucht sie auch nach Bedeutung, dafür geht der Suchtext an einen KI-Dienst in der EU, der ihn nicht speichert. Mit Schreibzugriff ab Version 2026-10-05 sieht sie Rechnungen, Angebote und Entwürfe außerdem so, wie bimetrics sie druckt: als Text mit allen Positionen und Summen, in Anwendungen mit Bildanzeige auch als vollständiges Bild mit Käuferanschrift, Steuernummer oder USt-IdNr. und Bankverbindung deines Unternehmens mit voller IBAN. Die Entwurfsprüfung gilt bis Version 2026-10-05 nur für offene Entwürfe, die dieser MCP-Client für dieselbe Person angelegt hat, ab Version 2026-10-09 für jeden offenen Rechnungs- oder Angebotsentwurf des Unternehmens; der Freigabestatus gilt nur für Körbe derselben Verbindung.

Ab Version 2026-10-10 kann die Anwendung Rechnungen, Angebote und Auftragsbestätigungen auch ohne Schreibzugriff vollständig als Druckvorschau und PDF lesen: einschließlich Käuferanschrift, Steuerkennungen und vollständiger Bankverbindung. download_sales_document liefert ausgestellte PDFs unverändert; Entwürfe bleiben als Entwurf gekennzeichnet. Größere PDFs werden vollständig in begrenzten Teilen übertragen und anhand ihrer Prüfsumme zusammengesetzt.

Ab Version 2026-10-11 liest sie außerdem Forderungen mit Zahlungen und Korrekturen, Mahnungen einschließlich ihrer PDFs mit allen gedruckten Angaben, Guthaben aus Rechnungskorrekturen mit ihrem Zahlungsverlauf und Serienvorlagen mit Rechnungsinhalt. Ab Version 2026-10-16 liefert get_document bis zu 100 Positionen, die Gegenpartei mit Kundennummer und Konto sowie die Zahlungsbedingungen. Ab Version 2026-11-04 liest sie Firmendaten, Rechnungslayouts, das Logo, die Anzahlen unter „Zu erledigen“ und ausgestellte E-Rechnungen als XML-Datei. Die vorbereitete E-Mail zu einem ausgestellten Dokument zeigt Empfänger, Betreff und Text ungekürzt, auch Bankdaten. Vorschaubilder von Rechnungslayouts mit der Bankverbindung deines Unternehmens gibt es nur mit Schreibzugriff. Ab Version 2026-11-05 liest sie das Belegpostfach, auch ohne Schreibzugriff: Absender, Empfänger, Betreff, den Text als gekürzten reinen Text, Links nur als Host, IBANs gekürzt, und Seiten von Anhängen als Bild, die alles ungekürzt zeigen. Dazu Dauerbuchungen, Belegvorlagen mit Zeilen, Duplikat-Einträge und eingelesene Kontoauszüge.

Nicht enthalten sind ursprüngliche Belegdateien (ab Version 2026-10-09 ihre Seiten als Bild), bis Version 2026-11-01 XML-Dateien von Rechnungen, Roh-Texte der Belegerkennung, bis Version 2026-11-04 E-Mails im Belegpostfach (ab Version 2026-11-05 als gekürzter reiner Text, ohne Originaldatei und HTML), Kontakt-Notizen, Verträge, Bankzugänge und vollständige IBANs außerhalb der Rechnungs- und Belegbilder, PDF- und XML-Dateien und vorbereiteten E-Mails, ab Version 2026-11-05 auch außerhalb der Angabe zu einem neu anzulegenden eigenen Konto beim Einlesen eines Kontoauszugs. Kontaktansichten enthalten gespeicherte Kommunikationsdaten wie E-Mail-Adresse und Telefon, ab Version 2026-10-05 auch Kundentyp, gekürzte IBAN und BIC. Die kompakten Ausgangsdokumentansichten enthalten keine Käuferadressen oder Käufer-Steuerkennungen; Druckvorschau und ab Version 2026-10-10 PDF zeigen das Dokument vollständig. Einzelheiten stehen unter Tools und Vorlagen.

Laufzeiten

Gültig
Freigabeanfrage im Browserzehn Minuten
Access-Tokenhöchstens 60 Minuten, bei automatischer Einrichtung höchstens 15 Minuten
Verbindung einschließlich aller Refresh-Tokenshöchstens 30 Tage, danach verbindest du neu

Refresh-Tokens werden bei jeder Verwendung ausgetauscht. Unabhängig von der Laufzeit prüft jeder Aufruf Token, Verbindung, Mitgliedschaft, Inhaberrolle bzw. MCP-Recht und Tarif neu. Endet die Verbindung, gilt das sofort für alle weiteren Aufrufe.

Wann eine Verbindung endet

  • nach 30 Tagen
  • mit Widerrufen unter Einstellungen › KI-Assistenten: durch einen Inhaber oder, bei eigenen Verbindungen, durch das Teammitglied selbst
  • wenn die Anwendung ihr Token widerruft (OAuth-Widerruf nach RFC 7009)
  • wenn dieselbe Person dieselbe Anwendung für dasselbe Unternehmen neu verbindet: Die neue Verbindung ersetzt die alte
  • nach einer Passwortänderung
  • wenn die Mitgliedschaft der Person endet oder deaktiviert wird, wenn ein Inhaber ihr das MCP-Recht entzieht oder wenn sie die Inhaberrolle verliert und kein MCP-Recht hat. Setzt ein Inhaber ihr Recht auf MCP: nur lesen, verliert die Verbindung den Schreibzugriff.
  • automatisch, wenn ein schon verbrauchter Code oder ein altes Refresh-Token erneut vorgelegt wird (Schutz vor gestohlenen Tokens)
  • durch bimetrics, etwa bei Missbrauch

Den Grund zeigt die Verbindungsliste unter Einstellungen › KI-Assistenten. Nach dem Ende des Tarifs oder der Testphase bleibt eine Verbindung bestehen, Aufrufe für dieses Unternehmen werden aber abgelehnt: mit 403, bei einer Verbindung mit mehreren Unternehmen mit einem Tool-Fehler für dieses Unternehmen, die übrigen bleiben nutzbar. Inhaber können alle Verbindungen des Unternehmens auch dann ansehen und widerrufen.

Auf dieser Seite