MCP

MCP dokumentácia

Prepojte AI asistentov a autonómnych agentov s corween. MCP server beží priamo v aplikácii a vystavuje supplier monitoring ako štruktúrované tools.

Čo je MCP?

corween implementuje Model Context Protocol (MCP) server, aby AI asistenti mohli pracovať s monitoringom dodávateľov bez scrapingu verejných registrov.

Namiesto surových REST endpointov MCP vystavuje high-level tools, ktoré model volá priamo:

  • Registrácia organizácie a získanie API tokenu
  • Pridanie, úprava a odstránenie sledovaných dodávateľov (subjektov)
  • Zoznam subjektov a prehľad ich aktuálnych rizikových udalostí
  • Dotazovanie na monitoring eventy naprieč portfóliom s filtrami

Ako to funguje

MCP server je súčasť Spring Boot aplikácie corween — nie samostatná Node.js služba. AI klienti sa pripájajú na rovnaké nasadenie cez HTTP.

MCP tools volajú rovnaké interné služby ako REST API. Pri zmene business logiky build zlyhá, ak MCP tools nie sú synchronizované.

Tok dát
AI klient (Cursor, Claude Desktop, …)
  → MCP cez HTTP (/mcp)
  → CorweenMcpTools (@McpTool)
  → SubjectService / RegistrationService / SubjectEventService
  → PostgreSQL + register fetchers

Pre priamu integráciu systémov bez AI vrstvy použite REST API dokumentáciu.

Pripojenie

Použite Streamable HTTP transport. MCP klient nasmerujte na endpoint /mcp na vašej inštancii {0}.

Endpoint
/mcp
Protokol
Streamable HTTP

Príklad pre Cursor

Pridajte do Cursor MCP nastavení (projekt alebo globálne):

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

Autentifikácia

Registračné tools sú verejné. Všetky subject a event tools vyžadujú rovnaký API token ako REST API. Pošlite ho v HTTP hlavičke Authorization — klient ho forwarduje pri každom tool volaní.

Hlavička
Authorization: Bearer {api_token}

Token získate cez corween_register alebo od administrátora účtu. Token je viazaný na organizačný účet.

Dostupné tools

Každý tool mapuje interné business operácie. Parametre sa validujú rovnako ako pri REST API.

Podporované krajiny pre subjekty: AUSTRIA, BULGARIA, CZECHIA, ESTONIA, GREECE, CROATIA, HUNGARY, LITHUANIA, LATVIA, POLAND, ROMANIA, SLOVAKIA, UKRAINE.

TOOL corween_register

Registrácia účtu

Vytvorí účet a používateľa, odošle overovací e-mail a vráti API token na okamžité použitie.

Autentifikácia nie je potrebná.

TOOL corween_confirm_registration

Potvrdenie registrácie

Aktivuje účet pomocou overovacieho tokenu z registračného e-mailu.

Autentifikácia nie je potrebná.

TOOL corween_list_subjects

Zoznam subjektov

Vráti sledovaných dodávateľov pre autentifikovaný účet. Voliteľné filtre: name, registrationNumber, taxIdentifier, birthDate, type, country, page, resultsPerPage.

Voliteľné parametre

Názov Typ Popis
name string Filter podľa názvu subjektu (čiastočná zhoda).
registrationNumber string Filter podľa IČ / registračného čísla (čiastočná zhoda).
taxIdentifier string Filter podľa IČ DPH (čiastočná zhoda).
birthDate string Filter podľa dátumu narodenia. Formát: YYYY-MM-DD.
type enum Filter podľa typu subjektu. Povolené hodnoty: COMPANY, PERSON.
country enum Kód krajiny. Povolené hodnoty: AUSTRIA, BULGARIA, CZECHIA, ESTONIA, GREECE, CROATIA, HUNGARY, LITHUANIA, LATVIA, POLAND, ROMANIA, SLOVAKIA, UKRAINE.
page number Index stránky (od nuly).
resultsPerPage number Maximálny počet položiek na stránku.
TOOL corween_get_subject

Detail subjektu

Vráti detail subjektu vrátane poznámky a súvisiacich monitoring eventov.

TOOL corween_add_subject

Pridať subjekt

Pridá firmu do monitoringu. Krajina + IČO musia byť v rámci účtu unikátne.

TOOL corween_update_subject

Upraviť subjekt

Upraví poznámku sledovaného subjektu. Krajinu, názov a IČO nie je možné meniť.

TOOL corween_remove_subject

Odstrániť subjekt

Odstráni subjekt a vymaže súvisiace monitoring dáta.

TOOL corween_list_events

Zoznam eventov

Vráti monitoring eventy — detegované zmeny v registroch (insolvencia, vlastníctvo, finančné signály atď.).

Voliteľné parametre

Názov Typ Popis
subjectId number Filter podľa numerického ID subjektu.
country enum Kód krajiny. Povolené hodnoty: AUSTRIA, BULGARIA, CZECHIA, ESTONIA, GREECE, CROATIA, HUNGARY, LITHUANIA, LATVIA, POLAND, ROMANIA, SLOVAKIA, UKRAINE.
page number Index stránky (od nuly).
resultsPerPage number Maximálny počet položiek na stránku.

Typický workflow agenta

  1. Pripojte AI klienta na /mcp s platným API tokenom (alebo zavolajte corween_register).
  2. Potvrďte účet cez e-mail (corween_confirm_registration alebo confirmation link).
  3. Pridajte dodávateľov cez corween_add_subject (krajina, názov, IČO).
  4. Pollujte corween_list_events alebo corween_get_subject kvôli novým rizikám.
  5. Nechajte agenta sumarizovať nálezy, pripraviť alerty alebo upraviť poznámky cez corween_update_subject.