# Cursor (/ro/docs/integrations/cursor)

Folosești codai în Chat și Agent din Cursor prin slotul de cheie OpenAI și adaugi serverul MCP codai.

Cursor are nevoie de cheia ta codai în slotul **OpenAI API Key**, de base URL-ul `https://ai.codai.ro/v1` și de un model custom numit `codai`.

## Înainte să începi [#înainte-să-începi]

- O cheie codai din [hub.codai.ro](https://hub.codai.ro) → **Keys → Create key** (detalii în [quickstart](../gateway/index.mdx)).
- Un plan Cursor plătit. Cursor nu acceptă cheia ta pe planul Free.
- Pe Teams sau Enterprise, poate fi nevoie ca un admin să activeze comutatorul pentru cheia OpenAI.

## Chat și Agent [#chat-și-agent]

<Steps>
<Step>
Deschizi **Cursor Settings → Models** și extinzi **API Keys** în partea de jos.
</Step>
<Step>
Lipești cheia `codai_…` în **OpenAI API Key** și pornești **Use OpenAI API Key**.
</Step>
<Step>
Pornești **Override OpenAI Base URL** și introduci `https://ai.codai.ro/v1`. Nu adăuga `/chat/completions`.
</Step>
<Step>
Adaugi un model custom numit exact `codai`. Repornești Cursor, deschizi un chat nou și alegi `codai`.
</Step>
</Steps>

Nu numi modelul `claude-…`: Cursor trimite numele acestea prin slotul de cheie Anthropic, nu prin cel OpenAI.

<Callout type="info">
Cursor trece fiecare cerere prin serverele proprii ca să construiască prompt-ul final. Cheia ta călătorește cu fiecare cerere prin backend-ul Cursor, iar base URL-ul trebuie să fie HTTPS public — adresele `localhost` și din LAN nu merg.
</Callout>

## MCP [#mcp]

Fișier global: `~/.cursor/mcp.json` (Windows: `%USERPROFILE%\.cursor\mcp.json`). Fișier de proiect: `.cursor/mcp.json`. Cursor le combină; câștigă fișierul de proiect.

```json title="~/.cursor/mcp.json"
{
  "mcpServers": {
    "codai": {
      "url": "https://ai.codai.ro/mcp",
      "headers": { "Authorization": "Bearer ${env:CODAI_API_KEY}" }
    }
  }
}
```

- `${env:CODAI_API_KEY}` citește mediul sistemului. `envFile` nu se aplică serverelor remote, deci setezi variabila în shell sau în setările sistemului.
- Repornești Cursor după ce editezi fișierul.

## Ce merge și ce nu [#ce-merge-și-ce-nu]

| Funcție | Cu codai |
| --- | --- |
| Chat | Merge |
| Agent | Merge |
| Completare Tab | Nu — folosește mereu modelele Cursor |
| Cloud Agents | Nu — folosesc un set curatoriat de modele |
| Override de base URL Anthropic | Nu există în Cursor |

Pe Teams și Enterprise, Cursor percepe în continuare tariful propriu per token pe cererile făcute cu cheia ta, iar Zero Data Retention nu se aplică lor.

## Depanare [#depanare]

- **`404`** — base URL-ul are `/chat/completions` la final sau îi lipsește `/v1`. Trebuie să fie exact `https://ai.codai.ro/v1`.
- **Câmpul de cheie nu primește focus** — bug cunoscut în Cursor 3.15.x, reparat în 3.15.20. Ajungi la câmp cu Tab.
- **`codai` nu apare** — repornești Cursor și deschizi un chat nou; chat-urile existente își păstrează modelul.
- **MCP trimite o cheie goală** — `CODAI_API_KEY` nu e setată în mediul din care a pornit Cursor.

## Surse [#surse]

Verificate pe 2026-10-02.

- [Cursor — chei API](https://cursor.com/docs/settings/api-keys)
- [Cursor — MCP](https://cursor.com/docs/context/mcp)
- [Cursor help — MCP](https://cursor.com/help/customization/mcp)
- [Cursor — Cloud Agents](https://cursor.com/docs/cloud-agent)