FGO (Factura Generală Online) este una dintre cele mai populare platforme de facturare din România, cu mii de utilizatori activi. Acum o poți pune să lucreze direct cu agenți AI: conectezi FGO la MCP prin Recev și emiți facturi printr-o singură frază în Claude, Cursor sau orice client MCP.
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 FGO
Recev expune un server MCP unificat care îți permite să emiți facturi prin FGO (și prin orice altă integrare de facturare conectată la Recev) direct din clientul tău AI preferat. Câteva beneficii practice:
- Emiti facturi FGO în limbaj natural — „Fă o factură FGO de 250 lei pentru CUI 12345678″ și factura e în sistem.
- Auto-completare ANAF — denumire, adresă, județ, oraș, RegCom și plătitor TVA, toate preluate automat.
- Validare județ fără diacritice pentru FGO — Recev gestionează nomenclatorul FGO automat (ex. IAŞI vs IASI).
- 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 FGO, Oblio, SmartBill și Startco și alegi la cerere prin care emiti.
Pași de conectare FGO 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 FGO din secțiunea Integrări — vei avea nevoie de username-ul și parola contului tău FGO sau de cheia API.
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ă FGO dintr-un chat
După conectare, îi poți spune AI-ului în limbaj natural:
„Emite o factură prin FGO 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 normaliza județul pentru nomenclatorul FGO și va returna seria, numărul și link-ul PDF al facturii. Total: două secunde de muncă reală.
De ce să folosești MCP în loc de API direct FGO?
Pentru că nu mai scrii cod, nu mai depanezi probleme de nomenclator FGO ș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, SmartBill, Startco sau FGO.
Începe acum
Creează cont Recev gratuit, conectează-ți contul FGO, 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.