Verbinden

So läuft eine VerbindungLink zu diesem Abschnitt kopieren

1. Du trägst in deinem KI-Assistenten die Serveradresse https://app.bimetrics.de/mcp als MCP-Verbindung ein.
2. Der Assistent öffnet bimetrics im Browser. Du loggst dich wie gewohnt ein.
3. Du wählst ein oder mehrere Unternehmen und bestätigst mit Verbindung erlauben.
4. Der Assistent kann ab jetzt die Daten dieser Unternehmen lesen, je Aufruf eines. Mit Schreibzugriff ändert er außerdem Daten wie in der App, ab MCP-Version 2026-10-05 einschließlich Festschreiben nach der Vorschau, ab Version 2026-10-09 auch Belege hochladen. Der Schalter Ändern wie in der App ist dafür an, wo Ändern möglich ist; ausgeschaltet bleibt die Verbindung lesend.

Die Serveradresse und die Anleitung für deinen Assistenten findest du in der App unter Einstellungen › KI-Assistenten (app.bimetrics.de/settings/mcp). Inhaber sehen dort alle Verbindungen des Unternehmens, Teammitglieder ihre eigenen.

Wo bimetrics bereitstehtLink zu diesem Abschnitt kopieren

Alle Wege führen zum selben MCP-Server. Welche Buchhaltungsfunktionen und Rechte eine Verbindung hat, hängt nicht von der Anwendung ab, sondern von der MCP-Version und deiner Freigabe. Die zusätzliche Rechnungsansicht ist für ChatGPT und andere Apps über die OpenAI-Connector-Plattform (https://chatgpt.com/oauth/client.json) verfügbar (Gemeinsame Buchhaltungsfunktionen und Rechnungsansicht).

Zwei Wege der AnmeldungLink zu diesem Abschnitt kopieren

Deine Anwendung meldet sich bei bimetrics mit einer Client-ID an. Dafür gibt es zwei Wege:

Welcher Weg für deine Anwendung gilt und welche Client-ID sie gegebenenfalls braucht, steht in ihrem Abschnitt unten. Eine Registrierung zur Laufzeit (Dynamic Client Registration) bietet bimetrics nicht an.

In Claude verbindenLink zu diesem Abschnitt kopieren

bimetrics steht im Verzeichnis der Konnektoren von Claude. Direkt zum Eintrag führt claude.ai/directory/bimetrics, dort geht es mit Schritt 3 weiter. In Claude im Browser oder in der Desktop-App:

1. Öffne Einstellungen › Konnektoren und dort das Verzeichnis der Konnektoren (englische Oberfläche: Settings › Connectors › Browse connectors).
2. Suche nach bimetrics und wähle den Eintrag.
3. Klicke auf Verbinden (Connect), logge dich bei bimetrics ein, wähle ein oder mehrere Unternehmen und erlaube die Verbindung.
4. Frag im Chat zum Beispiel „Welches Unternehmen ist verbunden?“. Claude nennt Firma, Kontenrahmen und Buchhaltungswährung.

Statt über das Verzeichnis kannst du bimetrics auch als eigenen Konnektor anlegen:

1. Öffne Einstellungen › Konnektoren und wähle Konnektor hinzufügen (englische Oberfläche: Settings › Connectors › Add custom connector).
2. Trage einen Namen ein, etwa bimetrics, und als URL die Serveradresse https://app.bimetrics.de/mcp. Eine Client-ID brauchst du nicht: Claude meldet sich über sein Client ID Metadata Document an.
3. Klicke auf Verbinden (Connect), logge dich bei bimetrics ein, wähle ein oder mehrere Unternehmen und erlaube die Verbindung.

Kommt die Verbindung über den eigenen Konnektor nicht zustande, öffne beim Konnektor Erweiterte Einstellungen (Advanced settings), trage die Client-ID bimetrics-claude ein und lass das Client-Secret leer.

Eine bebilderte Anleitung mit ersten Fragen steht im Ratgeber Claude mit bimetrics verbinden.

Damit Claude Belege hochladen kann, erlaube unter claude.ai/settings/capabilities einmalig die Domain files.bimetrics.de für die Code-Ausführung; in Team- und Enterprise-Plänen übernimmt das ein Admin. Ohne diese Freigabe gibt Claude dir einen Link, über den du die Datei in bimetrics selbst auswählst (Belege per Claude hochladen).

Claude Code nutzt die hinterlegte Client-ID nicht. Bist du in Claude Code mit deinem Claude-Abo angemeldet, steht dir der in Claude verbundene Konnektor auch dort zur Verfügung.

In ChatGPT verbindenLink zu diesem Abschnitt kopieren

bimetrics steht als Plugin im ChatGPT-Verzeichnis: Öffne chatgpt.com/plugins/bimetrics, klicke auf Install plugin, logge dich bei bimetrics ein, wähle ein oder mehrere Unternehmen und erlaube die Verbindung.

Ohne Verzeichnis legst du bimetrics in ChatGPT als eigene App mit der MCP-Server-URL https://app.bimetrics.de/mcp und Anmeldung per OAuth an. Client-ID und Secret lässt du leer: ChatGPT meldet sich über sein Client ID Metadata Document an. Damit ChatGPT in bimetrics etwas ändern darf, braucht es den Entwicklermodus (Developer Mode). Das ist eine Einstellung in ChatGPT und hängt von deinem ChatGPT-Tarif ab. Wo du ihn einschaltest und die App anlegst, beschreibt die Anleitung von OpenAI.

Nach Verbinden loggst du dich bei bimetrics ein, wählst ein oder mehrere Unternehmen und erlaubst die Verbindung.

Der Eintrag im ChatGPT-Verzeichnis wurde mit dem Stand der MCP-Version 2026-10-09 eingereicht; welche neueren Werkzeuge er zeigt, hängt von der Prüfung durch OpenAI ab.

Belege gehen über einen Upload-Link auf files.bimetrics.de direkt nach bimetrics, wenn ChatGPT diesen Host erreicht. Sonst erhältst du einen Link, über den du die Datei in bimetrics selbst auswählst.

In Codex verbindenLink zu diesem Abschnitt kopieren

Codex läuft auf deinem Rechner. Trage den Server im Terminal ein und melde dich an:

codex mcp add bimetrics --url https://app.bimetrics.de/mcp
codex mcp login bimetrics --scopes mcp:read,mcp:write,offline_access

Logge dich im Browser bei bimetrics ein, wähle ein oder mehrere Unternehmen und erlaube die Verbindung. Eine Client-ID brauchst du nicht. Ohne mcp:write bleibt die Verbindung lesend.

Codex lädt Belege über den Upload-Link auf files.bimetrics.de hoch, wenn es Netzzugriff hat. Sonst erhältst du einen Link, über den du die Datei in bimetrics selbst auswählst.

In Cursor verbindenLink zu diesem Abschnitt kopieren

Cursor meldet sich mit der hinterlegten Client-ID bimetrics-cursor an, ohne Client-Secret. So richtest du die Verbindung ein:

1. Öffne die Cursor-Konfiguration mcp.json: ~/.cursor/mcp.json gilt für alle Projekte, .cursor/mcp.json im Projektordner nur für dieses Projekt.

2. Lege unter mcpServers den Eintrag bimetrics an und trage die Serveradresse ohne Schrägstrich am Ende ein. Vorhandene Einträge anderer Server bleiben, wie sie sind.

   Text kopieren

   {
     "mcpServers": {
       "bimetrics": {
         "url": "https://app.bimetrics.de/mcp",
         "auth": {
           "CLIENT_ID": "bimetrics-cursor",
           "scopes": ["mcp:read", "mcp:write", "offline_access"]
         }
       }
     }
   }

3. Starte in den Einstellungen von Cursor unter Tools & MCP beim Eintrag bimetrics die Anmeldung. bimetrics öffnet sich im Browser.

4. Logge dich bei bimetrics ein, wähle ein oder mehrere Unternehmen und erlaube die Verbindung.

Das Plugin-Paket bimetrics1337/cursor-plugin enthält genau diese mcp.json.

Cursor lädt Belege über den Upload-Link auf files.bimetrics.de hoch, wenn es Netzzugriff hat. Sperrt die Sandbox von Cursor den Zugriff, erlaube files.bimetrics.de in der Sandbox-Konfiguration oder gib den Befehl frei. Sonst erhältst du einen Link, über den du die Datei in bimetrics selbst auswählst.

Andere MCP-AnwendungenLink zu diesem Abschnitt kopieren

Eine Anwendung kann sich verbinden, wenn sie Folgendes unterstützt:

• Streamable HTTP an https://app.bimetrics.de/mcp
• OAuth Authorization Code mit PKCE S256 als öffentlicher Client (token_endpoint_auth_method: none)
• den Parameter resource mit genau der Serveradresse, bei Autorisierung und Tokenaustausch
• die Berechtigung mcp:read; unterstützt die Anwendung Refresh-Tokens (Grant-Typ refresh_token), erhält sie bei der Freigabe offline_access dazu, auch ohne es anzufragen
• eine Client-ID über einen der beiden Wege oben

Die Anwendung findet den Autorisierungsserver selbst: Ein Aufruf ohne Token erhält 401 mit dem Header WWW-Authenticate, der auf https://app.bimetrics.de/.well-known/oauth-protected-resource/mcp verweist. Ob eine bestimmte Anwendung diese Anforderungen erfüllt, hängt von der Anwendung ab.

Zulassung einer AnwendungLink zu diesem Abschnitt kopieren

bimetrics lässt eine Anwendung zu, wenn sie diese technischen Kriterien erfüllt:

1. Öffentlicher OAuth-Client mit Authorization Code und PKCE S256, token_endpoint_auth_method: none, ohne Client-Secret.
2. Entweder ein Client ID Metadata Document auf einem stabilen HTTPS-Host des Anbieters oder eine bei bimetrics hinterlegte Kennung mit festen, exakt registrierten Rückleitungsadressen.
3. resource exakt die MCP-Adresse bei Autorisierung und Tokenaustausch; keine Dynamic Client Registration.
4. Ein bestandener Verbindungstest: verbinden, ein Werkzeug aufrufen, Token erneuern, widerrufen.
5. Zulassung auf Antrag an support@bimetrics.de. Jede Anwendung, die 1 bis 4 erfüllt, wird geprüft. Die Zulassung ist keine Empfehlung und keine Prüfung des Datenschutzniveaus.

Wenn es nicht klapptLink zu diesem Abschnitt kopieren

Weitere Fehlertexte stehen unter Tools und Vorlagen.