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

# Use AIsa in Cursor

> Route Cursor's chat and agent requests through AIsa with a custom OpenAI base URL.

Cursor lets you bring your own OpenAI-compatible key. Point it at AIsa's endpoint and every model in the AIsa catalog becomes available in Cursor's chat and agent modes.

AIsa endpoint:

```txt theme={null}
https://api.aisa.one/v1
```

## Prerequisites

Before you start, make sure you have:

* An AIsa API key ([console.aisa.one/api-keys](https://console.aisa.one/api-keys))
* [Cursor](https://cursor.com) installed

## 1. Open Cursor's model settings

<Steps>
  <Step title="Open Cursor Settings">
    Press `Cmd+Shift+J` (macOS) or `Ctrl+Shift+J` (Windows/Linux), or use the gear icon in the top-right corner.
  </Step>

  <Step title="Go to Models">
    Select the **Models** tab, then scroll to the **API Keys** section.
  </Step>
</Steps>

## 2. Configure the AIsa endpoint

<Steps>
  <Step title="Enter your AIsa key">
    In the **OpenAI API Key** field, paste your AIsa key (`sk-aisa-...`).
  </Step>

  <Step title="Override the base URL">
    Enable **Override OpenAI Base URL** and enter:

    ```txt theme={null}
    https://api.aisa.one/v1
    ```
  </Step>

  <Step title="Verify">
    Click **Verify**. Cursor sends a test request through AIsa; a green check means the endpoint and key are working.
  </Step>
</Steps>

## 3. Add AIsa models

In the model list on the same **Models** page, click **Add model** and enter the exact AIsa model ID you want to use, for example:

```txt theme={null}
gpt-5
kimi-k2.5
claude-opus-4-8
deepseek-v4-flash
```

Enable the models you added, then select one from the model picker in chat or agent mode. The full list of IDs is in the [model catalog](/docs/guides/models).

<Note>
  Custom API keys apply to Cursor's chat and agent requests. Cursor-native features such as Tab autocomplete continue to use Cursor's own models and subscription.
</Note>

## 4. Connect AIsa capabilities

Open a chat or agent session in Cursor and paste:

```txt theme={null}
Read https://aisa.one/docs/agent-quickstart.md and help me safely connect, configure, and use AIsa's APIs, Skills, and LLMs in this agent environment.
```

Cursor's agent will fetch AIsa's agent-facing instructions and guide you through the remaining setup.

Try:

```txt theme={null}
Use AIsa capabilities to search the web and summarize the latest information about Cursor.
```

## Quick reference

| Item                     | Value                                                                                                                                                    |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Settings location        | Cursor Settings → Models → API Keys                                                                                                                      |
| OpenAI API Key field     | Your AIsa key (`sk-aisa-...`)                                                                                                                            |
| Override OpenAI Base URL | `https://api.aisa.one/v1`                                                                                                                                |
| Model names              | Exact IDs from the [catalog](/docs/guides/models), e.g. `kimi-k2.5`                                                                                           |
| Capability setup prompt  | `Read https://aisa.one/docs/agent-quickstart.md and help me safely connect, configure, and use AIsa's APIs, Skills, and LLMs in this agent environment.` |

## Troubleshooting

| Problem                    | Fix                                                                                                                         |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| Verify fails               | Confirm the base URL is exactly `https://api.aisa.one/v1` and the key is valid in the [dashboard](https://console.aisa.one) |
| Model not selectable       | Add it under **Add model** with the exact catalog ID, then toggle it on                                                     |
| "Invalid model" errors     | The typed model name must match a catalog ID exactly — no `aisa/` prefix in Cursor                                          |
| Tab autocomplete unchanged | Expected — custom keys cover chat/agent only                                                                                |

## Related

<CardGroup cols={3}>
  <Card title="Use AIsa in Claude Code" icon="terminal" href="/docs/guides/tutorials/use-aisa-in-claude-code">
    Configure Claude Code with the same AIsa key.
  </Card>

  <Card title="Authentication" icon="key" href="/docs/guides/authentication">
    API key creation, rotation, and storage best practices.
  </Card>

  <Card title="Model Catalog" icon="list" href="/docs/guides/models">
    Browse model IDs before adding them to Cursor.
  </Card>
</CardGroup>