# Tool-Übersicht – Lesen und Schreiben (https://developer.bimetrics.de/mcp/tools/dev-write-s2-s5-2026-09-29)

Ergänzung der Lesetools und einmalige Freigabe für MCP-Schreibzugriff.

Diese Übersicht gehört zur zusätzlichen Schreibfreigabe **dev-write-s2-s5-2026-09-29**. Der Stand ist vorbereitet; Schreibzugriff wird erst nach Review für Client und Firma aktiviert. Die [ursprüngliche Übersicht 2026-09-28](/mcp/tools/2026-09-28) bleibt erhalten.

## Ergänzte Lesetools

Die folgenden Tools ergänzen die 14 Lesetools der Fassung 2026-09-28 mit `mcp:read`. Sie gehören zu dieser Fassung; Verbindungen der Fassung 2026-09-28 lesen sie nicht.

| Tool                                           | Inhalt                                                                                  |
| ---------------------------------------------- | --------------------------------------------------------------------------------------- |
| `search_contacts`, `get_contact`               | Gespeicherte Geschäftskontakte, ohne Bankdaten und Notizen.                             |
| `search_sales_documents`, `get_sales_document` | Rechnungen und Entwürfe; einzelne Positionen sind auf 50 und die Antwortgröße begrenzt. |
| `check_sales_draft`                            | Steuerfall eines eigenen offenen MCP-Entwurfs prüfen.                                   |
| `get_approval_status`                          | Stand eines Freigabekorbs dieser Verbindung lesen.                                      |

## 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.

| 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 ein Inhaber unter **Freigaben**. Festgeschriebene Buchungen – auch über Zuordnungen – bleiben geschützt. Nicht ausgewählte Einträge einer Teilfreigabe werden verworfen.

Die [Berechtigungsseite](/mcp/permissions) erklärt Verbindung, Laufzeiten und Widerruf. [Schreibzugriff](/mcp/write-access) beschreibt die Vorschau und ihre Grenzen.
