Documentație

Cum folosești serverele din registru, cum le verificăm și cum citești registrul din cod.

Cum conectezi un server

Fiecare pagină de server are configurația gata pentru patru clienți. Serverele remote se adaugă cu adresa lor; cele locale rulează pe calculatorul tău, din pachetul autorului.

Claude Code

claude mcp add --transport http cuisor https://cuisor.ro/mcp

Cursor · .cursor/mcp.json

{ "mcpServers": { "cuisor": { "url": "https://cuisor.ro/mcp" } } }

VS Code · .vscode/mcp.json

{ "servers": { "cuisor": { "type": "http", "url": "https://cuisor.ro/mcp" } } }

Claude Desktop / claude.ai: Setări, Connectors, Add custom connector, apoi lipești adresa serverului. Pentru serverele cu OAuth, login-ul se face în fereastra vendorului.

Cum verificăm

În fiecare zi, un job automat ia la rând tot catalogul:

  • Servere remote. Trimitem initialize, apoi tools/list, peste Streamable HTTP. 200 înseamnă că răspunde, 401 sau 403 că e viu dar cere cont, orice altceva că nu răspunde.
  • Servere locale. Verificăm pachetul pe npm sau PyPI, sau repository-ul pe GitHub: există, nu e arhivat, când a primit ultima versiune. Nu le rulăm noi.
  • Unelte. Lista de pe fiecare pagină vine din răspunsul live, cu marcajul de citire sau scriere declarat de server. Claude Directory cere marcajul pentru fiecare unealtă.
  • Istoric. Păstrăm ultimele 30 de zile; le vezi pe pagina serverului și pe pagina Stare servere.

Proba se identifică cu agentul registrulmcp-probe/1.0.

API-ul registrului

Fișiere statice, fără cheie, actualizate la fiecare probă:

curl -s https://www.registrulmcp.ro/registry.json | jq '.servers[] | select(.status=="live") | .name'

Registrul ca server MCP

Adaugă registrul în asistentul tău și întreabă-l direct ce server să folosești. Fără cont, doar citire.

claude mcp add --transport http registrulmcp https://www.registrulmcp.ro/mcp

Unelte: search_servers (căutare cu filtre de categorie, țară și stare), get_server (fișa completă și configurația) și list_categories.

Listare și revendicare

Trimite endpoint-ul, pachetul sau repository-ul pe pagina de listare. Îl probăm în aceeași zi. Dacă serverul e al tău și e deja listat, revendică pagina din butonul de pe ea.

Întrebări frecvente

Ce este un server MCP?

Model Context Protocol (MCP) e standardul deschis prin care un asistent AI (Claude, ChatGPT, Cursor, VS Code) se conectează la date și aplicații externe. Un server MCP expune unelte, de exemplu „caută firma după CUI” sau „emite factura”, pe care asistentul le poate folosi singur.

Există un server MCP pentru ANAF sau e-Factura?

Da, mai multe, toate construite de terți: ANAF nu publică un server oficial. Pentru e-Factura și SPV sunt Storno.ro, ts-anaf, anafpy și anaf-efactura-mcp; pentru date publice ANAF (TVA, bilanțuri) sunt cuisor.ro, Companero, HowToRomania și altele. Lista e în categoria Facturare & e-Factura.

Cum verificați serverele?

Zilnic, automat. Fiecărui server remote îi trimitem cererile initialize și tools/list, exact ca un client MCP real, și notăm codul HTTP, timpul de răspuns, versiunea de protocol și uneltele. Pentru serverele locale verificăm că pachetul există pe npm, PyPI sau GitHub și când a primit ultima versiune; nu le rulăm noi.

Registrul trece traficul prin serverele lui?

Nu. Te conectezi direct la serverul vendorului, cu cheia sau contul tău de la vendor. Noi doar listăm, verificăm și generăm configurația.

Cât costă listarea?

Nimic. Listarea și verificarea zilnică sunt gratuite. Dacă ai un API și vrei un server MCP, îl putem construi noi, ca serviciu plătit.

Pot folosi registrul din cod sau dintr-un agent AI?

Da: /registry.json are tot catalogul cu rezultatul probelor, /v0.1/servers urmează formatul registrului oficial MCP, /llms.txt e rezumatul pentru modele AI, iar www.registrulmcp.ro/mcp e un server MCP prin care asistentul tău caută direct în registru.