Oblio este una dintre cele mai folosite soluții de facturare și contabilitate online din România. Conectezi Oblio la MCP prin Recev și emiți facturi printr-o singură frază în Claude, Cursor sau orice client MCP — cu tipul de produs (Serviciu / Marfă), TVA și datele clientului completate automat.
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 Oblio
Recev expune un server MCP unificat care îți permite să emiți facturi prin Oblio (și prin orice altă integrare de facturare conectată la Recev) direct din clientul tău AI preferat. Câteva beneficii practice:
- Emiti facturi Oblio în limbaj natural — „Fă o factură Oblio de 500 lei pentru CUI 12345678, abonament SaaS” și factura e gata.
- productType setat automat — Recev setează implicit
Serviciupentru Oblio și îți cere clarificare doar dacă vinziMarfă. - Auto-completare ANAF — pentru persoane juridice, denumirea, adresa, RegCom și statusul de plătitor TVA se preiau automat.
- Catalog de produse reconciliat — produsele tale sunt căutate în catalogul Recev și completate cu preț, TVA și unitate de măsură.
- Multiple integrări simultan — păstrezi Oblio, SmartBill, FGO și Startco și alegi la cerere prin care emiti.
Pași de conectare Oblio 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 Oblio din secțiunea Integrări — vei avea nevoie de emailul și secretul API generat din contul tău Oblio.
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ă Oblio dintr-un chat
După conectare, îi poți spune AI-ului în limbaj natural:
„Emite o factură prin Oblio 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 seta productType: Serviciu, va emite factura prin Oblio ș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 Oblio?
Pentru că nu mai scrii cod, nu mai cauți documentație Oblio ș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 SmartBill, FGO, Startco sau Oblio.
Începe acum
Creează cont Recev gratuit, conectează-ți contul Oblio, 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.
