API Tokens
Create and manage personal access tokens for API and MCP access to your organization's resources.
Personal Access Tokens
Personal access tokens allow you to authenticate with the MR Labs API and MCP server without using your password. Tokens are scoped to your organization and inherit your permissions.
Use tokens to:
- Authenticate API requests to read and manage forms, quizzes, and games.
- Connect an MCP client (e.g. Claude Desktop, Cursor) to the MR Labs MCP server.
- Automate workflows via scripts or CI/CD pipelines.
Creating a Token
To create a new token:
Navigate to Settings > API Tokens and click Create token.
Enter a descriptive name for the token (e.g. ci-deploy or claude-mcp).
Click Generate. The full token string is shown once. Copy it immediately and store it securely.
Copy your token now
The full token is only displayed at creation time. After navigating away, you will only be able to see the token prefix. There is no way to recover a lost token.
Viewing Tokens
Existing tokens are listed in a table showing the following information:
- Name: The label you assigned when creating the token.
- Prefix: The first few characters of the token (e.g.
mrl_abc12...). Used to identify which token is in use. - Created: The date and time the token was generated.
- Last used: The most recent timestamp the token was used for authentication. Shows
Neverif unused.
Revoking a Token
To revoke a token, click Revoke next to the token in the list. Revocation is immediate and irreversible. Any application or script using that token will lose access instantly.
You should revoke a token if:
- The token has been compromised or leaked.
- The service or script using the token is being decommissioned.
- A team member who had access to the token has left.
Security Warning
Treat tokens like passwords
- Never commit tokens to version control or embed them in client-side code.
- Store tokens in environment variables or a secrets manager.
- Use a separate token for each integration so you can revoke individually.
- Rotate tokens periodically as a precaution.
MCP Integration
To connect an MCP client to MR Labs, add the token to your client configuration. The token is passed as a Bearer header in the authorization header.
mcp_client_config.json
{
"mrlabs": {
"url": "https://api.mrlabs.dev/mcp",
"headers": {
"Authorization": "Bearer mrl_your_token_here"
}
}
}For a full walkthrough of connecting MCP clients, see the MCP Integration Guide.