Configure Langdock to use the Staffbase MCP Server with OAuth, so it can securely access Staffbase content and run Staffbase MCP Server tools on behalf of the signed-in user.
This guide describes one possible setup based on Staffbase testing. Steps can vary depending on your Langdock configuration, environment, and access permissions. Staffbase maintains the Staffbase platform and MCP Server, while Langdock maintains Langdock and related components.
Prerequisites
- You are an administrator in your Staffbase platform.
- You have OAuth clients activated for your platform. Contact Staffbase Support or your Customer Success Manager for more information.
- You can create integrations in Langdock. If you are not sure, ask your Langdock administrator.
- You know your Staffbase platform domain, for example
https://mycompany.com.
Step 1: Identify the MCP endpoint
The Staffbase MCP Server is served from the same domain as your Staffbase platform. If your platform domain URL is https://mycompany.com, your MCP server endpoint is https://mycompany.com/mcp.
Step 2: Start the integration in Langdock and collect the redirect URI
In Langdock, add a remote MCP integration with your MCP endpoint. Select OAuth 2.0 Manual with Authorization Code + PKCE. Copy the OAuth redirect URI shown by Langdock. You need it when you create the Staffbase OAuth client.
Step 3: Create an OAuth client for Langdock in Staffbase
Create an OAuth Client with the following configuration:
| Setting | Value |
|---|---|
| OAuth Client Type | SPA |
| Client name | MCP Note: The Client Name must be exactly MCP. The MCP Server resolves its OAuth configuration by this name, and authorization fails if the name differs. |
| Redirect URIs | The Langdock redirect URI from Step 1. |
| Scopes | Enter a single whitespace character. The MCP Server does not require specific OAuth scopes. |
| Allowed CORS origins | https://app.langdock.com (verify with your Langdock environment). |
After saving, copy the Client ID, Authorization URL, and Token URL.
Step 4: Complete OAuth configuration in Langdock
In Langdock, complete the MCP OAuth configuration with values from Staffbase:
- Client ID: from the Staffbase OAuth client
- Authorization URL: from the Staffbase OAuth client
- Token URL: from the Staffbase OAuth client
- OAuth mode: OAuth 2.0 Manual
- OAuth flow: Authorization Code + PKCE
- Client Secret: Leave blank.
- Send resource parameter: Enabled
Save the integration.
Step 5: Authorize, test, and select tools
- In Langdock, start the connection.
- In the window that opens, sign in with your Staffbase account and give consent.
- Langdock confirms the connection.
- Select Test connection to list the available tools. Enable the actions your agents can use, and save the configuration.
Available actions in Langdock
You can configure Staffbase MCP Server tools which are actions available to Langdock agents.
- Enable action controls whether the action is exposed to Langdock agents.
- Ask for confirmation requires explicit user confirmation before the action runs.