Choose a server
Add the Unkey server if you’re not sure. If you only use Compute, the Compute server gives your assistant a shorter list of tools to choose from.
Create a root key
The server acts with the permissions of the root key you give it, so create a key just for your assistant.- Under Settings > Root Keys, click New root key and name it after the assistant, for example “Claude Code”.
- Select only the permissions for what you want the assistant to do. See Root key permissions.
- Copy the key and store it as an environment variable, for example
UNKEY_ROOT_KEY.
Connect your client
Every client needs the server URL and one header with your root key:Try it
Ask in plain language. The assistant picks the tools and fills in the IDs.Fix connection problems
- The provided root key is invalid: the key in the header is wrong, deleted, or rotated. See key_not_found.
- Missing permissions: the root key can’t do what the assistant tried. Add the permission to the key or ask for something else. See insufficient_permissions.
- The server doesn’t connect: check that the URL matches the table exactly, with no trailing slash, and that the header is named
Mcp-Unkey-V2-Bearer. Restart your client after you edit its config.