# MCP-Server (https://developer.bimetrics.de/mcp)

Mit dem MCP-Server von bimetrics beantwortet ein KI-Assistent Fragen zur Buchhaltung eines Unternehmens, nach Freigabe durch den Inhaber.

Über das Model Context Protocol (MCP) verbindest du einen KI-Assistenten mit bimetrics. Der Assistent findet dann Belege, klärt Bankumsätze, gleicht offene Rechnungen ab und bereitet den Monatsabschluss vor. Beispiele für solche Fragen stehen auf [bimetrics.de/mcp](https://bimetrics.de/mcp).

Der MCP-Server bietet Tools, die Belege, Umsätze, Zuordnungen und Buchungen liefern, dazu fertige Vorlagen für häufige Abläufe.

## MCP oder API?

|           | MCP-Server                                                                                  | API                                                      |
| --------- | ------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| Für       | KI-Assistenten                                                                              | eigene Anwendungen und Integrationen                     |
| Anmeldung | OAuth im Browser, Freigabe durch den Inhaber                                                | API-Schlüssel aus **Einstellungen › API**                |
| Zugriff   | Belege, Umsätze, Zuordnungen und Buchungen abfragen                                         | Daten abrufen und, mit Berechtigung, Belege hochladen    |
| Daten     | aufbereitet für Assistenten: Zuordnungen, Vorschläge, offene Beträge, Kategorien mit Konten | Rohdaten der Endpunkte, siehe [API-Referenz](/reference) |

## Grundlagen

| Thema          | Wert                                                     |
| -------------- | -------------------------------------------------------- |
| Serveradresse  | `https://app.bimetrics.de/mcp`                           |
| Transport      | Streamable HTTP                                          |
| Anmeldung      | OAuth mit PKCE (`S256`), öffentlicher Client ohne Secret |
| Berechtigungen | `mcp:read`, optional `offline_access`                    |
| Umfang         | genau ein Unternehmen je Verbindung, höchstens 30 Tage   |

## Wer den MCP-Server nutzen kann

* Nutzer mit der Rolle **Inhaber** eines Unternehmens mit bezahltem Tarif oder einer Freischaltung durch bimetrics. In der Testphase ist der MCP-Server nicht verfügbar.
* Andere Rollen im Team können keine Verbindung freigeben.
* Der KI-Assistent muss MCP-Verbindungen über HTTP mit Anmeldung per OAuth unterstützen. Freigegeben ist heute Claude, ChatGPT und Cursor sind in Vorbereitung. Einrichtung und Verfügbarkeit hängen von der Anwendung und ihrem Tarif ab.

## Nächste Schritte

<Cards>
<Card title="Verbinden" href="/mcp/connect" description="Einen KI-Assistenten mit bimetrics verbinden." />

<Card title="Berechtigungen und Freigabe" href="/mcp/permissions" description="Was eine Freigabe erlaubt und wie lange sie gilt." />

<Card title="Tools und Vorlagen" href="/mcp/tools" description="Was der Server liefert, dazu Limits und Fehler." />

<Card title="Sicherheit und Widerruf" href="/mcp/security" description="Freigabe prüfen, Verbindungen beenden." />
</Cards>