Connect Cursor

Add your Cursor Team Admin API key and Cloud Sessions key so Tokenize can read Cursor usage, budgets, cloud agent sessions, and Grok Bots.

Tokenize connects to Cursor with two keys. The Team Admin API key reads your team's members, usage, and spend limits. The Cloud Sessions key downloads transcripts from Cursor's cloud and background agents. Both live in the Cursor group of Settings → Providers. Click a section title to open it. A check mark before the title means a working key is saved.

Who can do this: Admins in Tokenize. You also need admin access to your Cursor team.

What each key unlocks

KeyWhat it unlocks in Tokenize
Team Admin APIThe member directory, Cursor usage reports, reading and changing per-person budgets, and switching models off for your Cursor team from the Models page. On a Cursor Enterprise team it also reads the team audit log, which names your Grok Bots and their routines on the Bots tab.
Cloud SessionsTranscripts for Cursor cloud and background agent sessions, shown in Sessions

The Cloud Sessions key only works alongside a working Team Admin API key. Add the Team Admin API key first.

To capture sessions people run in Cursor on their own computers, you also need the desktop app and Cursor hooks. Cursor Enterprise teams can instead have Cursor's servers send usage for the whole team. See Cursor OTel.

Add the Team Admin API key

A Cursor team admin must create this key.

  1. Open Team API keys in the Cursor dashboard.
  2. Create a team Admin API key.
  3. Copy the key.
  4. In Tokenize, go to Settings → Providers. In the Cursor group, open Team Admin API, paste the key into API key, and click Save.

The How to create a key link in the section opens these same steps.

If you paste a personal key here, Tokenize says "This looks like a personal Cursor key. Budgets need a team Admin API key: ask a Cursor team admin to create one with the admin:* scope under API Keys in the Cursor dashboard. A personal key goes in Cloud Sessions." Create a team Admin API key with the admin:* scope instead.

Add the Cloud Sessions key

Use a service-account key. Admins create service accounts from the Cursor Dashboard.

  1. In the Cursor Dashboard, go to Settings → API Keys → Service Accounts.
  2. Click New Service Account.
  3. Enter a name and an optional description.
  4. Click Create.
  5. Copy the key Cursor shows.
  6. In Tokenize, open Cloud Sessions in the Cursor group, paste the key into API key, and click Save.

Cursor's service account documentation has more detail.

Service accounts need Cursor Enterprise. On other plans, create a user API key in the Cursor Dashboard and paste it here instead. User keys are tied to your own account. See Cursor's authentication documentation.

Check the connection

After you save, each section shows the key's last four characters, a status badge, and the results of the access check:

  • Team Admin API checks "Member directory", "Usage reports", "Read budgets", and "Change budgets".
  • Cloud Sessions checks "Agent listing" and "Session access".

If you see "Cloud-agent capture is off. Add and verify the Cursor Admin API key above." the Cloud Sessions key is fine but the Team Admin API key is missing or failed its check. Add or replace the Team Admin API key.

For badges and error messages, see Provider key errors.

Budgets and Cursor spend limits

To apply budgets in Cursor, per-person spend limits must be turned on for your Cursor team. If they're off, Cursor refuses the limits. After a save you'll see "Cursor: didn't update. Turn on per-person spend limits in Cursor, and limits update within 15 minutes." If Cursor is your only budgets key, Budgets says "Budgets are off while Cursor limits are off" until you turn them on. Budgets come back by themselves within about 15 minutes.

Model limits in Cursor

With a Team Admin API key saved, the Models page shows a Cursor card where you switch off models for your Cursor team. The key needs Cursor's models permission or full admin, and your team needs Cursor's Enterprise plan. See Control which models people use.