# API & MCP: conectează un asistent AI

_API · 7 min de citit · Actualizat 2026-10-22 · https://lanachat.ai/guides/ro/api-mcp/_

**API & MCP** (în Users, jos în bara laterală) îți permite să conectezi un asistent AI, cum ar fi Claude sau alt client MCP, pentru a configura și gestiona spațiul tău de lucru. MCP este un standard deschis care permite unui asistent să folosească unelte dintr-o aplicație în numele tău. Aceleași token-uri de acces deschid și [REST API](https://lanachat.ai/guides/ro/api-overview/).

> Note: Doar proprietarul spațiului de lucru și proprietarii agenției pot accesa această pagină. Toți ceilalți văd mesajul „Owner access required”.

## Ce ai nevoie

- **Endpoint-ul MCP**, afișat în partea de sus a paginii. Apasă **Copy URL**.
- Un **token de acces** care specifică ce poate face asistentul.

## Creează un token de acces

1. Apasă **Create token**.
2. Dă-i un nume și alege accesul: **Workspace setup** sau **Custom permissions** pentru a bifa permisiunile individual (de exemplu „Read fans and conversations” sau „Read sales”).
3. Salvează. Token-ul este afișat o singură dată: apasă **Copy token** sau **Copy client configuration** pentru a obține o configurație gata făcută pentru asistentul tău.
4. Apasă **Done, I saved it**.

## Conectează-ți asistentul

1. Creează un acces dedicat pentru acest asistent (un token per unealtă conectată).
2. Adaugă conexiunea HTTP MCP în asistentul tău, cu endpoint-ul și token-ul (pașii exacți mai jos).
3. Întreabă-l ce poate vedea, ca să verifici dacă permisiunile sunt corecte.
4. Lucrează în drafturi: lasă-l să pregătească modificările, testează-le, apoi publică.

Aceiași pași, cu endpoint-ul, header-ul și configurația gata de copiat, sunt în **Connect your assistant** jos pe pagina API & MCP. În fiecare exemplu de mai jos, înlocuiește URL-ul cu cel al spațiului tău de lucru (**Copy URL**) și `YOUR_MCP_TOKEN` cu token-ul tău.

### Claude Code

O comandă în terminalul tău:

```bash
claude mcp add --transport http lanachat https://app.lanachat.ai/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"
```

Apoi tastează `/mcp` în Claude Code: `lanachat` apare ca fiind conectat, cu uneltele sale.

### Cursor

Adaugă asta în `~/.cursor/mcp.json` (pentru toate proiectele) sau `.cursor/mcp.json` (pentru un singur proiect), apoi activează `lanachat` în **Settings › MCP**:

```json
{
  "mcpServers": {
    "lanachat": {
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

### VS Code (GitHub Copilot)

Adaugă asta în `.vscode/mcp.json` în proiectul tău:

```json
{
  "servers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

### Claude Desktop

Claude Desktop pornește servere locale din fișierul său de configurare, astfel că ajunge la LanaChat prin micuțul pod `mcp-remote` (Node.js 18 sau mai nou). Deschide **Settings › Developer › Edit Config** și adaugă:

```json
{
  "mcpServers": {
    "lanachat": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.lanachat.ai/mcp", "--header", "Authorization:${LANACHAT_AUTH}"],
      "env": { "LANACHAT_AUTH": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

Repornește Claude Desktop; uneltele LanaChat apar în meniul de unelte al unui chat nou.

### ChatGPT și alți asistenți

Orice client MCP care poate trimite un header pe o conexiune HTTP funcționează cu configurația de mai sus. Conectorii web care oferă doar autentificare OAuth (conectori ChatGPT, conectori personalizați pe claude.ai) nu pot trimite un token de acces, deci nu pot conecta momentan.

### Verifică conexiunea

Inspectorul MCP listează uneltele pe care token-ul tău le deschide, fără niciun asistent:

```bash
npx @modelcontextprotocol/inspector
```

Alege **Streamable HTTP**, lipește endpoint-ul, adaugă header-ul `Authorization: Bearer YOUR_MCP_TOKEN`, apoi **Connect** și **List tools**.

## Gestionează token-urile

Tabelul **Access tokens** arată permisiunile, expirarea și starea fiecărui token. Folosește **Edit**, **Rotate** (sau **Renew**) și **Revoke**. **Show revoked tokens** listează token-urile vechi.

> Warning: Un token funcționează ca o parolă. Revocă-l imediat ce nu mai folosești asistentul sau dacă crezi că a fost compromis.

## Endpoint-ul MCP

| Method | Path | Descriere | Permisiune | Stare |
|---|---|---|---|---|
| POST | `https://app.lanachat.ai/mcp` | Serverul MCP (Streamable HTTP): toate apelurile uneltelor merg aici | orice token | Planned |
| GET | `https://app.lanachat.ai/mcp` | Deschide fluxul de evenimente al sesiunii | orice token | Planned |
| POST | `https://app.lanachat.ai/api/media/uploads` | Upload media de la un asistent, cu același token | `can_setup` | Planned |

URL-ul exact al spațiului tău de lucru este afișat în partea de sus a paginii API & MCP (**Copy URL**). Token-ul se pune în header-ul `Authorization`, ca la API. O configurație client arată așa:

```json
{
  "mcpServers": {
    "lanachat": {
      "type": "http",
      "url": "https://app.lanachat.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" }
    }
  }
}
```

## Uneltele pe care le primește asistentul

Asistentul vede doar uneltele permise de token-ul său. O unealtă pe care nu o poate folosi nu apare deloc. Când se conectează, serverul trimite asistentului argumentele exacte ale fiecărei unelte (nume, tip, obligatoriu), ca să nu le tastezi tu manual. Ultima coloană arată endpoint-ul API care face același lucru, unde parametrii sunt documentați.

| Unealtă | Ce face | Permisiune | Echivalent în API |
|---|---|---|---|
| `list_creators`, `get_creator` | Citește creatoarele, identitatea și progresul configurării | `can_setup` | [`GET /creators`](https://lanachat.ai/guides/ro/api-creators/) |
| `update_creator`, `update_persona` | Schimbă identitatea creatoarei sau paginile persona | `can_setup`, `can_engine` pentru persona | [`PUT …/identity`, `PATCH …/persona`](https://lanachat.ai/guides/ro/api-creators/) |
| `list_accounts`, `update_account` | Citește conturile Telegram, schimbă brain, piață sau trafic | `can_setup` | [`GET /accounts`, `PATCH /accounts/{id}`](https://lanachat.ai/guides/ro/api-telegram-accounts/) |
| `list_media`, `upload_media`, `update_media`, `create_media_folder` | Adaugă media în Vault, sortează, sugerează descrieri (arată pentru revizuire înainte de salvare) | `can_setup` | [`/media`](https://lanachat.ai/guides/ro/api-vault/) |
| `list_scripts`, `draft_script`, `update_script` | Citește scripturi și creează drafturi: pași, media și prețuri Stars | `can_setup` | [`/scripts`](https://lanachat.ai/guides/ro/api-scripts/) |
| `list_members`, `update_member` | Citește și schimbă membrii echipei | `can_setup` | [`/members`](https://lanachat.ai/guides/ro/api-team/) |
| `get_brain`, `update_brain_draft`, `test_brain` | Citește un brain, editează draftul, testează în Playground | `can_engine` | [`/brains`, `/playground`](https://lanachat.ai/guides/ro/api-ai-brains/) |
| `publish_brain` | Publică un draft obișnuit de brain | `can_publish` | [`POST /brains/{id}/publish`](https://lanachat.ai/guides/ro/api-ai-brains/) |
| `test_advanced_ai`, `tune_advanced_ai`, `publish_advanced_ai` | Drafturi, setări și profile AI avansat (doar proprietar spațiu) | `can_ai_test`, `can_ai_tune`, `can_ai_publish` | None |
| `list_experiment_reports` | Citește rapoarte comerciale de experimente (doar proprietar spațiu) | `can_commercial_reports` | None |
| `list_fans`, `get_conversation` | Citește fanii și istoricul conversațiilor | `can_fan_read` | [`GET /fans`, `GET /conversations/{id}/messages`](https://lanachat.ai/guides/ro/api-conversations/) |
| `import_fan_history` | Adaugă fani și mesaje din trecut în evidențe; nu trimite niciodată mesaje | `can_fan_import` | [`POST /fans/import`](https://lanachat.ai/guides/ro/api-conversations/) |
| `list_sales` | Citește vânzările înregistrate pentru rapoarte | `can_sales_read` | [`GET /fans/{id}/sales`](https://lanachat.ai/guides/ro/api-conversations/), [`GET /stats`](https://lanachat.ai/guides/ro/api-tracking/) |

> Note: Dezactivarea **Access AI configuration** șterge și permisiunile de publicare, AI avansat și rapoarte de experimente. Permisiunile pentru configurarea spațiului, fani și vânzări rămân independente. Nicio unealtă nu trimite mesaje către fani.

## Ce să-i ceri

Vorbește cu el ca și cum ar fi un coleg care cunoaște Console. Câteva prompturi care funcționează bine:

- „List my creators and tell me which ones have an unfinished setup.”
- „Read Lea's persona and suggest three phrase bank answers for fans who ask if she is real. Do not save anything.”
- „Draft a win-back script for Lea: three steps over two days, the last one a paid set at 250 Stars. Leave it inactive.”
- „Upload the photos in this folder to Lea's Vault, in a folder called Beach, and suggest a description for each.”
- „Change the draft of Lea's brain so the first offer comes after 6 messages, test it in the Playground with a new English-speaking fan, and show me the replies before you publish.”
- „How much did each creator sell yesterday, and which tracking link brought the most buyers this week?”

> Tip: Cere-i să lucreze în drafturi și să-ți arate rezultatul înainte să publice. Publicarea necesită un token cu **Publish AI Brain drafts**: lasă-l dezactivat dacă vrei să păstrezi ultimul cuvânt.

## Endpoint-urile token-ului

Pagina de mai sus apelează aceste rute; [ghidul echipei](https://lanachat.ai/guides/ro/api-team/) listează aceleași acțiuni în API-ul public (`/v1/tokens`).

| Method | Path | Descriere | Permisiune | Stare |
|---|---|---|---|---|
| GET | `/api/mcp/tokens` | Listează token-urile, permisiunile, expirarea și starea | `owner` | Planned |
| POST | `/api/mcp/tokens` | Creează un token (afișat o singură dată) | `owner` | Planned |
| PUT | `/api/mcp/tokens/{id}` | Editează numele sau permisiunile | `owner` | Planned |
| POST | `/api/mcp/tokens/{id}/rotate` | Rotește secretul | `owner` | Planned |
| DELETE | `/api/mcp/tokens/{id}` | Revocă token-ul | `owner` | Planned |

Aceste rute Console primesc și returnează permisiunile ca câmpuri booleene (`can_setup`, `can_engine`, `can_publish`, `can_ai_test`, `can_ai_tune`, `can_ai_publish`, `can_commercial_reports`, `can_fan_read`, `can_fan_import`, `can_sales_read`). Crearea unui token răspunde cu `{ "token": "…", "grant": { … } }`: `token` este secretul, afișat o singură dată; `grant` este accesul cu `id`, `name`, `scope`, `enabled`, `created` și `expires` (secunde Unix). Rotirea revocă accesul vechi și răspunde cu un nou `token` și `grant`. Lipsa unui nume răspunde cu `400`, un id necunoscut cu `404`, un acces revocat cu `409`.

Mai multe pe [pagina funcționalității API și MCP](https://lanachat.ai/landing/features/api-and-mcp/).

## Articole conexe

- [API LanaChat: început rapid, autentificare și erori](https://lanachat.ai/guides/ro/api-overview/)
- [Rețete rapide API: copiază, lipește, rulează](https://lanachat.ai/guides/ro/api-recipes/)
- [Ce este un AI Brain](https://lanachat.ai/guides/ro/what-is-an-ai-brain/)