Skip to main content

Obtaining a zymtrace MCP Token

MCP tokens allow AI assistants to authenticate with the zymtrace MCP server. If your zymtrace deployment has authentication enabled, you'll need an MCP token to use the MCP integration.

No Authentication?

If your zymtrace deployment doesn't have authentication enabled, you can skip token setup entirely and connect directly to your MCP endpoint.

Prerequisites​

You need one of the following:

  • Admin role
  • User role with service:token:create permission

Steps​

  1. Log in to zymtrace
  2. Navigate to Your profile picture → Account → Service Tokens
  3. Click Create Token
  4. Select MCP as the token type
  5. Provide a description for the token (e.g., "Claude Desktop Integration")
  6. Click Create
  7. Copy the token immediately and store it securely

MCP Token

Token Security

The token is only shown once. If you lose it, you'll need to create a new token.

Once you have your token, return to the Configure MCP guide to configure your AI assistant.

Managing Tokens​

Viewing Tokens​

To view all your service tokens:

  1. Navigate to Your profile picture → Account → Service Tokens
  2. You'll see a list showing:
    • Token name/description
    • Token type (MCP, Agent, etc.)
    • Creation date
    • Expiration date (if applicable)

Revoking Tokens​

To revoke a token:

  1. Navigate to Your profile picture → Account → Service Tokens
  2. Find the token you want to revoke
  3. Click the three dots menu (â‹®)
  4. Select Revoke
  5. Confirm the revocation
Immediate Effect

Revoking a token takes effect immediately. Any AI assistants using the token will lose access and need to be reconfigured with a new token.

Token Permissions​

MCP tokens have read-only access to performance data:

  • View flamegraphs
  • Query top functions and entities
  • Access GPU and CPU metrics
  • Read historical performance data

MCP tokens cannot:

  • Modify system configuration
  • Create or delete resources
  • Access authentication settings
  • Perform administrative actions

Troubleshooting​

Invalid Token Error​

If you receive authentication errors:

  • Verify the token was copied correctly (no extra spaces)
  • Check that the token hasn't been revoked
  • Ensure the token type is set to "MCP"