API & MCP: conectează un asistent AI

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.

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.

Captură de ecran

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:

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:

{
  "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:

{
  "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ă:

{
  "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:

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.

Endpoint-ul MCP #

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:

{
  "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.

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?”

Endpoint-urile token-ului #

Pagina de mai sus apelează aceste rute; ghidul echipei listează aceleași acțiuni în API-ul public (/v1/tokens).

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.