RegisterÚZ MCP Server

Co dělá “RÚZ Open API” MCP Server?

RÚZ Open API MCP Server poskytuje veřejný přístup k účetním datům evidovaným na Slovensku prostřednictvím portálu registeruz.sk a zpřístupňuje je ve strojově čitelném formátu JSON. Je navržen pro spojení AI asistentů a vývojářů s Registrem účtovných závierok, čímž zjednodušuje přístup k aktuálním, strukturovaným datům o účetních subjektech, jejich výkazech a souvisejících metadatech. Tento server umožňuje programatické dotazy pro výpis subjektů, získání detailních záznamů, stahování šablon i přístup k oficiálním číselníkům. Díky zpřístupnění těchto zdrojů a služeb umožňuje RÚZ Open API AI workflow zaměřené na compliance, finanční analýzy, integraci dat a další, s podporou přístupu k datům v reálném čase, inkrementálních aktualizací a standardizovaného získávání finančních dat.

Seznam zdrojů

• Zoznam identifikátorov (Seznam ID)
  • Poskytuje seznam identifikátorů různých datových typů (např. účetní subjekty, výkazy) pro další detailní dotazy.
• Detaily entity
  • Vrací detailní atributy daného subjektu podle jeho identifikátoru.
• Číselníky (Katalogy/Registre)
  • Zpřístupňuje oficiální číselníky ze Statistického úřadu Slovenské republiky (ŠÚSR) pro jednotné referencování.
• Šablóny účtovných výkazov (Šablony výkazů)
  • Poskytuje šablony pro různé finanční výkazy za účelem standardizace zadávání a analýzy dat.

Scénáře použití tohoto MCP serveru

• Automatizované získávání finančních výkazů
  • Vývojáři a analytici mohou programaticky přistupovat k aktuálním finančním výkazům slovenských společností, což podporuje audity, due diligence nebo analýzu kreditního rizika.
• Monitoring účetních subjektů
  • Umožňuje v reálném čase nebo plánovaně kontrolovat aktualizace/změny u konkrétních subjektů, což zajišťuje včasné povědomí o nových podáních či opravách.
• Integrace do AI compliance workflow
  • AI asistenti mohou využívat API k obohacení compliance kontrol nebo procesů KYC (Know Your Customer) pomocí oficiálních finančních údajů.
• Synchronizace číselníků
  • Standardizuje referenční data v systémech prostřednictvím programatické aktualizace číselníků používaných ve finančním reportingu či integraci dat.
• Inkrementální sběr dat
  • Podporuje efektivní datové sklady nebo ETL procesy umožněním inkrementálního stahování na základě dat posledních změn.

Jak jej nastavit

Windsurf

1. Ujistěte se, že máte nainstalovaný Node.js a nastavené vývojové prostředí.
2. Najděte svůj konfigurační soubor Windsurf.
3. Přidejte RÚZ Open API MCP Server pomocí následujícího JSON úseku:

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

4. Uložte konfiguraci a restartujte Windsurf.
5. Ověřte připojení přístupem na endpoint MCP serveru.

Claude

1. Nastavte si požadavky (např. Node.js).
2. Otevřete konfigurační soubor Claude MCP.
3. Vložte následující pod sekci mcpServers:

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

4. Uložte a restartujte Claude.
5. Potvrďte dostupnost MCP serveru.

Cursor

1. Připravte své vývojové prostředí s požadovanými závislostmi.
2. Upravte konfigurační soubor Cursor.
3. Přidejte konfiguraci RÚZ Open API MCP serveru:

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

4. Uložte změny a restartujte Cursor.
5. Otestujte integraci MCP.

Cline

1. Ujistěte se, že máte nainstalovány všechny požadavky (Node.js atd.).
2. Najděte a otevřete konfigurační soubor Cline.
3. Přidejte následující položku MCP serveru:

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

4. Uložte a restartujte Cline.
5. Ověřte, že MCP server běží.

Zabezpečení API klíčů

(V dokumentaci nezmíněno; sekce ponechána prázdná.)

Jak tento MCP použít v toky

Použití MCP ve FlowHunt

Pro integraci MCP serverů do vašeho workflow ve FlowHunt nejprve přidejte MCP komponentu do vašeho toku a propojte ji se svým AI agentem:

Klikněte na komponent MCP pro otevření panelu konfigurace. V sekci systémové konfigurace MCP vložte údaje o vašem MCP serveru v tomto JSON formátu:

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

Po konfiguraci má AI agent možnost používat tento MCP jako nástroj se všemi jeho funkcemi a možnostmi. Nezapomeňte změnit “ruz-open-api” na skutečný název vašeho MCP serveru a nahraďte URL adresou vašeho MCP serveru.

Přehled

Náš názor:
Tento MCP je dobře zdokumentovaný pro své API zdroje, ale chybí mu definice nástrojů, šablony promptů a detaily o zabezpečení API klíčů či sampling/roots. Je to silný zdroj dat, ale méně připravený pro přímou integraci do LLM bez dalšího vývoje na straně MCP.

MCP skóre

RÚZ Open API MCP skóre: 4/10
Schopnosti přístupu k datům jsou robustní, ale server postrádá MCP-specifické vlastnosti jako definice nástrojů, sampling, podporu roots a nemá jasné licencování či open-source status. To omezuje jeho využití v AI workflow přímo “out-of-the-box”.