Facturare cu AI: cum emiți facturi din Claude sau Cursor

Facturarea este munca pe care nimeni nu vrea să o facă, dar care trebuie făcută la timp, corect și lună de lună. Prin MCP (Model Context Protocol) și Recev, poți muta acest efort către un agent AI: îi spui într-o singură frază ce factură vrei, iar ea se emite în softul tău de facturare, cu datele firmei preluate din ANAF și cu produsele completate din catalogul tău.

Acest ghid explică ce este MCP, ce poți face concret cu el în facturare, cum conectezi Recev la clientul tău AI și unde găsești instrucțiunile pentru fiecare soft de facturare în parte.

Ce este MCP și de ce contează pentru facturare

Model Context Protocol este un standard deschis lansat de Anthropic prin care asistenții AI se conectează direct la aplicații și surse de date. Este, practic, un port comun: un singur protocol prin care orice client compatibil — Claude Desktop, Claude Code, Cursor, Windsurf — poate folosi funcționalitățile unei aplicații.

Diferența față de a cere unui chatbot să „scrie o factură” este esențială. Fără MCP, modelul îți produce un text care semănă cu o factură. Cu MCP, modelul apelează o funcție reală din contul tău, iar rezultatul este un document fiscal emis în softul tău, cu serie și număr. Nu este o simulare și nu este un text generat: este aceeași operațiune pe care ai fi făcut-o manual.

Ce poți face concret

Serverul MCP al Recev expune câteva operațiuni pe care agentul le poate executa în numele tău:

De ce prin Recev și nu direct prin API-ul softului

Fiecare soft de facturare are propriul API, propria documentație și propriile reguli de validare. Dacă vrei să emiți facturi programatic direct, scrii și întreții câte o integrare pentru fiecare. Iar dacă schimbi softul, rescrii integrarea.

Recev stă între agentul AI și softul de facturare și normalizează diferențele. Obții aceeași comandă indiferent de furnizor, plus validarea datelor înainte ca factura să plece. În practică înseamnă că poți schimba softul de facturare fără să schimbi modul în care lucrezi.

Cum conectezi Recev la clientul tău AI

1. Conectează softul de facturare

Creează-ți cont pe app.recev.ro, adaugă datele firmei ca emitent și conectează integrarea dorită din secțiunea Integrări. Vezi toate integrările disponibile înainte să începi.

2. Generează un API token

Din Setările afacerii, generează un API token. Aceasta este cheia cu care clientul MCP se autentifică. Copiază-l imediat într-un manager de parole — nu mai este afișat după închiderea ferestrei.

3. Conectează clientul MCP

Endpoint-ul este https://app.recev.ro/api/mcp și folosește autentificare Bearer. Prin Claude Code:

claude mcp add --transport http recev https://app.recev.ro/api/mcp 
  --header "Authorization: Bearer <api-token>"

Dacă lucrezi într-un proiect cu mai mulți colegi, folosește un fișier .mcp.json și o variabilă de mediu, ca să nu ajungă tokenul în repository:

{
  "mcpServers": {
    "recev": {
      "type": "http",
      "url": "https://app.recev.ro/api/mcp",
      "headers": { "Authorization": "Bearer ${RECEV_API_TOKEN}" }
    }
  }
}

Ghiduri pas cu pas, pentru fiecare soft

Pașii diferă ușor de la un furnizor la altul, mai ales la obținerea cheilor API. Fiecare ghid de mai jos acoperă exact acele diferențe:

Ce se întâmplă cu datele tale

Agentul AI nu primește acces la contul tău de facturare. Primește acces la tool-urile expuse de Recev, iar Recev vorbește mai departe cu softul tău folosind cheile pe care le-ai conectat. Tokenul poate fi revocat oricând din Setările afacerii, iar revocarea întrerupe imediat accesul, fără să afecteze facturile deja emise.

Merită spus și ce nu face: agentul nu decide singur când să emită facturi. Acționează doar când îi ceri, iar pentru facturarea automată la scadență folosești plățile recurente, care rulează independent de orice client AI.

În ce clienți AI funcționează

MCP este un standard, nu o funcție a unui singur produs, deci serverul Recev funcționează în orice client care implementează protocolul peste HTTP. În practică, cele mai folosite variante sunt:

Suportul diferă de la un client la altul și evoluează rapid. Dacă al tău acceptă servere MCP prin HTTP cu antet de autorizare, va merge.

Un exemplu complet, de la frază la factură

Presupunem că ai conectat SmartBill și vrei să facturezi un abonament lunar. Îi scrii agentului:

„Emite o factură prin SmartBill pentru CUI 40398844, 100 lei, servicii de design.”

Ce se întâmplă în spate, în ordine:

  1. Agentul apelează tool-ul generate_invoice expus de Recev, cu parametrii extrași din fraza ta.
  2. Recev interoghează ANAF după CUI și completează denumirea, adresa, numărul de la Registrul Comerțului și statusul de plătitor de TVA.
  3. Serviciul „servicii de design” este căutat în catalogul tău și completat cu unitatea de măsură și cota de TVA corectă.
  4. Factura este emisă în SmartBill, în seria și numerotarea ta.
  5. Primești înapoi seria, numărul și link-ul către PDF.

Pentru un abonament în loc de o factură singulară, tool-ul folosit este create_subscription, iar rezultatul este o subscripție cu link de plată care emite automat factura la fiecare ciclu de încasare.

MCP, API direct sau manual: ce alegi

Cele trei abordări rezolvă probleme diferite, iar alegerea depinde mai mult de volum și de cine face munca decât de preferințe tehnice.

Pentru încasări care se repetă la interval fix, niciuna dintre cele trei nu este răspunsul potrivit — acolo vrei ca sistemul să pornească singur, fără ca cineva să ceară ceva.

Probleme frecvente la conectare

Merită pentru afacerea ta?

Dacă emiți câteva facturi pe lună, diferența este mică. Dacă emiți zeci de facturi cu aceleași câteva servicii, sau dacă lucrezi deja într-un editor cu AI, economia de timp devine reală — nu atât din scrierea facturii, cât din căutarea datelor firmei și din corectarea greșelilor de transcriere.

Pentru încasări repetate, combinația care contează este alta: abonamentul încasează automat la scadență, iar factura se emite și se marchează ca încasată singură. Vezi planurile disponibile sau citește cum funcționează încasarea automată.