Sari la conținut

Program de facturare online integrat cu e-Factura & e-Transport

Întrebări frecvente

Înapoi la listă

Cum conectezi orice asistent AI la factureaza.ro prin MCP

Serverul nostru MCP este același pentru toți asistenții. Dacă folosești un client care nu are încă un tab al lui în Integrări — un agent propriu, un IDE sau un asistent pe care încă nu îl listăm — îl conectezi de aici.

Ai două variante. Cheia API merge în orice client MCP și nu cere OAuth; fluxul OAuth 2.1 e pentru clienții care îl preferă.

Pasul 1: copiază URL-ul MCP

Intră în Integrări → MCP generic și apasă Copiază, lângă URL MCP. Adresa este aceeași indiferent de varianta pe care o alegi.

Pagina Integrări → MCP generic din factureaza.ro, cu URL-ul MCP și butonul de copiere

Varianta simplă: cheia API

Orice client MCP poate trimite cheia ta API ca bearer token — fără OAuth și fără credențialele de mai jos. Găsești cheia în Contul meu → API, iar în Detalii tehnice ai și un exemplu gata de rulat.

Detaliile tehnice: exemplul curl cu cheia API și endpointurile OAuth

Varianta OAuth 2.1

Dacă preferi OAuth, completează în Integrări → MCP generic adresa de callback a clientului tău — trebuie să fie https, sau http://localhost pentru un agent care rulează pe calculatorul tău — și apasă butonul de generare. Primești un Client ID și un Client Secret; secretul se afișează o singură dată.

Clientul tău poate descoperi singur restul, de la URL-ul de descoperire (RFC 9728) din aceeași secțiune: endpointul de autorizare și cel de token. Susținem authorization_code cu PKCE (S256) și client_secret_post.

Pasul final: autorizează accesul

La prima conectare, clientul te trimite pe o pagină factureaza.ro care îți arată cu ce cont ești conectat și ce anume urmează să acceseze. Apasă Autorizează.

Pagina factureaza.ro de autorizare, cu butonul Autorizează încercuit

Bine de știut: tokenul de acces expiră după 24 de ore, iar clientul reia fluxul singur. Poți opri oricând accesul din Integrări → MCP generic, cu Dezactivează integrarea.

Înapoi la listă