Manage API Keys & MCP Connections

API keys let you connect external tools and AI assistants directly to your Univents workspace. The keys are used for MCP connections and external integrations, allowing programs like Claude Desktop or Cursor to access your events, documents, and production status on your behalf.

Where to find API keys

Click Integrations in the left main menu and select the API Keys tab. The page displays all existing keys along with the button to create new ones.

Creating a new API key

1. Click Create new key in the top right.
2. The Create new API key dialog opens. Enter a descriptive name in the Name field, for example Claude Desktop or n8n Workflow.
3. Under Permissions, the scope mcp:read — Read access to events, documents, and production status is already set. It cannot be changed and covers all common MCP use cases.
4. Click Create.
5. The dialog switches to the API key created view. The full key is displayed once. Copy it now using the copy icon next to it.
6. Click Done to close the dialog.

The key then appears in the list with an Active badge and a prefix (e.g. uk_live_abc...).

Setting up the key in an MCP client

The generated key is stored in the respective tool as a bearer token or API key. The exact steps vary by application:

• Claude Desktop: Open Settings, navigate to "MCP Servers", and add the Univents server with the key as the apiKey parameter.
• Cursor: Enter the key in the MCP configuration area under "Tools & Integrations".
• n8n / Make: Use the key in an HTTP node as an Authorization header in the format Bearer <key>.

Once the connection is established, the key list will show Last used: with the date of the most recent request for that entry.

Revoking or deleting a key

Both actions are available directly on each entry in the key list:

• Revoke: Disables the key immediately. It remains visible in the list but receives a Revoked badge and can no longer be used for requests. Useful when you want to block a compromised key but still keep the name for tracking purposes.
• Delete (trash icon): Removes the key entry completely from the list.

A revoked or deleted key stops working immediately. Connected MCP clients must be reconfigured with a new key.

Frequently asked questions

Can I view a key again after closing the dialog? No. The full key value is shown only once at creation time for security reasons. Afterwards only the prefix is visible in the list. If you have lost the key, simply create a new one and revoke the old one.

How many keys can I create? There is no fixed limit. Recommendation: one key per connected tool, so you can revoke individual connections as needed without disrupting others.

What does the mcp:read scope mean? The key grants read-only access. External tools can query data but cannot create, modify, or delete any entries in your workspace.

When should I revoke a key instead of deleting it? Revoke is the better choice when you want to quickly interrupt an active connection while keeping the entry as a reference. Delete makes sense when the key is no longer needed and you want to keep the list tidy.