# Integrări (/ro/docs/integrations)

Configurare pas cu pas pentru Cursor, Claude Code, GitHub Copilot, Cline, Continue, Zed, Vercel AI SDK și Codex CLI cu gateway-ul codai.

Fiecare tool de mai jos are nevoie de trei lucruri: un base URL, o cheie `codai_…` și numele de model `codai`. Alegi tool-ul, lipești snippet-ul, îl repornești.

<Cards>
  <Card title="Cursor" href="./cursor.mdx" description="Chat și Agent prin slotul de cheie OpenAI, plus MCP." />
  <Card title="Claude Code" href="./claude-code.mdx" description="Anthropic Messages pe URL-ul rădăcină, toate alias-urile fixate." />
  <Card title="GitHub Copilot" href="./github-copilot.mdx" description="Custom Endpoint în VS Code și BYOK în Copilot CLI." />
  <Card title="Cline" href="./cline.mdx" description="Provider-ul OpenAI Compatible în Plan și Act." />
  <Card title="Continue" href="./continue.mdx" description="config.yaml cu rolurile chat, edit și apply." />
  <Card title="Zed" href="./zed.mdx" description="Provider OpenAI-compatibil cu nume și un context server remote." />
  <Card title="Vercel AI SDK" href="./vercel-ai-sdk.mdx" description="AI SDK 7 prin provider-ul OpenAI-compatibil." />
  <Card title="Codex CLI" href="./codex-cli.mdx" description="Provider personalizat pe Responses API (încă neverificat cap-coadă)." />
</Cards>

## Cele trei valori [#cele-trei-valori]

| Format de wire | Base URL | Folosit de |
| --- | --- | --- |
| OpenAI Chat Completions | `https://ai.codai.ro/v1` | Cursor, Cline, Continue, Zed, Copilot CLI (`openai`) |
| OpenAI Chat Completions | `https://ai.codai.ro/v1` | Vercel AI SDK (`@ai-sdk/openai-compatible`) |
| OpenAI Responses | `https://ai.codai.ro/v1` | Codex CLI (`wire_api = "responses"`) |
| Anthropic Messages | `https://ai.codai.ro` (rădăcina, fără `/v1`) | Claude Code, Copilot CLI (`anthropic`), Zed (`anthropic_compatible`) |
| MCP (Streamable HTTP) | `https://ai.codai.ro/mcp` | Toate șase |

Cheia e aceeași peste tot: o creezi în [hub.codai.ro](https://hub.codai.ro) la **Keys → Create key** (vezi [quickstart](../gateway/index.mdx)). Modelul e `codai`; celelalte alias-uri sunt în [modele](../gateway/models.mdx).

## Ce nu servește codai [#ce-nu-servește-codai]

- **`POST /v1/completions`** (completions legacy, fill-in-the-middle). Autocomplete-ul din editor care îl apelează — autocomplete în Continue, edit predictions în Zed — nu merge cu codai. Le lași pe provider-ul propriu al tool-ului.
- **`POST /v1/messages/count_tokens`**. Clienții care îl tratează ca opțional merg mai departe.

## MCP pe scurt [#mcp-pe-scurt]

`https://ai.codai.ro/mcp` acceptă fie `Authorization: Bearer codai_…`, fie OAuth 2.1. Pentru OAuth, serverul de autentificare suportă Dynamic Client Registration și cere PKCE, deci un client care implementează specificația de autorizare MCP are nevoie doar de URL — fără cheie, fără client ID. Tool-urile și detaliile de autentificare sunt în [clienți](../gateway/clients.mdx#server-mcp).

## Când ceva nu merge [#când-ceva-nu-merge]

- **`404` la prima cerere** — base URL-ul e greșit. Tool-urile în stil OpenAI vor `/v1`; cele în stil Anthropic vor rădăcina. Multe tool-uri raportează acest `404` ca eroare de autentificare.
- **`401 invalid_api_key`** — cheia lipsește, e revocată sau a fost lipită cu un spațiu.
- **`429`** — citești `error.code`: `quota_exceeded` înseamnă că ai consumat task-urile planului, `rate_limit_exceeded` înseamnă că trimiți prea repede. Vezi [limite și prețuri](../gateway/limits-pricing.mdx).