Skip to Content
bpms.ai
ReferenceMcp

Create an MCP access token

POST
/api/v1/mcp/access-tokens

Opens an MCP access token for the caller, with the caller's tenant and permissions. It never expires and counts against no session limit: it stops authenticating only when it is revoked or when the caller or the tenant is no longer active. A user keeps at most bpms.auth.session.max-access-tokens-per-user open MCP access tokens, 10 by default. The token authenticates only at /mcp, and a REST session does not authenticate there.

Authorization

bearer
headerAuthorizationBearer <token>

The token of a session that createSession opened

Response Body

The new MCP access token; it is not cached

application/json
  1. response

A token an agent sends as a bearer token to the MCP server at /mcp

id*integer

Id of the MCP access token, to revoke it

Formatint64
token*string

The bearer token; shown once

Example Request
curl -X POST 'https://bpms.bpms.work/api/v1/mcp/access-tokens'
Example Response
{  "id": 0,  "token": "string"}