SmartBill este liderul de facturare cloud din România. Prin MCP și Recev, îl poți pune să lucreze alături de orice agent AI: conectezi SmartBill la MCP și emiți facturi printr-o singură frază în Claude, Cursor sau orice client MCP, fără să deschizi aplicația SmartBill.
Ce este MCP (Model Context Protocol)
Model Context Protocol (MCP) este un standard deschis lansat de Anthropic care permite asistenților AI să se conecteze direct la aplicații și surse de date. Practic, MCP este „USB-C-ul pentru AI”: un singur protocol prin care orice client (Claude Desktop, Claude Code, Cursor, Windsurf, ChatGPT) poate accesa funcționalitățile unei aplicații.
În loc să copiezi date dintr-o aplicație în alta, agentul AI face apelurile pentru tine — citește, scrie, validează și execută acțiuni reale prin tool-urile expuse de serverul MCP.
Cum te ajută MCP-ul Recev pentru SmartBill
Recev expune un server MCP unificat care îți permite să emiți facturi prin SmartBill (și prin orice altă integrare de facturare conectată la Recev) direct din clientul tău AI preferat. Câteva beneficii practice:
- Emiti facturi SmartBill în limbaj natural — „Fă o factură SmartBill de 1.200 lei pentru CUI 12345678, abonament lunar” și factura e gata.
- Auto-completare ANAF — pentru persoane juridice, denumirea, adresa, RegCom și statusul de plătitor TVA se preiau automat.
- Catalog de produse reconciliat — produsele și serviciile sunt căutate automat în catalogul tău Recev și completate cu preț, TVA și unitate de măsură.
- Abonamente recurente — creezi subscripții cu link de plată ce emit automat factura în SmartBill la fiecare încasare.
- Multiple integrări simultan — păstrezi SmartBill, Oblio, FGO și Startco și alegi la cerere prin care emiti.
Pași de conectare SmartBill la MCP prin Recev
1. Creează cont pe Recev
Mergi pe app.recev.ro și creează-ți un cont. Adaugă datele firmei tale ca emitent și conectează integrarea SmartBill din secțiunea Integrări — vei avea nevoie de username-ul (emailul) și token-ul API din contul tău SmartBill.
2. Generează API key-ul Recev
Din Setările afacerii în Recev, generează un API token. Acesta este cheia cu care clientul MCP se autentifică la serverul Recev. Copiază-l undeva sigur — nu va mai fi afișat după închiderea modalului.
3. Conectează clientul MCP la Recev
Endpoint-ul MCP al Recev este https://app.recev.ro/api/mcp și folosește autentificare Bearer. Spune-i clientului MCP să se conecteze acolo cu token-ul tău.
Conectare prin Claude Code CLI
claude mcp add --transport http recev https://app.recev.ro/api/mcp
--header "Authorization: Bearer <api-token>"Conectare prin .mcp.json (fără secret în repo)
{
"mcpServers": {
"recev": {
"type": "http",
"url": "https://app.recev.ro/api/mcp",
"headers": { "Authorization": "Bearer ${RECEV_API_TOKEN}" }
}
}
}Setezi RECEV_API_TOKEN ca variabilă de mediu (de exemplu în .env) și nu mai expui niciodată token-ul în repo.
Exemplu: emite o factură SmartBill dintr-un chat
După conectare, îi poți spune AI-ului în limbaj natural:
„Emite o factură prin SmartBill pentru CUI 40398844, 100 lei, servicii de design.”
Clientul MCP va apela tool-ul generate_invoice al Recev, va prelua datele firmei din ANAF, va emite factura prin SmartBill și îți va returna seria, numărul și link-ul PDF. Total: două secunde de muncă reală.
De ce să folosești MCP în loc de API direct SmartBill?
Pentru că nu mai scrii cod, nu mai cauți documentație SmartBill și nu mai construiești formulare. Descrii în cuvinte ce vrei să se întâmple, iar agentul AI traduce intenția în apeluri API validate, completate automat din ANAF și reconciliate cu catalogul tău Recev.
În plus, ai același flux pentru orice altă integrare conectată la Recev — schimbi un singur parametru (billing) și emiti prin Oblio, FGO, Startco sau SmartBill.
Începe acum
Creează cont Recev gratuit, conectează-ți contul SmartBill, generează API key-ul și ești gata să emiți facturi din orice client MCP. Dacă ai întrebări, scrie-ne — te ghidăm pas cu pas.
