CrewBrain offers its customers the option of interacting with CrewBrain via an MCP server using LLMs, for example to create jobs. There are several different ways to authenticate the user.
- OAuth with DCR (Dynamic Client Registration).
- Token authentication via CrewBrain username and token.
- Basic authentication via CrewBrain username and password. We strongly advise against this method, as it is less secure.
The CrewBrain MCP server supports a similar feature set to the CrewBrain-API v2 and is continuously updated. You can see which tools are available and what they look like here: https://mcpo.in.crewbrain.com/mcp-tools.
Please note: Until February 2026, the CrewBrain MCP server exclusively supported SSE (Server Sent Events). Streamable HTTP is now also supported (2025-03-26).
You can use software that supports MCP servers. These include OpenAI ChatGPT and other clients listed here: https://modelcontextprotocol.io/clients
The prerequisite is that you have a ChatGPT Pro, Plus, Business, Enterprise, or Education account. MCP connectors can currently only be used in ChatGPT in the browser.
- Click on your name in the bottom left corner.
- Click on “Settings.”
- Click on “Apps & Connectors.”
- Click on “Advanced Settings.”
- Turn on developer mode. This will disable ChatGPT reminders.
- Click back and then on “Create” in the top right corner.
- Enter “CrewBrain” as the name.
- As "MCP Server URL", set
https://mcpo.in.crewbrain.com/YOURSUBDOMAIN/mcp1
- For Authentication, choose "OAuth".
- Confirm that you understand the risks and want to continue.
- Click "Create".
- The CrewBrain login page will open.
- Login and approve "ChatGPT" to access your system.
- As soon as you're back in ChatGPT, the connector is ready.
- You can leave the settings now. To use the CrewBrain connector, click the plus icon in the chat box, click “More” and choose the CrewBrain connector.
1Your subdomain is the part before .crewbrain.com. For example, company.crewbrain.com. Are you not sure, what your subdomain is? Then open CrewBrain in your browser and look into its address bar. For customers that are on our eu2 or eu3 servers, the subdomain often ends in eu2 or eu3, e.g. company.eu3.crewbrain.com. In this case, the full URL would be https://mcpo.in.crewbrain.com/company.eu3/mcp.
¶ Other Clients Supporting OAuth and DCR
The steps are more or less the same as in OpenAI ChatGPT.
- To add the MCP-Server, please open “Integrations” on the left (you will most likely need to have admin permissions for that - if you cannot see it, ask your admin for Langdock).
- Click “Add integration” on the top right, then “Start from scratch”
- Choose “Connect remote MCP”
- Enter
https://mcpo.in.crewbrain.com/YOURSUBDOMAIN/mcp as server url1
- Choose "OAuth 2.0 (manual) as authentication method.
- Click “Create”.
- Langdock will now show you the whole configuration screen. This should show you the transport mechanism (Streamable HTTP). Up top, you have the ability to enter a name for your integration, for example “CrewBrain”.
- Copy the given OAuth Redirect URL.
- Now open CrewBrain and go to Administration → Interfaces → API → OAuth.
- Click on “+ Create OAuth client".
- Choose under “Token Endpoint Auth Method” “client_secret_post (requires client_secret)”.
- Enter the Langdock redirect URL into the “Redirect-URIs” field.
- As “Grant Types”, choose “authorization_code” and “refresh_token”.
- Choose “code” as “Response Types”.
- Now, create a Client-Secret. It will be shown only once, so copy the secret.
- Go back to the Langdock configuration page and enter the client secret into the field “Client Secret”.
- The Client ID you'll get from CrewBrain (the greyed out field up top).
- In Langdock enter as Authorization URL “
https://YOURSUBDOMAIN.crewbrain.com/authorize”1
- As Token URL enter “
https://YOURSUBDOMAIN.crewbrain.com/api/oauth”1
- Leave the field Scopes blank.
- Save the configuration.
- Now you're able to click on “+ Add connection” under the Connection section. Clicking the button will open CrewBrain to get your permission to log in.
- Click on “Test connection” and, if everything worked out fine, you'll see all available tools and you can choose, which of them you'll need. Langdock supports 50 tools at a time. To find out which tools do/support what, see our MCP-Tools page (Link up top).
1Your subdomain is the part before .crewbrain.com. For example, company.crewbrain.com. Are you not sure, what your subdomain is? Then open CrewBrain in your browser and look into its address bar. For customers that are on our eu2 or eu3 servers, the subdomain often ends in eu2 or eu3, e.g. company.eu3.crewbrain.com. In this case, the full URL would be https://mcpo.in.crewbrain.com/company.eu3/mcp.
To support legacy clients, we offer two options for authentication.
Create an access token via API call to https://company.crewbrain.com/api/accesstoken. You'll authenticate using basic auth (i.e., your username and password). You'll get a JSON which looks about this way:
{"Accesstoken":"u.username:oghRA7Y4dzYfo916eXLGkTlLFGJEtlg1"}
You'll send this accesstoken in the header called xapikey for every request.
The URL is the same https://mcpo.in.crewbrain.com/company.eu3/mcp.
Directly use your CrewBrain user account. You'll set the header bauth , with content: u.username:password.
The URL is the same https://mcpo.in.crewbrain.com/company.eu3/mcp.