Conectează Claude sau ChatGPT la datele firmelor din România (server MCP)

Până de curând, dacă voiai ca un asistent AI să știe cine e administratorul unei firme românești sau ce cifră de afaceri a raportat anul trecut, trebuia să copiezi manual datele în conversație. Acum e suficient să conectezi asistentul la serverul MCP FirmeAPI și să întrebi direct: „Verifică firma cu CUI 12345678 — are datorii la ANAF? E în insolvență?". Asistentul apelează singur sursele oficiale și îți răspunde cu date reale, nu din memoria modelului.

Ce este MCP

Model Context Protocol (MCP) este un standard deschis, creat de Anthropic și adoptat inclusiv de OpenAI, prin care asistenții AI se conectează la surse de date și unelte externe. Un „server MCP" expune o listă de tool-uri (funcții) pe care modelul le poate apela în timpul conversației. FirmeAPI rulează un astfel de server la adresa https://www.firmeapi.ro/api/mcp, cu peste 30 de tool-uri acoperind datele firmelor din România: identificare, bilanțuri, administratori, datorii ANAF, insolvență BPI, dosare în instanță, achiziții publice SICAP și altele.

Diferența față de un chatbot obișnuit este fundamentală: modelul nu „își amintește" date despre firme (adesea greșit sau învechit), ci interoghează în timp real aceleași surse pe care le folosește și API-ul REST.

Conectarea în claude.ai (web și desktop)

Claude suportă conectori MCP remote nativ, fără nicio instalare locală:

• Deschide Settings → Connectors în claude.ai;
• Apasă Add custom connector;
• Introdu URL-ul: https://www.firmeapi.ro/api/mcp;
• Claude te redirecționează către FirmeAPI pentru autentificare OAuth — te loghezi cu contul tău și aprobi accesul;
• Gata. În orice conversație nouă, Claude are acces la tool-urile FirmeAPI și le folosește automat când întrebarea o cere.

Serverul MCP este disponibil pentru conturile cu plan Complet, Business sau MCP Unlimited — detalii pe pagina dedicată MCP.

Conectarea în ChatGPT și alte cliente

