Companero

npx add-mcp 'https://companero.ro/mcp'

Companero × AI

Conectează 2,7 milioane de firme românești la asistentul tău preferat. Întreabă în limbaj natural - Claude, ChatGPT și Cursor caută, compară și interpretează datele direct din ONRC, ANAF și Ministerul Finanțelor.

https://companero.ro/mcp

Funcționează anonim OAuth 2.1 + PKCE Zero cod de scris Streamable HTTP

Trei pași până la prima întrebare

Aceeași secvență în Claude, ChatGPT, Cursor sau orice client compatibil MCP.

1

Copiezi URL-ul

Un singur URL de mai sus - funcționează în toți clienții MCP. Nu trebuie să generezi cheie sau să configurezi nimic.

2

Lipești în clientul AI

În Claude: Settings → Connectors. În ChatGPT: Apps cu Developer Mode. Click Connect și conectorul devine activ.

3

Întrebi în română

"Care sunt cele mai mari firme IT din Cluj?", "Profilul firmei cu CUI X", "Top retaileri pe județ" - și AI-ul răspunde cu date reale.

Configurare pas cu pas

Instrucțiuni dedicate pentru cei doi cei mai folosiți clienți MCP.

Claude

Free / Pro / Team / Enterprise - toate planurile suportă conectori custom

1

Deschide Settings → Connectors

Click pe avatarul tău în Claude → Settings → tab-ul Connectors. Pe Team/Enterprise, owner-ul organizației îl adaugă din Organization settings → Connectors ca să fie disponibil tuturor.

2

Apasă Add custom connector

Lipește URL-ul Companero în câmpul de URL și dă-i un nume (ex. "Companero"). Lasă restul setărilor implicite - descoperirea e automată.

3

Click Connect

Conectorul devine instant activ pentru tool-urile gratuite. Când conversația cere ceva premium (reprezentanți legali, Analiză firmă), Claude deschide o pagină de autorizare unde te conectezi cu contul Companero - un click și revii în chat.

Folosește în orice conversație

Activează conectorul din meniul de tools al conversației. Tools-urile Companero apar lângă cele native ale Claude.

ChatGPT

Plus / Pro / Team / Enterprise - necesită Developer Mode din browser

1

Activează Developer Mode

Deschide chatgpt.com în browser (nu funcționează din apps native încă). Mergi la Settings → Apps → Advanced și pornește Developer Mode.

2

Creează aplicația MCP

În Settings → Apps, apasă Create app. Alege Remote MCP server ca tip și lipește URL-ul Companero.

3

Confirmă autorizarea

ChatGPT detectează automat că serverul folosește OAuth, te trimite pe pagina de autorizare Companero, iar după confirmare returnează tokenul. Aplicația apare în lista de tools.

Folosește în Developer Mode

În chat-uri noi, alege Developer Mode din meniul de tools (icon-ul cu uneltele). Companero va răspunde la întrebări despre firme.

Cursor, Zed, Claude Desktop și alți clienți

Cursor / Zed / Windsurf: adaugă URL-ul în ~/.cursor/mcp.json (sau echivalent). Aceleași opțiuni - anonim sau OAuth.

Claude Desktop (versiunea desktop care nu suportă HTTP direct): folosește proxy-ul oficial mcp-remote:

{
  "mcpServers": {
    "companero": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://companero.ro/mcp"]
    }
  }
}

Pentru clienți care nu suportă OAuth interactiv, generezi o cheie din Account → Chei API și o adaugi cu --header Authorization:Bearer cmpk_....

Ce poți întreba

Exemple reale - copiază prompt-ul și încearcă-l direct în client.

"Top 10 firme IT din Cluj cu cifra de afaceri peste 10M lei."

list_industries search_companies

AI-ul rezolvă "IT" la industria corectă, filtrează pe Cluj + cifră, returnează listă cu nume, CUI, cifră.

"Profilul firmei cu CUI 37418771 - istoric financiar pe ultimii 3 ani."

get_company get_balance_sheets

Profilul și bilanțul vin instant, fără cont - indicatori financiari per an.

"Câte firme noi s-au înființat în Brașov anul acesta în construcții?"

search_companies

Filtrează pe județ + industrie + dată înregistrare. Returnează totalCount + eșantion.

"Compară top 5 retaileri din România pe profit net."

list_industries search_companies

Caută retailerii, sortează după profit și îl arată pe fiecare rând, ca tabelul să se poată citi direct.

"Care sunt firmele active în Sectorul 3 din București cu peste 50 angajați?"

search_counties search_companies

Recunoaște "Sectorul 3", deduce județul, filtrează pe firme active și pe numărul de angajați din ultimul bilanț depus.

"Câte firme din industria alimentară au avut creștere de cifră peste 20% în 2024?"

list_industries search_companies

Compară cifra de afaceri între doi ani consecutivi și numără firmele peste pragul cerut. Pragul e la alegere, nu fix.

Ce e gratis & ce cere autorizare

Toate tool-urile gratuite merg fără cont. Cele cu credite cer doar autorizarea inițială - apoi se consumă din soldul tău.

Tool	Acces	Ce face
search_companies	Anonim · 25/cerere	Caută firme după județ, industrie, CAEN, cifră, dată înregistrare. Multi-filter, sortare.
get_company	Anonim	Profil firmă după CUI - denumire, sediu, CAEN principal, stare, dată înregistrare.
get_balance_sheets	Anonim	Indicatori financiari per an (cifră, profit, datorii, angajați, capital).
list_industries	Anonim	Taxonomie industrii (regrupare CAEN la nivel business).
search_counties / search_cities	Anonim	Lookup județe / localități. (Rar nevoie - celelalte tool-uri acceptă nume direct.)
get_company + include legalRepresentatives	Gratuit, cu cont	Reprezentanții legali activi din ONRC (administratori, directori, reprezentanți), atașați la profilul firmei. Rolurile din procedurile de insolvență sau lichidare vin într-un grup separat. Lista de asociați nu e inclusă - nu o avem în setul deschis ONRC.
get_anaf_debts	Sumar gratis · 100 credite detaliat	Datorii la bugetul de stat (ANAF Restanțieri). Sumarul (are/nu are datorii) e gratuit.
due_diligence	300 credite (15 RON)	„Analiză firmă" - evaluare orientativă pe date publice (profil + financiar + datorii ANAF + administratori). Nu e verdict/bonitate.

Conturile noi primesc 500 de credite gratuit la activare. Vezi tarifele pe pagina de prețuri.

Întrebări frecvente

Răspunsuri scurte la cele mai întâlnite blocaje.