RegisterÚZ MCP Server

Čo robí “RÚZ Open API” MCP Server?

RÚZ Open API MCP Server poskytuje verejný prístup k účtovným dátam evidovaným na Slovensku prostredníctvom portálu registeruz.sk v strojovo čitateľnom formáte JSON. Je navrhnutý na prepojenie AI asistentov a vývojárov s Registrom účtovných závierok, čím zjednodušuje prístup k aktuálnym, štruktúrovaným dátam o účtovných subjektoch, ich výkazoch a súvisiacich metadátach. Tento server uľahčuje programatické dotazy na výpis subjektov, získavanie detailných záznamov, sťahovanie šablón a prístup k oficiálnym číselníkom. Sprístupňovaním týchto zdrojov a služieb umožňuje RÚZ Open API AI riadené workflow pre compliance, finančné analýzy, integráciu dát a ďalšie účely, pričom podporuje prístup k dátam v reálnom čase, inkrementálne aktualizácie a štandardizované získavanie finančných údajov.

Zoznam zdrojov

• Zoznam identifikátorov (ID List)
  • Poskytuje zoznam identifikátorov pre rôzne typy dát (napr. účtovné subjekty, výkazy) na ďalšie detailné dotazy.
• Detaily entity (Entity Details)
  • Vracia detailné atribúty danej entity podľa jej identifikátora.
• Číselníky (Code Lists/Registers)
  • Sprístupňuje oficiálne číselníky zo Štatistického úradu SR (ŠÚSR) pre konzistentné referencovanie.
• Šablóny účtovných výkazov (Report Templates)
  • Poskytuje šablóny rôznych finančných výkazov pre štandardizované zadávanie a analýzu dát.

Použitie tohto MCP servera

• Automatizované získavanie účtovných závierok
  • Vývojári a analytici môžu programaticky pristupovať k aktuálnym účtovným závierkam slovenských firiem, čo podporuje audity, due diligence alebo analýzu úverového rizika.
• Monitorovanie účtovných subjektov
  • Umožňuje kontroly v reálnom čase alebo plánované kontroly zmien pri konkrétnych účtovných subjektoch, čím sa zabezpečí včasné informovanie o nových podaniach alebo opravách.
• Integrácia do AI compliance workflow
  • AI asistenti môžu využiť API na obohatenie compliance kontrol alebo KYC procesov o oficiálne finančné údaje.
• Synchronizácia číselníkov
  • Štandardizuje referenčné dáta naprieč systémami prostredníctvom programatickej aktualizácie číselníkov využívaných vo finančnom reporte či integrácii dát.
• Inkrementálne sťahovanie dát
  • Podporuje efektívne dátové sklady alebo ETL procesy umožnením inkrementálnych sťahovaní podľa dátumu poslednej úpravy.

Ako ho nastaviť

Windsurf

1. Uistite sa, že máte nainštalovaný Node.js a pripravené vývojové prostredie.
2. Nájdite konfiguračný súbor Windsurf.
3. Pridajte RÚZ Open API MCP Server pomocou tohto JSON úryvku:

   {
     "mcpServers": {
       "ruz-open-api": {
         "command": "npx",
         "args": ["@ruz/mcp-server@latest"]
       }
     }
   }
   

4. Uložte konfiguráciu a reštartujte Windsurf.
5. Overte pripojenie prístupom na endpoint MCP servera.

Claude

1. Nastavte požiadavky (napr. Node.js).
2. Otvorte konfiguračný súbor Claude MCP.
3. Vložte nasledujúci úsek pod sekciu mcpServers:

   {
     "mcpServers": {
       "ruz-open-api": {
         "command": "npx",
         "args": ["@ruz/mcp-server@latest"]
       }
     }
   }
   

4. Uložte a reštartujte Claude.
5. Potvrďte dostupnosť MCP servera.

Cursor

1. Pripravte svoje vývojové prostredie s požadovanými závislosťami.
2. Upravte konfiguračný súbor Cursor.
3. Pridajte konfiguráciu RÚZ Open API MCP servera:

   {
     "mcpServers": {
       "ruz-open-api": {
         "command": "npx",
         "args": ["@ruz/mcp-server@latest"]
       }
     }
   }
   

4. Uložte zmeny a reštartujte Cursor.
5. Otestujte MCP integráciu.

Cline

1. Skontrolujte, že sú nainštalované všetky požiadavky (Node.js, atď.).
2. Nájdite a otvorte konfiguračný súbor Cline.
3. Pridajte nasledujúci MCP server záznam:

   {
     "mcpServers": {
       "ruz-open-api": {
         "command": "npx",
         "args": ["@ruz/mcp-server@latest"]
       }
     }
   }
   

4. Uložte a reštartujte Cline.
5. Overte, že MCP server beží.

Zabezpečenie API kľúčov

(Nie je uvedené v dokumentácii; sekcia ponechaná prázdna.)

Ako používať tento MCP vo flow

Použitie MCP vo FlowHunt

Ak chcete integrovať MCP servery do svojho FlowHunt workflow, začnite pridaním MCP komponentu do svojho flow a prepojením s AI agentom:

Kliknite na MCP komponent pre otvorenie panelu konfigurácie. V sekcii systémovej MCP konfigurácie vložte detaily vášho MCP servera v tomto JSON formáte:

{
  "ruz-open-api": {
    "transport": "streamable_http",
    "url": "https://www.registeruz.sk/cruz-public/home/api"
  }
}

Po nakonfigurovaní môže AI agent používať tento MCP ako nástroj so všetkými jeho funkciami a možnosťami. Nezabudnite zmeniť “ruz-open-api” na skutočný názov vášho MCP servera a URL adresu nahradiť vlastnou adresou MCP servera.

Prehľad

Náš názor:
Tento MCP má dobre zdokumentované API zdroje, ale chýbajú mu definície nástrojov, šablóny promptov a detaily o zabezpečení API kľúčov či vzorkovaní/roots. Je to silný zdroj dát, no menej pripravený na okamžité využitie v LLM bez ďalšieho vývoja na strane MCP.

MCP skóre

RÚZ Open API MCP skóre: 4/10
Hoci schopnosti prístupu k dátam sú robustné, serveru chýbajú MCP špecifické funkcie ako definície nástrojov, vzorkovanie a podpora roots a nemá jasnú licenciu ani signály open-source. To obmedzuje jeho okamžitú využiteľnosť v AI workflow.