# Verbinden (https://developer.bimetrics.de/mcp/connect) Einen KI-Assistenten mit dem MCP-Server von bimetrics verbinden, in Claude oder einer anderen MCP-Anwendung. ## So läuft eine Verbindung 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 Unternehmen und bestätigst mit **Verbindung erlauben**. 4. Der Assistent kann ab jetzt die Daten dieses Unternehmens lesen. Die Serveradresse, die Anleitung für deinen Assistenten und, falls nötig, die Client-ID findest du in der App unter **Einstellungen › MCP** ([app.bimetrics.de/settings/mcp](https://app.bimetrics.de/settings/mcp)). Die Seite sehen nur Inhaber. ## Zwei Wege der Anmeldung Deine Anwendung meldet sich bei bimetrics mit einer Client-ID an. Dafür gibt es zwei Wege: | Weg | Client-ID | Was du tust | | ------------------------ | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | | Automatische Einrichtung | Die Anwendung verwendet die HTTPS-Adresse ihres Metadatendokuments (Client ID Metadata Document). | nur die Serveradresse eintragen | | Hinterlegte Client-ID | Die Anwendung ist bei bimetrics fest registriert. | zusätzlich die Client-ID aus **Einstellungen › MCP** eintragen, ohne Client-Secret | Welcher Weg für welche Anwendung freigegeben ist, zeigt **Einstellungen › MCP**. Eine Registrierung zur Laufzeit (Dynamic Client Registration) bietet bimetrics nicht an. ## In Claude verbinden In Claude im Browser oder in der Desktop-App: 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 Unternehmen und erlaube die Verbindung. 4. Frag im Chat zum Beispiel „Welches Unternehmen ist verbunden?“. Claude nennt Firma, Kontenrahmen und Buchhaltungswährung. Kommt die Verbindung 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](https://bimetrics.de/ratgeber/claude-mit-bimetrics-verbinden). Claude Code nutzt die hinterlegte Client-ID nicht. Bist du in Claude Code mit deinem Claude-Abo angemeldet, steht dir der in Claude verbundene Connector auch dort zur Verfügung. ## ChatGPT und Cursor (in Vorbereitung) Die Verbindung mit ChatGPT und Cursor ist in Vorbereitung. Sobald sie getestet ist, steht hier die Anleitung. Welche Anwendungen heute freigegeben sind, zeigt **Einstellungen › MCP**. ## Andere MCP-Anwendungen 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`, für längere Sitzungen zusätzlich `offline_access` * 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 Anwendung 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](mailto: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 klappt | Meldung oder Verhalten | Ursache und Lösung | | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | „Für diese Verbindung ist kein Unternehmen verfügbar“ | Du brauchst die Rolle Inhaber und einen bezahlten Tarif oder eine Freischaltung. | | „Diese Verbindungsanfrage ist ungültig oder abgelaufen“ | Eine Anfrage gilt zehn Minuten. Starte die Verbindung in deiner Anwendung neu. | | Die Freigabe lässt sich nicht bestätigen | Öffne die Freigabe in einem eigenen Browser-Tab, nicht in einer eingebetteten Ansicht. | | Die Freigabeseite meldet veraltete Texte (`409`) | Lade die Seite neu und bestätige erneut. | | Die Anwendung erhält `403` | Die Verbindung besteht, aber Inhaberrolle, Mitgliedschaft oder Tarif fehlen inzwischen. Eine neue Anmeldung hilft dann nicht. | | Die Anwendung erhält `401` mit `error="invalid_token"` | Die Verbindung ist abgelaufen oder wurde widerrufen. Verbinde neu. | | „Rate limit reached; retry after 60 seconds“ | Ein Minutenbudget ist ausgeschöpft, siehe [Limits](/mcp/tools#limits). | Weitere Fehlertexte stehen unter [Tools und Vorlagen](/mcp/tools#fehler).