CrewBrain bietet seinen Kunden die Möglichkeit, über einen MCP-Server mithilfe von LLMs mit CrewBrain zu interagieren, um z. B. Jobs anzulegen. Es gibt zwei unterschiedliche Wege, um den Nutzer dabei zu authentifizieren.
- OAuth mit DCR (Dynamic Client Registration).
- Token Auth per CrewBrain Benutzername und Token.
- Basic Auth per CrewBrain Benutzername und Passwort. Diesen Weg empfehlen wir ausdrücklich nicht, da er unsicherer ist.
Der CrewBrain-MCP-Server unterstützt ein ähnliches Feature-Set wie die CrewBrain-API v2 und wird laufend aktualisiert. Welche Tools verfügbar sind und wie sie aussehen, kannst du hier nachschauen: https://mcpo.in.crewbrain.com/mcp-tools.
Ein Hinweis an dieser Stelle: Bis Februar 2026 unterstützte der MCP-Server von CrewBrain ausschließlich SSE (Server-Sent-Events). Mittlerweile wird auch Streamable HTTP unterstützt (2025-03-26).
Du kannst Software nutzen, die MCP-Server unterstützt. Dazu gehören zum Beispiel OpenAI ChatGPT, und andere auf dieser Liste aufgeführte Clients: https://modelcontextprotocol.io/clients
Voraussetzung ist, dass du einen ChatGPT Pro, Plus, Business, Enterprise oder Education Account besitzt. MCP-Konnektoren können derzeit nur in ChatGPT im Browser genutzt werden.
- Klicke links unten auf deinen Namen.
- Klicke auf "Einstellungen".
- Klicke auf "Apps und Konnektoren".
- Klicke auf "Erweiterte Einstellungen".
- Schalte den Entwicklermodus an. ChatGPT-Erinnerungen werden hiermit ausgeschaltet.
- Klicke zurück und oben rechts auf "Erstellen".
- Trage als Namen "CrewBrain" ein.
- Trage als "URL des MCP-Servers"
https://mcpo.in.crewbrain.com/DEINESUBDOMAIN/mcp ein1
- Als Authentifizierung wählst du "OAuth".
- Bestätige zuletzt, dass du die Risiken verstehst und akzeptierst.
- Klicke auf "Erstellen".
- Du wirst nun zur Login-Seite deines CrewBrain-Systems weitergeleitet.
- Melde dich an und Genehmige "ChatGPT" den Zugriff auf dein System.
- Sobald du zurück zu ChatGPT geleitet wirst, ist der Konnektor einsatzbereit.
- Du kannst nun die Einstellung verlassen. Um Aufrufe zu CrewBrain zu machen, klicke in der Chat-Leiste von ChatGPT auf das Plus-Icon, auf "Mehr" und wähle den von dir erstellten Konnektor an.
1Deine Subdomain ist das, was vor .crewbrain.com steht. Zum Beispiel firma.crewbrain.com. Bist du dir nicht sicher, was deine Subdomain ist? Dann öffne CrewBrain im Browser und schau in die Adresszeile deines Browsers. Für Kunden, die auf unserem eu2 oder eu3-Server sind, endet die Subdomain häufig mit eu2 oder eu3, z. B. firma.eu3.crewbrain.com. In diesem Fall wäre die vollständige URL also https://mcpo.in.crewbrain.com/firma.eu3/mcp.
¶ Andere Clients mit Unterstützung von OAuth und DCR
Die Schritte gleichen im Grunde denen von OpenAI ChatGPT.
- Um den MCP-Server hinzuzufügen, öffne bitte links den Bereich “Integrationen” (dies wird in der Regel ein Workspace-Admin machen müssen - kontaktiere deinen Admin entsprechend, solltest du nicht die Berechtigungen besitzen).
- Klicke oben rechts auf “Integration hinzufügen” und wähle “Neu erstellen”.
- Wähle “MCP Server verbinden”.
- Als Server URL trägst du
https://mcpo.in.crewbrain.com/DEINESUBDOMAIN/mcp ein1
- Wähle als Authentifizierungsmethode “OAuth 2.0 (manuelle Konfiguration)”.
- Klicke “Erstellen”.
- Langdock zeigt dir jetzt den vollständigen Konfigurationsscreen an sowie den Transportmechanismus (Streamable HTTP). Oben hast du die Möglichkeit, der Integration einen Namen zu geben, zum Beispiel “CrewBrain”.
- Kopiere die von Langdock vorgegebene OAuth Redirect URL.
- Öffne nun CrewBrain und gehe in die Verwaltung → Schnittstellen → API-Schnittstelle → OAuth.
- Klicke auf “+ OAuth Client erstellen”.
- Wähle unter “Token Endpoint Auth Method” “client_secret_post (requires client_secret)” aus.
- Kopiere die von Langdock vorgegebene Redirect URL in das Feld “Redirect-URIs”.
- Wähle als “Grant Types” “authorization_code” sowie “refresh_token” aus.
- Wähle als Response Types “code” aus.
- Zuletzt erstellst du ein Client-Secret. Dieses wird nur einmal angezeigt! Kopiere es dir in die Zwischenablage.
- Wechsle nun zurück in die Langdock Konfiguration und trage das Client-Secret im Feld “Client Secret” ein.
- Die Client ID erhältst du in der CrewBrain Konfiguration (ganz oberes Feld, ausgegraut).
- In Langdock hinterlegst du noch die Autorisierungs URL “
https://DEINESUBDOMAIN.crewbrain.com/authorize”1
- Als Token URL hinterlegst du “
https://DEINESUBDOMAIN.crewbrain.com/api/oauth”1
- Das Feld Scopes kannst du leer lassen.
- Speichere die Konfiguration.
- Nun hast du die Möglichkeit, unter “Verbindung” “+ Verbindung hinzufügen” zu klicken. Klicke hierauf und du wirst zu deinem CrewBrain weitergeleitet und kannst die Applikation freigeben.
- Klicke nun auf “Verbindung testen” und wenn alles geklappt hast, findest du alle verfügbaren Tools und kannst auswählen, welche du davon benötigst. Langdock unterstützt derzeit maximal 50 Tools gleichzeitig. Was welche Tools können/unterstützen, findest du unter unserer MCP-Tools-Seite (Link oben).
1Deine Subdomain ist das, was vor .crewbrain.com steht. Zum Beispiel firma.crewbrain.com. Bist du dir nicht sicher, was deine Subdomain ist? Dann öffne CrewBrain im Browser und schau in die Adresszeile deines Browsers. Für Kunden, die auf unserem eu2 oder eu3-Server sind, endet die Subdomain häufig mit eu2 oder eu3, z. B. firma.eu3.crewbrain.com. In diesem Fall wäre die vollständige URL also https://mcpo.in.crewbrain.com/firma.eu3/mcp.
¶ Andere Clients ohne Unterstützung von OAuth
Um Legacy-Clients zu unterstützen, bieten wir zwei Optionen an, mit denen du dich authentifizieren kannst.
Erstelle dir einen Access Token per API Call an https://firma.crewbrain.com/api/accesstoken. Hier authentifizierst du dich noch mit Basic Auth (also deinem Benutzernamen und Passwort). Du erhältst als Antwort ein JSON, das in etwa so aussieht:
{"Accesstoken":"b.benutzername:oghRA7Y4dzYfo916eXLGkTlLFGJEtlg1"}
Diesen Accesstoken sendest du im Header xapikey in deinen Anfragen mit.
Die URL des Servers ist weiterhin https://mcpo.in.crewbrain.com/firma.eu3/mcp.
Nutze deine Zugangsdaten zu CrewBrain direkt. Diese setzt du im Header bauth , so: b.benutzername:passwort.
Die URL des Servers ist weiterhin https://mcpo.in.crewbrain.com/firma.eu3/mcp.