# Tool-Übersicht, MCP-Version 2026-11-23 (https://developer.bimetrics.de/mcp/tools/2026-11-23)

Fehlende Belege beim Lieferanten anfordern, Bankkonten aktivieren und deaktivieren, Feedback an bimetrics senden sowie vorgemerkte Regelbesteuerung, Verrechnungskonto bei Kassendateien und Ablehnungen mit dem nächsten Schritt.

Diese MCP-Version erweitert die [Werkzeuge der MCP-Version 2026-11-22](/mcp/tools/2026-11-22) bei denselben Berechtigungen um neue Werkzeuge und geänderte Antworten. Es gilt die Anlage „MCP-Verbindungen“ aus dem [Rechtspaket 2026-11-23-v1](https://bimetrics.de/rechtliches/2026-11-23-v1/avv#anlage-mcp-verbindungen). Für die neuen Werkzeuge ist nach Ziffer 2.3 der Anlage eine neue Freigabe nötig: Verbindungen älterer Versionen behalten ihren Umfang, bis du bimetrics in deiner Anwendung neu verbindest.

Die neuen Werkzeuge nutzen dieselben Dienste und Befehle wie App und REST-API, mit denselben Sperren und Rollen. Weiter gilt: Überwiesen wird nichts. Bankzugänge verbindest und trennst du nur in der App, den Tarif wählt nur ein Inhaber in der App.

## Auf der Freigabeseite

Der Schalter **Ändern wie in der App** nennt zusätzlich den Versand von Anfragen nach fehlenden Belegen per E-Mail. Unter **Details** stehen außerdem das Aktivieren und Deaktivieren von Bankkonten und gesendete Anfragen nach fehlenden Belegen. Der Satz zum Lesen nennt, dass die Anwendung auf deinen Wunsch Feedback an bimetrics senden kann.

## Fehlende Belege anfordern

Wie „Beleg anfordern“ in der App: Zu einem Bankumsatz ohne Beleg geht eine Anfrage an die E-Mail-Adresse, die beim Kontakt der Gegenpartei hinterlegt ist. Die Antwort mit dem Beleg landet im Belegpostfach. Die drei Werkzeuge erscheinen, solange bimetrics den Versand eingeschaltet hat.

| Werkzeug | Was es tut |
| --- | --- |
| `preview_receipt_request_mail` | Lesend. Zeigt die Anfrage wie in der App, auf Wunsch mit eigenen Texten: Kontakt, Absender, Belegpostfach als Antwortadresse, Empfänger, Betreff, Text, Signatur, Erinnerung, letzte Anfrage und wie viele Anfragen heute schon gesendet wurden. Nennt mit `blocked`, warum nichts gesendet werden kann, etwa ohne E-Mail-Adresse beim Kontakt. Liefert ein `previewToken`, das 15 Minuten gültig und an Umsatz, Kontakt, Adresse und alle Texte gebunden ist. |
| `send_receipt_request_mail` | Fragt vorher nach. Sendet genau die Anfrage aus der Vorschau, mit `previewToken`, `confirmed` und `idempotencyKey`, auf Wunsch mit einer einmaligen Erinnerung nach 7 oder 14 Tagen (`followUpDays`). Liest die Adresse des Kontakts vor dem Senden neu; hat sie sich geändert, braucht es eine neue Vorschau. Höchstens 10 Anfragen je Firma und Tag, innerhalb der gemeinsamen Tagesgrenze für E-Mail-Empfänger. Die Mail geht an Dritte und lässt sich nicht zurückholen. |
| `cancel_receipt_request_follow_up` | Bricht die geplante Erinnerung ab. Ohne geplante Erinnerung ändert sich nichts. |

Ablehnungen nennen den Grund und den nächsten Schritt: `ReceiptRequestMailNotPossible`, `ReceiptRequestMailContact` und `DocumentMailLimitExceeded` mit beiden Tagesgrenzen.

## Bankkonten

| Werkzeug | Was es tut |
| --- | --- |
| `set_bank_account_enabled` | Aktiviert oder deaktiviert ein Bankkonto wie „Konto aktivieren“ und „Konto deaktivieren“ in der App, nur auf deinen ausdrücklichen Wunsch. Braucht `id` aus `list_bank_accounts`, `enabled` und `idempotencyKey`. Ein aktives Konto belegt einen Platz im Tarif; ist keiner frei, bleibt es aus und die Ablehnung nennt die Grenze. Nach dem Aktivieren startet kein sofortiger Abruf, neue Umsätze holt der nächste Abruf. Ist das Konto deaktiviert, holt bimetrics keine neuen Umsätze mehr. Umsätze, Zuordnungen und Buchungen bleiben. |

Läuft gerade ein Abruf oder eine andere Aktivierung, kommt `BankAccountBusy`: Nichts wurde geändert, in einer Minute noch einmal versuchen.

## Feedback an bimetrics

| Werkzeug | Was es tut |
| --- | --- |
| `send_feedback` | Sendet Feedback zu bimetrics an das bimetrics-Team, nicht an deine Firma: was du vorhattest, was geklappt hat, was nicht und was besser werden soll. Nur wenn du es möchtest, auch mit Leserecht. E-Mail-Adressen, Links und IBANs lehnt es ab. Höchstens 10 Meldungen je Firma in 24 Stunden. Feedback wird ausgewertet, aber nicht beantwortet. |

Der Prompt `feedback_geben` fasst zusammen, was in diesem Gespräch bei der Arbeit mit bimetrics geklappt hat und was nicht, zeigt dir den Entwurf und sendet erst nach deinem Ja.

## Firma

`get_company_context` nennt mit `plannedTaxStatus` eine Regelbesteuerung, die du in der App zum nächsten 1. Januar vorgemerkt hast: Stichtag, Status und ob dann Soll- oder Ist-Versteuerung gilt. Bis zum Stichtag nennen `smallBusiness` und `freeOfVatLiability` den bis dahin geltenden Stand. Vormerken und Zurücknehmen gehen nur in der App.

## Kassensystem und Kassendatei

- `list_cash_imports` nennt je Tagesabschluss die Summen seiner Werte, je Entwurf den Tagesabschluss, den er wiederholt, und je offener Kassendatei ihren Bearbeitungsstand.
- `preview_cash_import` und `apply_cash_import` nennen Geschäftsvorfälle, die bimetrics keiner Zahlart zuordnen kann (`unassigned`).
- `get_cash_book` nennt die Buchungsart `clearing`: Bargeld aus einer Kassendatei landet auf dem Verrechnungskonto, statt den Monatsabschluss aufzuhalten.
- `preview_cash_month_close` und `close_cash_month` nehmen in Monaten mit Kassendateien den Bestand laut Kasse (`registerCount`) statt einer Zählung und nennen die Beträge auf dem Verrechnungskonto als Hinweis, der den Abschluss nicht aufhält.

Die Werkzeuge zur Kassendatei erscheinen weiter erst, wenn bimetrics den Dateiimport einschaltet.

## Ablehnungen mit dem nächsten Schritt

- **Tarifgrenze:** `LimitReached` nennt die Grenze (`gate`, `limit`, `usage`) und weist darauf hin, dass ein Inhaber den Tarif in der App unter Einstellungen › Tarif wählt oder ändert.
- **Ist-Versteuerung:** Bei Ist-Versteuerung bucht bimetrics für eine Zahlung in Fremdwährung zu einer Ausgangsrechnung keine Kursdifferenz. `ExchangeDifferenceCashBasis` lehnt den Vorgang ab und sagt je Fall, wie die Zahlung in Euro zu erfassen ist.
- **Kundennummer in Vorlagen:** `save_document_template`, `preview_recurring_booking` und `apply_recurring_booking` nennen bei einer abgelehnten `counterparty.customerNumber` die geltende Nummer und weisen darauf hin, dass ohne sie auf das Sammelkonto gebucht wird.
- **Neubuchung nach einem Wechsel der Versteuerung:** Läuft sie noch, kommt `TaxStatusRebookRunning`. In ein paar Minuten noch einmal versuchen.

Ältere Versionen behalten ihre Texte.
