Skip to content

Connect Cursor#

Connect Cursor to OptScale AI so chats and agent workflows use models available through your OptScale AI organization.

In Chat, copy Base URL, API key, and Model name from Get connection values from Chat before configuring Cursor.

For shared model naming rules and limitations, see External Tools overview.

Prerequisites#

Ensure the following prerequisites are met before configuring Cursor:

  • An organization exists and at least one Active provider is configured.
  • Allowed providers are assigned to the user connecting Cursor to OptScale AI.
  • The OptScale AI deployment is accessible over HTTPS with a valid TLS certificate.
  • For agent workflows that use tools, select a model that supports tool execution.

Configure Cursor#

  1. Open the Cursor Settings page:

    • For Windows and Linux: File → Preferences → Cursor Settings

      Cursor File menu with Preferences and Cursor Settings selected on Windows or Linux

    • For macOS: Cursor → Settings → Cursor Settings

      Cursor menu with Settings and Cursor Settings selected on macOS

  2. Go to Models → click View All Models.

    Cursor Settings Models page with Models sidebar and View All Models highlighted

  3. Click +Add Custom Model.

    Cursor Settings Models page with Add Custom Model highlighted

  4. Add the model:

    • In OptScale AI Chat, select the provider and model, then open Connect this model to external tools → CURSOR and copy Model name.

      OptScale AI Copy Model Name

    • In Cursor, paste the value into Enter model name, then click Add.

      Cursor Settings Models page Paste Model Name

  5. Configure the API key and Base URL:

    • Expand API Keys in Cursor.

      Cursor expand API Key section

    • From Connect this model to external tools → CURSOR in Chat, copy API key and paste it into OpenAI API Key.

      OptScale AI Chat copy API Key

      Cursor paste API Key

    • Enable Override OpenAI Base URL.

    • Copy Base URL from the same Chat dialog and replace the existing value in Override OpenAI Base URL.

      OptScale AI Chat copy Base URL

      Cursor paste Base URL

  6. Save the configuration.

The configured model is now available in Cursor chats and agent workflows.

Note

Cursor supports one OpenAI-compatible Base URL and API key configuration at a time. Changing this configuration affects the models available through that connection.

Verify the Cursor connection#

Start a Cursor chat or agent task, select one of the added models, and send the following prompt:

Reply with exactly: OptScale AI connection works.

The expected response is:

OptScale AI connection works.

In the Admin Console, open Analytics → Traces and confirm that a row appears for the selected Provider and Model. Requester is the user for whom the connection was configured.

See also#

Support email: [email protected] | Terms of use | © 2026 OptScale AI. All rights reserved | [email protected]