How do I create an API token for MCP access?
What this is about
You create an API token that you use in Claude Code, Cursor, or your own AI agent to access Picasi data. Tokens are the most secure method for tool-to-tool connections without a browser login.
How to proceed
-
Open AI Connections
In the navigation, click Workspace settings → AI connections.
-
Find the form
Under Workspace access tokens, the form for a new token sits directly on the page.
-
Assign a name and level
- Access token name: Describes the intended use, e.g.,
Claude Code – max.mustermann@example.com. A good name helps you identify and revoke tokens later. - Permission level: Determines what the tool is allowed to do with the token. Only levels up to your own role are offered.
- Reader — Read-only access
- Member — Full access to sources and channels
- Admin — Full access including Workspace settings
- Access token name: Describes the intended use, e.g.,
-
Copy token
Click Create access token. The token is displayed only once, in the API access token created window.
Copy it immediately and store it securely — for example, in a password manager. After that, it will no longer be visible in Picasi.
Result
The token appears under Active access tokens with its name and level. A Workspace can have up to ten tokens at the same time. You can now use it in your MCP client.
Revoke token
If a token is no longer needed or has been compromised, click the trash icon next to the corresponding token in the token list and confirm with Revoke. It becomes invalid immediately—all tools using it will lose access.