Cum conectezi swapp.ro la ChatGPT, Claude sau Cursor prin MCP
Actualizat pe
Ca să lucreze cu swapp.ro, asistentul tău AI are nevoie de o singură adresă: https://swapp.ro/mcp. Este adresa unui server MCP la distanță. O adaugi o singură dată, iar de la un asistent la altul diferă doar locul în care o adaugi.
Ghidul arată pașii pentru fiecare asistent, ce alegi când îi dai acces la cont și cum închizi conexiunea. Ce poate și ce nu poate face asistentul cu evidența ta găsești în ghidul Cum folosești ChatGPT sau Claude pentru facturile și taxele unui PFA.
Ce îți trebuie
- Un asistent care acceptă servere MCP la distanță, numite uneori „conectori personalizați”. ChatGPT, Claude, Cursor, Claude Code, Codex și OpenCode le acceptă. La unii, opțiunea depinde de abonament sau trebuie activată din setări.
- Un cont swapp.ro, doar pentru datele tale. Taxele pe un venit, cursul BNR, plafonul de TVA și ghidurile le poți întreba și fără cont.
Pasul 1: adaugi adresa în asistent
ChatGPT
Pe chatgpt.com/plugins, alegi „Add custom MCP server”, completezi adresa https://swapp.ro/mcp și alegi autentificarea OAuth. Dacă lucrezi în terminal, urmează pașii pentru Codex.
Claude
În Claude, pe web sau în aplicație, deschizi Setări › Conectori și adaugi un conector personalizat. Îl numești swapp și completezi adresa. Apoi, din lista de conectori, îi dai acces la contul swapp. Dacă lucrezi în terminal, urmează pașii pentru Claude Code.
Claude Code
claude mcp add --transport http --scope user swapp https://swapp.ro/mcp
claude mcp login swapp
Prima comandă adaugă conectorul pentru toate proiectele tale, a doua îi dă acces la contul swapp. Poți face asta și dintr-o sesiune deschisă, cu comanda /mcp.
Codex
codex mcp add swapp --url https://swapp.ro/mcp
codex mcp login swapp
Cursor
Adaugi conectorul în ~/.cursor/mcp.json, fișierul folosit atât de editor, cât și de terminal:
{
"mcpServers": {
"swapp": {
"url": "https://swapp.ro/mcp"
}
}
}
Apoi îi dai acces la contul swapp din terminal, cu agent mcp login swapp, sau din editor, din lista serverelor MCP.
OpenCode
opencode mcp add swapp --url https://swapp.ro/mcp --global
opencode mcp auth swapp
Pasul 2: îi dai acces la cont
Când îi dai acces la cont, asistentul te trimite în swapp.ro. Te autentifici, dacă nu ești deja, și ajungi pe pagina „Conector AI”, unde:
- alegi entitatea la care dai acces, una singură; dacă lucrezi pentru mai multe, conectezi asistentul la fiecare pe rând;
- vezi că asistentul va putea să „citească datele entității”, fără de care n-ar putea face nimic;
- bifezi „adauge ore lucrate, terți, facturi și operațiuni din extrasele de cont” doar dacă vrei ca asistentul să și salveze;
- apeși „Permite accesul”.
Alegerea nu se ține minte: la fiecare conectare nouă alegi din nou. Dacă la entitate ai rolul Inspector, a doua opțiune nici nu se poate bifa, iar asistentul doar citește.
Pasul 3: verifici că merge
Întreabă-l ceva simplu, de exemplu „Ce facturi am emis luna asta în swapp?”. Dacă răspunsul vine din aplicație, conexiunea e gata.
Ce vezi în aplicație
În Setări › Conector AI vezi asistenții conectați. Orele, facturile și operațiunile salvate de un asistent apar marcate „AI” până le aprobi, din listă sau de pe ecranul lor, ori până le salvezi tu din editor. Din acel moment sunt ale tale, iar asistentul nu le mai poate șterge.
Deconectarea
Din Setări › Conector AI, cu „Deconectează”: asistentul pierde accesul pe loc. Îl poți conecta din nou oricând, din asistent.
Dacă îl scoți doar din asistent, conexiunea poate rămâne în listă, pentru că nu toți asistenții anunță aplicația. Așa că închide-o și de aici.
Accesul se încheie și singur când îți schimbi parola prin „Am uitat parola”, când nu mai ai acces la entitate sau când asistentul nu l-a folosit timp de 90 de zile.
Dacă nu merge
- Asistentul nu găsește conectorul. Verifică adresa: exact
https://swapp.ro/mcp, fără nimic după. - Contul tău nu are nicio entitate. Asistentul primește acces la o entitate comercială, așa că adaug-o întâi în aplicație, apoi reia conectarea din asistent.
- Asistentul spune că nu are voie să salveze. L-ai conectat doar pentru citire. Deconectează-l din setări și conectează-l din nou, bifând și a doua opțiune.
- Vrei să lucreze cu altă entitate. Fiecare conexiune e legată de o singură entitate. Conectează-l din nou și alege-o pe cealaltă.