> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudcapital.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrate Cursor

> Connect Cursor Teams usage and seat spend to Cloud Capital with a Team Admin API key. Cursor support is currently in Beta.

<Info>
  **Cursor support is in Beta.** To enroll, request access from your Cloud Capital Customer Success Manager. Once your account is enabled, **Cursor** appears as an option on the New Integration page. If you don't see it yet, reach out to your Customer Success Manager.
</Info>

Cloud Capital reads your **Cursor Teams** model usage and seat spend from the Cursor Team Admin API. You paste a **Team Admin API key** and choose a **default seat rate**; the key is encrypted and stored on the integration. Seat fees are synthesized from roster × configured rates. This path is **forecast-only**.

Setup takes about 5 minutes once you have a Team Admin API key.

***

### What Cloud Capital accesses

| What you're granting | How                                                 | Scope                                                                  |
| -------------------- | --------------------------------------------------- | ---------------------------------------------------------------------- |
| Team Admin API key   | Pasted into the integration form, encrypted at rest | Read access to team members, spend, and filtered usage events          |
| Default seat rate    | Configured in Cloud Capital                         | Used to synthesize seat fees (seat prices are not returned by the API) |

<Note>
  Cloud Capital uses the key only to **read** team usage and membership data. User / Cloud Agents keys will not work. This integration does not enable commitment purchasing or billing transfer.
</Note>

### What's available with Cursor today

| Available                                                                                | Not yet available                           |
| ---------------------------------------------------------------------------------------- | ------------------------------------------- |
| Cost forecasting, cost insights, and cost allocation for Teams usage + synthesized seats | Commitment purchasing through Cloud Capital |
| Nightly ingest of usage events and seat estimates                                        | Billing through Cloud Capital               |

***

### Before you begin

* **Teams Admin key** — Create a key from **Cursor Dashboard → Team API Keys**. Keys start with `crsr_`.
* **Not User / Cloud Agents keys** — Those keys cannot call the Team Admin endpoints Cloud Capital uses and will fail the connection test.
* **Seat rates** — Cursor does not expose seat dollar prices on this API. Cloud Capital synthesizes seat fees from members × your default seat rate.
* **Plan** — Team Admin API keys work for Teams (Enterprise is not required for this path).

### Setup

<Steps>
  <Step title="Create a new integration in Cloud Capital">
    In Cloud Capital, go to the **Integrations** page — from Cost Allocation, use **Manage Cloud Providers**. Click **Create New Integration** and choose **Cursor**.

    The new integration opens on the Integration Settings page. Give it a descriptive name.

    <img src="https://mintcdn.com/cloudcapital/FVAD307-AIysRkG_/images/get-started/cursor-integration-settings.png?fit=max&auto=format&n=FVAD307-AIysRkG_&q=85&s=71a44b979ec6462ef8924b917536cc91" alt="Cursor Integration Settings with Team Admin API key and default seat rate" width="640" height="462" data-path="images/get-started/cursor-integration-settings.png" />
  </Step>

  <Step title="Create a Team Admin API key in Cursor">
    In the Cursor Dashboard, open **Team API Keys** and create a **Team Admin** API key.

    The key must start with `crsr_`. Copy it once at creation time.

    <Warning>
      Do not use a User API key or a Cloud Agents key. Only Team Admin keys work with this integration.
    </Warning>
  </Step>

  <Step title="Paste the key, set seat rate, and test">
    On the Integration Settings page:

    1. Paste the Team Admin API key into the **Team Admin API key** field.
    2. Choose a **Default seat rate** that matches your Cursor seat type:
       * **standard**
       * **premium**
       * **free**
    3. Click **Test Connection**. Cloud Capital verifies it can reach the Cursor Team Admin API (members and usage).
    4. After a successful test, set status to **Enabled** and click **Save**.

    <Note>
      Seat fees are synthesized from roster × your configured rate — pick the type that matches how you bill seats; you can change it later and re-save. You must complete a successful connection test before you can enable a new integration. To rotate a key later, paste a new key and re-test; leave the field blank to keep the stored key.
    </Note>
  </Step>
</Steps>

***

### What to expect after setup

* **Data timing** — Cost data is ingested on a scheduled nightly cycle. Expect dashboards within about 24 hours of a successful connection.
* **Usage + seats** — Model usage comes from filtered usage events; seat fees are synthesized from team members × your configured rates.
* **Forecast only** — Commitment purchasing and billing transfer are not part of this integration.

### Troubleshooting

| Symptom                              | What to check                                                                                                               |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| Cursor card missing or Coming Soon   | Your org is not enrolled yet. Ask your Customer Success Manager to enable `cursor`.                                         |
| Connection test fails                | Confirm the key starts with `crsr_` and is a **Team Admin** key, not a User or Cloud Agents key.                            |
| Seat dollars look wrong              | Adjust **Default seat rate** to match how you bill seats, then save. Seats are synthesized, not read as invoice line items. |
| Test passes but dashboards are empty | Allow up to 24 hours for nightly ingest. Confirm the team has recent usage in the Cursor Dashboard.                         |

***

<Card title="Security" icon="shield-halved" href="/security">
  For a full overview of how Cloud Capital handles data access, encryption, audit logging, and compliance, see the Security page.
</Card>