MCP

MCP dokumentace

Propojte AI asistenty a autonomní agenty s corween. MCP server běží přímo v aplikaci a vystavuje supplier monitoring jako strukturované tools.

Co je MCP?

corween implementuje Model Context Protocol (MCP) server, aby AI asistenti mohli pracovat s monitoringem dodavatelů bez scrapingu veřejných registrů.

Místo surových REST endpointů MCP vystavuje high-level tools, které model volá přímo:

  • Registrace organizace a získání API tokenu
  • Přidání, úprava a odstranění sledovaných dodavatelů (subjektů)
  • Seznam subjektů a přehled jejich aktuálních rizikových událostí
  • Dotazování na monitoring eventy napříč portfoliem s filtry

Jak to funguje

MCP server je součástí Spring Boot aplikace corween — ne samostatná Node.js služba. AI klienti se připojují na stejné nasazení přes HTTP.

MCP tools volají stejné interní služby jako REST API. Při změně business logiky build selže, pokud MCP tools nejsou synchronizované.

Tok dat
AI klient (Cursor, Claude Desktop, …)
  → MCP přes HTTP (/mcp)
  → CorweenMcpTools (@McpTool)
  → SubjectService / RegistrationService / SubjectEventService
  → PostgreSQL + register fetchers

Pro přímou integraci systémů bez AI vrstvy použijte REST API dokumentaci.

Připojení

Použijte Streamable HTTP transport. MCP klienta nasměrujte na endpoint /mcp na vaší instanci {0}.

Endpoint
/mcp
Protokol
Streamable HTTP

Příklad pro Cursor

Přidejte do Cursor MCP nastavení (projekt nebo globálně):

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

Autentizace

Registrační tools jsou veřejné. Všechny subject a event tools vyžadují stejný API token jako REST API. Odešlete ho v HTTP hlavičce Authorization — klient ho forwarduje při každém tool volání.

Hlavička
Authorization: Bearer {api_token}

Token získáte přes corween_register nebo od administrátora účtu. Token je vázaný na organizační účet.

Dostupné tools

Každý tool mapuje interní business operace. Parametry se validují stejně jako u REST API.

Podporované země pro subjekty: AUSTRIA, BULGARIA, CZECHIA, ESTONIA, GREECE, CROATIA, HUNGARY, LITHUANIA, LATVIA, POLAND, ROMANIA, SLOVAKIA, UKRAINE.

TOOL corween_register

Registrace účtu

Vytvoří účet a uživatele, odešle ověřovací e-mail a vrátí API token k okamžitému použití.

Autentizace není potřeba.

TOOL corween_confirm_registration

Potvrzení registrace

Aktivuje účet pomocí ověřovacího tokenu z registračního e-mailu.

Autentizace není potřeba.

TOOL corween_list_subjects

Seznam subjektů

Vrátí sledované dodavatele pro autentizovaný účet. Volitelné filtry: name, registrationNumber, taxIdentifier, birthDate, type, country, page, resultsPerPage.

Volitelné parametry

Název Typ Popis
name string Filtr podle názvu subjektu (částečná shoda).
registrationNumber string Filtr podle IČO / registračního čísla (částečná shoda).
taxIdentifier string Filtr podle DIČ (částečná shoda).
birthDate string Filtr podle data narození. Formát: YYYY-MM-DD.
type enum Filtr podle typu subjektu. Povolené hodnoty: COMPANY, PERSON.
country enum Kód země. 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ální počet položek na stránku.
TOOL corween_get_subject

Detail subjektu

Vrátí detail subjektu včetně poznámky a souvisejících monitoring eventů.

TOOL corween_add_subject

Přidat subjekt

Přidá firmu do monitoringu. Země + IČO musí být v rámci účtu unikátní.

TOOL corween_update_subject

Upravit subjekt

Upraví poznámku sledovaného subjektu. Zemi, název a IČO není možné měnit.

TOOL corween_remove_subject

Odstranit subjekt

Odstraní subjekt a vymaže související monitoring data.

TOOL corween_list_events

Seznam eventů

Vrátí monitoring eventy — detekované změny v registrech (insolvence, vlastnictví, finanční signály atd.).

Volitelné parametry

Název Typ Popis
subjectId number Filtr podle numerického ID subjektu.
country enum Kód země. 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ální počet položek na stránku.

Typický workflow agenta

  1. Připojte AI klienta na /mcp s platným API tokenem (nebo zavolejte corween_register).
  2. Potvrďte účet přes e-mail (corween_confirm_registration nebo confirmation link).
  3. Přidejte dodavatele přes corween_add_subject (země, název, IČO).
  4. Pollujte corween_list_events nebo corween_get_subject kvůli novým rizikům.
  5. Nechte agenta shrnout nálezy, připravit alerty nebo upravit poznámky přes corween_update_subject.