RÚZ MCP-Server registrieren

Was macht der “RÚZ Open API” MCP Server?

Der RÚZ Open API MCP Server ermöglicht den öffentlichen Zugriff auf Buchhaltungsdaten, die in der Slowakei über das Portal registeruz.sk registriert sind, und stellt diese in einem maschinenlesbaren JSON-Format bereit. Er wurde entwickelt, um KI-Assistenten und Entwicklern eine Verbindung zum Register účtovných závierok (Register der Finanzabschlüsse) zu ermöglichen und bietet einen schnellen Zugang zu aktuellen, strukturierten Daten zu Buchhaltungseinheiten, deren Abschlüssen und zugehörigen Metadaten. Dieser Server unterstützt programmatische Abfragen zur Auflistung von Einheiten, zum Abrufen detaillierter Datensätze, Herunterladen von Vorlagen und zum Zugriff auf offizielle Codesammlungen. Durch die Bereitstellung dieser Ressourcen ermöglicht die RÚZ Open API KI-gesteuerte Workflows für Compliance, Finanzanalysen, Datenintegration und mehr und unterstützt Echtzeit-Datenzugriff, inkrementelle Updates und standardisierte Finanzdatenabfrage.

Ressourcenübersicht

• Zoznam identifikátorov (ID-Liste)
  • Stellt eine Liste von Kennungen für verschiedene Datentypen (z.B. Buchhaltungseinheiten, Abschlüsse) zur Verfügung, um Detailabfragen zu ermöglichen.
• Detaily entity (Entitätsdetails)
  • Liefert detaillierte Attribute einer bestimmten Einheit anhand ihrer Kennung.
• Číselníky (Codesammlungen/Register)
  • Stellt offizielle Codesammlungen bereit, die vom Statistischen Amt der Slowakischen Republik (ŠÚSR) stammen, und sorgt so für konsistente Referenzierung.
• Šablóny účtovných výkazov (Berichtsvorlagen)
  • Bietet Vorlagen für verschiedene Finanzberichte, um die Dateneingabe und Analyse zu standardisieren.

Anwendungsfälle dieses MCP-Servers

• Automatisierte Abfrage von Finanzabschlüssen
  • Entwickler und Analysten können Finanzabschlüsse slowakischer Unternehmen programmatisch und aktuell abfragen – etwa für Audits, Due-Diligence oder Bonitätsprüfungen.
• Überwachung von Buchhaltungseinheiten
  • Ermöglicht Echtzeit- oder geplante Prüfungen auf Updates/Änderungen bei bestimmten Buchhaltungseinheiten und sorgt so für zeitnahe Information über neue Meldungen oder Korrekturen.
• Integration in KI-gestützte Compliance-Workflows
  • KI-Assistenten können die API nutzen, um Compliance-Prüfungen oder KYC-Prozesse (Know Your Customer) mit offiziellen Finanzdaten anzureichern.
• Synchronisierung von Codesammlungen
  • Standardisiert Referenzdaten in Systemen, indem Codesammlungen für Finanzberichte oder Datenintegration programmatisch aktualisiert werden.
• Inkrementelle Datenerfassung
  • Unterstützt effizientes Data Warehousing oder ETL-Prozesse durch inkrementelle Downloads auf Basis von Änderungsdaten.

Einrichtung

Windsurf

1. Stellen Sie sicher, dass Node.js und Ihre Entwicklungsumgebung eingerichtet sind.
2. Lokalisieren Sie Ihre Windsurf-Konfigurationsdatei.
3. Fügen Sie den RÚZ Open API MCP Server mit folgendem JSON-Snippet hinzu:

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

4. Speichern Sie die Konfiguration und starten Sie Windsurf neu.
5. Überprüfen Sie die Verbindung, indem Sie den MCP-Server-Endpunkt aufrufen.

Claude

1. Richten Sie die Voraussetzungen ein (z.B. Node.js).
2. Öffnen Sie die Claude MCP-Konfigurationsdatei.
3. Fügen Sie Folgendes unter dem Abschnitt mcpServers ein:

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

4. Speichern Sie und starten Sie Claude neu.
5. Bestätigen Sie die Verfügbarkeit des MCP-Servers.

Cursor

1. Bereiten Sie Ihre Entwicklungsumgebung mit den erforderlichen Abhängigkeiten vor.
2. Bearbeiten Sie die Cursor-Konfigurationsdatei.
3. Fügen Sie die RÚZ Open API MCP Server-Konfiguration hinzu:

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

4. Speichern Sie die Änderungen und starten Sie Cursor neu.
5. Testen Sie die MCP-Integration.

Cline

1. Stellen Sie sicher, dass alle Voraussetzungen (Node.js etc.) installiert sind.
2. Suchen und öffnen Sie die Cline-Konfigurationsdatei.
3. Fügen Sie folgenden MCP-Server-Eintrag hinzu:

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

4. Speichern Sie und starten Sie Cline neu.
5. Validieren Sie, dass der MCP-Server läuft.

Absicherung von API-Keys

(In der Dokumentation nicht erwähnt; Abschnitt bleibt leer.)

Nutzung dieses MCP innerhalb von Flows

MCP in FlowHunt verwenden

Um MCP-Server in Ihren FlowHunt-Workflow zu integrieren, fügen Sie zunächst die MCP-Komponente in Ihren Flow ein und verbinden Sie diese mit Ihrem KI-Agenten:

Klicken Sie auf die MCP-Komponente, um das Konfigurationspanel zu öffnen. Im Bereich System-MCP-Konfiguration tragen Sie die Details Ihres MCP-Servers in folgendem JSON-Format ein:

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

Nach der Konfiguration kann der KI-Agent diesen MCP als Tool verwenden und hat Zugriff auf alle Funktionen und Möglichkeiten. Denken Sie daran, “ruz-open-api” durch den tatsächlichen Namen Ihres MCP-Servers zu ersetzen und die URL an Ihre MCP-Server-URL anzupassen.

Übersicht

Unsere Einschätzung:
Dieser MCP ist für seine API-Ressourcen gut dokumentiert, es fehlen jedoch Tool-Definitionen, Prompt-Vorlagen und Details zur Absicherung von API-Keys oder Sampling/Roots. Als Datenquelle stark, aber ohne weitere MCP-seitige Entwicklung weniger als sofort einsatzbereite LLM-Integration geeignet.

MCP Score

RÚZ Open API MCP Score: 4/10
Die Datenzugriffsfunktionen sind zwar robust, jedoch fehlen MCP-spezifische Features wie Tool-Definitionen, Sampling und Roots-Support sowie eine klare Lizenzierung oder Open-Source-Signale. Das schränkt den unmittelbaren Nutzen für KI-Workflows ein.