ChatGPT suportă conectori MCP pentru interogarea surselor externe de date (în funcție de plan): adaugi conectorul din setările ChatGPT, indicând același URL, și parcurgi același flux OAuth de autorizare. Alternativ, serverul FirmeAPI funcționează și cu Custom GPT Actions pe baza aceluiași backend OAuth — poți construi un GPT personalizat („Verificator de firme România") pe care îl folosește toată echipa.

Dincolo de cele două nume mari, orice client compatibil MCP se poate conecta la același endpoint: Claude Desktop, Claude Code, Cursor, Windsurf sau propriul tău agent construit pe un SDK cu suport MCP. Endpoint-ul e unul singur, autentificarea e aceeași, iar tool-urile expuse sunt identice indiferent de client. Instrucțiuni pas cu pas, per client, găsești pe firmeapi.ro/mcp.

Ce poți întreba, concret

Câteva interogări reale pe care le rezolvă un asistent conectat:

• „Cine este administrator la Dedeman SRL și în ce alte firme mai apare?" — folosește tool-urile administratori și administratori_alte_firme;
• „Ce cifră de afaceri și ce profit a avut firma cu CUI 14399840 în ultimii 3 ani?" — bilant_firma;
• „Are firma X datorii la stat sau mențiuni în BPI?" — datorii_anaf + bpi_firma;
• „Găsește-mi firmele de construcții din Cluj cu peste 50 de angajați" — cauta_firma cu filtre;
• „Ce contracte are firma Y cu instituțiile publice?" — sicap;
• „Fă-mi un raport complet de risc pentru CUI 12345678" — asistentul combină singur 5-6 tool-uri și îți livrează sinteza.

Ultimul exemplu e cel mai valoros: nu mai scrii tu codul care agregă sursele — modelul orchestrează apelurile și interpretează rezultatele. Ceea ce în varianta clasică însemna un script care apelează șase endpoint-uri, tratează erorile și formatează un raport devine o singură frază în limbaj natural, cu rezultat în câteva secunde — inclusiv pentru colegii care nu au scris niciodată o linie de cod.

Lista tool-urilor disponibile

Categorie	Tool-uri
Identificare și căutare	cauta_firma, firma, caen_firma, puncte_lucru
Financiar	bilant_firma, bilant_lista
Risc	datorii_anaf, bpi_firma, bpi_cauta, dosare_instanta, dosar_cauta, monitorul_oficial
Persoane	administratori, administratori_alte_firme, cauta_persoana, actionari, actionari_cauta
Contact	date_contact, date_contact_lista
Achiziții publice	sicap
Comerț exterior	importexport, importexport_lista
Licențe și autorizații	licente_arr, transport_alternativ, anre_atestate, anre_licente, anre_licente_gaze

Cum funcționează sub capotă

Pentru cei tehnici: serverul FirmeAPI implementează transportul MCP modern, „streamable HTTP", peste JSON-RPC. Autentificarea folosește OAuth 2.1 cu înregistrare dinamică a clienților — exact fluxul pe care îl așteaptă claude.ai și ChatGPT: clientul descoperă metadatele serverului, se înregistrează, primește token prin authorization code flow cu PKCE, iar tu doar aprobi accesul în browser, o singură dată. La conectare, clientul apelează tools/list și primește definițiile tuturor tool-urilor, cu parametri tipizați și descrieri; de aici încolo, modelul decide singur ce tool să apeleze pentru fiecare întrebare.

Consecința practică: nu scrii nicio linie de cod pentru integrare. Aceeași infrastructură care alimentează API-ul REST servește și MCP, deci datele sunt identice — doar interfața diferă.

Cum obții răspunsuri bune: sfaturi de interogare

• Dă CUI-ul când îl ai. „Firma cu CUI 14399840" elimină orice ambiguitate; căutarea după nume poate returna mai multe firme cu denumiri similare, iar asistentul va trebui să te întrebe care e cea corectă.
• Cere sursa cifrelor. „Spune-mi și anul bilanțului pentru fiecare cifră" te asigură că nu compari mere cu pere — datele financiare au întotdeauna un an de referință.
• Formulează sarcini, nu doar întrebări. Modelele orchestrează bine lanțuri de tool-uri: „compară ultimii 3 ani de bilanț pentru aceste 4 CUI-uri și spune-mi care firmă e cel mai riscant partener" funcționează surprinzător de bine.
• Cere tabele. Pentru comparații multi-firmă, un „prezintă rezultatul ca tabel" face diferența dintre un răspuns citibil și un zid de text.

De ce e mai sigur decât să „întrebi ChatGPT" direct

Un model de limbaj întrebat din memorie despre o firmă românească va răspunde adesea plauzibil și greșit: cifre de afaceri inventate, administratori din articole vechi de presă, confuzii între firme cu nume similare. Cu conectorul MCP, fiecare afirmație factuală vine dintr-un apel către date oficiale, actualizate — modelul devine interfața, nu sursa. Pentru decizii de business (credit, contracte, litigii), diferența nu e cosmetică: e diferența dintre o opinie și o verificare.

Merită totuși păstrate două reflexe: cere întotdeauna CUI-ul în răspuns (ca să confirmi că e firma corectă) și tratează interpretările modelului („firma pare sănătoasă") ca pe un punct de plecare, verificând cifrele-cheie din răspuns înainte de decizii mari.

Cazuri de utilizare pentru echipe

Due diligence conversațional

Juriștii și analiștii de credit pot rula verificarea completă a unui partener („verifică-mi firma asta înainte de contract") într-o singură conversație, fără să deschidă șase portaluri publice. Pașii pe care i-ar automatiza sunt exact cei din ghidul nostru de verificare a firmelor.

Prospecțiune în vânzări

„Găsește distribuitori de materiale de construcții din Timiș cu cifră de afaceri peste 5 milioane, dă-mi datele de contact și administratorii" — o interogare care înlocuiește o zi de research manual.

Agenți AI proprii

Dacă îți construiești propriul agent (pe Claude API, OpenAI sau framework-uri open source), endpoint-ul MCP îți dă acces instant la toate datele fără să implementezi și să întreții 30 de integrări REST separate.

Întrebări frecvente

Consumă întrebările mele credite? Apelurile de tool-uri prin MCP folosesc aceleași surse de date ca API-ul REST, în limitele planului tău; planul MCP Unlimited este gândit exact pentru utilizare conversațională intensivă, fără să numeri apelurile.

Vede Anthropic sau OpenAI datele mele de cont? Nu. Autorizarea OAuth acordă clientului un token limitat la tool-urile MCP; parola și datele contului rămân la FirmeAPI, iar accesul poate fi revocat oricând din cont.

Merge și în aplicațiile mobile? Conectorii adăugați în claude.ai sunt disponibili în conversațiile tale pe toate platformele pe care Claude suportă conectori remote, fără configurare suplimentară per dispozitiv.

Începe acum

Creezi cont pe FirmeAPI, activezi un plan cu acces MCP și adaugi conectorul în claude.ai în mai puțin de două minute. Detalii complete, exemple și instrucțiuni per client pe pagina serverului MCP. Dacă preferi integrarea clasică REST, începe cu API-ul gratuit.