MCP

MCP-Dokumentation

Verbinden Sie KI-Assistenten und autonome Agenten mit corween. Der MCP-Server läuft in der Anwendung und stellt Supplier Monitoring als strukturierte Tools bereit.

Was ist MCP?

corween implementiert einen Model Context Protocol (MCP) Server, damit KI-Assistenten mit Supplier Monitoring arbeiten können, ohne öffentliche Register zu scrapen.

Statt roher REST-Endpunkte stellt MCP High-Level-Tools bereit, die das Modell direkt aufrufen kann:

  • Organisation registrieren und API-Token erhalten
  • Überwachte Lieferanten (Subjekte) hinzufügen, aktualisieren und entfernen
  • Subjekte auflisten und aktuelle Risikoereignisse einsehen
  • Monitoring-Ereignisse im Portfolio mit Filtern abfragen

Funktionsweise

Der MCP-Server ist Teil der corween Spring Boot Anwendung — kein separater Node.js-Dienst. KI-Clients verbinden sich über HTTP mit demselben Deployment.

MCP-Tools rufen dieselben internen Services wie die REST-API auf. Bei Änderungen der Business-Logik schlägt der Build fehl, wenn MCP-Tools nicht synchron sind.

Datenfluss
KI-Client (Cursor, Claude Desktop, …)
  → MCP über HTTP (/mcp)
  → CorweenMcpTools (@McpTool)
  → SubjectService / RegistrationService / SubjectEventService
  → PostgreSQL + Register-Fetcher

Für direkte Systemintegration ohne KI-Schicht nutzen Sie die REST-API-Dokumentation.

Verbindung

Verwenden Sie Streamable HTTP. Richten Sie Ihren MCP-Client auf den /mcp-Endpunkt Ihrer {0}-Instanz.

Endpunkt
/mcp
Protokoll
Streamable HTTP

Cursor-Beispiel

Fügen Sie dies zu Ihren Cursor MCP-Einstellungen hinzu (Projekt oder global):

Cursor MCP
{
  "mcpServers": {
    "corween": {
      "url": "https://corween.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Authentifizierung

Registrierungs-Tools sind öffentlich. Alle Subject- und Event-Tools benötigen denselben API-Token wie die REST-API. Senden Sie ihn im HTTP-Header Authorization — der Client leitet ihn bei jedem Tool-Aufruf weiter.

Header
Authorization: Bearer {api_token}

Token über corween_register oder vom Kontoadministrator. Der Token ist an Ihr Organisationskonto gebunden.

Verfügbare Tools

Jedes Tool mappt interne Business-Operationen. Parameter werden wie bei REST-API-Anfragen validiert.

Unterstützte Länder für Subjekte: AUSTRIA, BULGARIA, CZECHIA, ESTONIA, GREECE, CROATIA, HUNGARY, LITHUANIA, LATVIA, POLAND, ROMANIA, SLOVAKIA, UKRAINE.

TOOL corween_register

Konto registrieren

Erstellt Konto und Benutzer, sendet E-Mail-Verifizierung und gibt API-Token für sofortige Nutzung zurück.

Keine Authentifizierung erforderlich.

TOOL corween_confirm_registration

Registrierung bestätigen

Aktiviert das Konto mit dem Verifizierungstoken aus der Registrierungs-E-Mail.

Keine Authentifizierung erforderlich.

TOOL corween_list_subjects

Subjekte auflisten

Gibt überwachte Lieferanten für das authentifizierte Konto zurück. Optionale Filter: name, registrationNumber, taxIdentifier, birthDate, type, country, page, resultsPerPage.

Optionale Parameter

Name Typ Beschreibung
name string Filter nach Subjektname (Teilübereinstimmung).
registrationNumber string Filter nach Identifikations-/Registrierungsnummer (Teilübereinstimmung).
taxIdentifier string Filter nach Steuer-ID (Teilübereinstimmung).
birthDate string Filter nach Geburtsdatum. Format: YYYY-MM-DD.
type enum Filter nach Subjekttyp. Erlaubte Werte: COMPANY, PERSON.
country enum Ländercode. Erlaubte Werte: AUSTRIA, BULGARIA, CZECHIA, ESTONIA, GREECE, CROATIA, HUNGARY, LITHUANIA, LATVIA, POLAND, ROMANIA, SLOVAKIA, UKRAINE.
page number Nullbasierter Seitenindex.
resultsPerPage number Maximale Anzahl von Einträgen pro Seite.
TOOL corween_get_subject

Subjekt abrufen

Gibt Subjektdetails inkl. Notiz und zugehöriger Monitoring-Ereignisse zurück.

TOOL corween_add_subject

Subjekt hinzufügen

Fügt ein Unternehmen zum Monitoring hinzu. Land + Registernummer müssen im Konto eindeutig sein.

TOOL corween_update_subject

Subjekt aktualisieren

Aktualisiert die Notiz eines überwachten Subjekts. Land, Name und Registernummer sind unveränderlich.

TOOL corween_remove_subject

Subjekt entfernen

Entfernt ein Subjekt und löscht zugehörige Monitoring-Daten.

TOOL corween_list_events

Ereignisse auflisten

Gibt Monitoring-Ereignisse zurück — erkannte Registeränderungen (Insolvenz, Eigentum, Finanzsignale usw.).

Optionale Parameter

Name Typ Beschreibung
subjectId number Filter nach numerischer Subjekt-ID.
country enum Ländercode. Erlaubte Werte: AUSTRIA, BULGARIA, CZECHIA, ESTONIA, GREECE, CROATIA, HUNGARY, LITHUANIA, LATVIA, POLAND, ROMANIA, SLOVAKIA, UKRAINE.
page number Nullbasierter Seitenindex.
resultsPerPage number Maximale Anzahl von Einträgen pro Seite.

Typischer Agent-Workflow

  1. KI-Client mit gültigem API-Token an /mcp anbinden (oder zuerst corween_register).
  2. Konto per E-Mail bestätigen (corween_confirm_registration oder Bestätigungslink).
  3. Lieferanten mit corween_add_subject hinzufügen (Land, Name, Registernummer).
  4. corween_list_events oder corween_get_subject auf neue Risiken prüfen.
  5. Agent fasst Ergebnisse zusammen, erstellt Alerts oder aktualisiert Notizen via corween_update_subject.