Verbinden
Einen KI-Assistenten mit dem MCP-Server von bimetrics verbinden, in Claude oder einer anderen MCP-Anwendung.
So läuft eine Verbindung
- Du trägst in deinem KI-Assistenten die Serveradresse
https://app.bimetrics.de/mcpals MCP-Verbindung ein. - Der Assistent öffnet bimetrics im Browser. Du loggst dich wie gewohnt ein.
- Du wählst ein Unternehmen und bestätigst mit Verbindung erlauben.
- 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). 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:
- Öffne Einstellungen › Konnektoren und wähle Konnektor hinzufügen (englische Oberfläche: Settings › Connectors › Add custom connector).
- Trage einen Namen ein, etwa
bimetrics, und als URL die Serveradressehttps://app.bimetrics.de/mcp. Eine Client-ID brauchst du nicht: Claude meldet sich über sein Client ID Metadata Document an. - Klicke auf Verbinden (Connect), logge dich bei bimetrics ein, wähle ein Unternehmen und erlaube die Verbindung.
- 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.
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
S256als öffentlicher Client (token_endpoint_auth_method: none) - den Parameter
resourcemit genau der Serveradresse, bei Autorisierung und Tokenaustausch - die Berechtigung
mcp:read, für längere Sitzungen zusätzlichoffline_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:
- Öffentlicher OAuth-Client mit Authorization Code und PKCE
S256,token_endpoint_auth_method: none, ohne Client-Secret. - 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.
resourceexakt die MCP-Adresse bei Autorisierung und Tokenaustausch; keine Dynamic Client Registration.- Ein bestandener Verbindungstest: verbinden, ein Werkzeug aufrufen, Token erneuern, widerrufen.
- 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 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. |
Weitere Fehlertexte stehen unter Tools und Vorlagen.