MCP

Dokumentacja MCP

Połącz asystentów AI i autonomicznych agentów z corween. Serwer MCP działa bezpośrednio w aplikacji i udostępnia monitoring dostawców jako ustrukturyzowane tools.

Czym jest MCP?

corween implementuje serwer Model Context Protocol (MCP), aby asystenci AI mogli pracować z monitoringiem dostawców bez scrapingu publicznych rejestrów.

Zamiast surowych endpointów REST MCP udostępnia high-level tools, które model wywołuje bezpośrednio:

  • Rejestracja organizacji i uzyskanie tokenu API
  • Dodawanie, edycja i usuwanie monitorowanych dostawców (podmiotów)
  • Lista podmiotów i przegląd ich aktualnych zdarzeń ryzyka
  • Odpytywanie zdarzeń monitorowania w całym portfelu z filtrami

Jak to działa

Serwer MCP jest częścią aplikacji Spring Boot corween — nie osobną usługą Node.js. Klienci AI łączą się z tym samym wdrożeniem przez HTTP.

Narzędzia MCP wywołują te same wewnętrzne usługi co REST API. Przy zmianie logiki biznesowej build kończy się niepowodzeniem, jeśli narzędzia MCP nie są zsynchronizowane.

Przepływ danych
Klient AI (Cursor, Claude Desktop, …)
  → MCP przez HTTP (/mcp)
  → CorweenMcpTools (@McpTool)
  → SubjectService / RegistrationService / SubjectEventService
  → PostgreSQL + register fetchers

Do bezpośredniej integracji systemów bez warstwy AI użyj dokumentacji REST API.

Połączenie

Użyj transportu Streamable HTTP. Skieruj klienta MCP na endpoint /mcp na Twojej instancji {0}.

Endpoint
/mcp
Protokół
Streamable HTTP

Przykład dla Cursor

Dodaj do ustawień MCP w Cursor (projekt lub globalnie):

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

Uwierzytelnianie

Narzędzia rejestracyjne są publiczne. Wszystkie narzędzia subject i event wymagają tego samego tokenu API co REST API. Wyślij go w nagłówku HTTP Authorization — klient przekazuje go przy każdym wywołaniu narzędzia.

Nagłówek
Authorization: Bearer {api_token}

Token uzyskasz przez corween_register lub od administratora konta. Token jest powiązany z kontem organizacji.

Dostępne tools

Każde narzędzie mapuje wewnętrzne operacje biznesowe. Parametry są walidowane tak samo jak w REST API.

Obsługiwane kraje dla podmiotów: AUSTRIA, BULGARIA, CZECHIA, ESTONIA, GREECE, CROATIA, HUNGARY, LITHUANIA, LATVIA, POLAND, ROMANIA, SLOVAKIA, UKRAINE.

TOOL corween_register

Rejestracja konta

Tworzy konto i użytkownika, wysyła e-mail weryfikacyjny i zwraca token API do natychmiastowego użycia.

Uwierzytelnianie nie jest wymagane.

TOOL corween_confirm_registration

Potwierdzenie rejestracji

Aktywuje konto za pomocą tokenu weryfikacyjnego z e-maila rejestracyjnego.

Uwierzytelnianie nie jest wymagane.

TOOL corween_list_subjects

Lista podmiotów

Zwraca monitorowanych dostawców dla uwierzytelnionego konta. Opcjonalne filtry: name, registrationNumber, taxIdentifier, birthDate, type, country, page, resultsPerPage.

Parametry opcjonalne

Nazwa Typ Opis
name string Filtr według nazwy podmiotu (częściowe dopasowanie).
registrationNumber string Filtr według NIP / numeru rejestrowego (częściowe dopasowanie).
taxIdentifier string Filtr według identyfikatora podatkowego (częściowe dopasowanie).
birthDate string Filtr według daty urodzenia. Format: YYYY-MM-DD.
type enum Filtr według typu podmiotu. Dozwolone wartości: COMPANY, PERSON.
country enum Kod kraju. Dozwolone wartości: AUSTRIA, BULGARIA, CZECHIA, ESTONIA, GREECE, CROATIA, HUNGARY, LITHUANIA, LATVIA, POLAND, ROMANIA, SLOVAKIA, UKRAINE.
page number Indeks strony (od zera).
resultsPerPage number Maksymalna liczba pozycji na stronę.
TOOL corween_get_subject

Szczegóły podmiotu

Zwraca szczegóły podmiotu wraz z notatką i powiązanymi zdarzeniami monitorowania.

TOOL corween_add_subject

Dodaj podmiot

Dodaje firmę do monitoringu. Kraj + IČO muszą być unikalne w ramach konta.

TOOL corween_update_subject

Edytuj podmiot

Modyfikuje notatkę monitorowanego podmiotu. Kraju, nazwy i IČO nie można zmieniać.

TOOL corween_remove_subject

Usuń podmiot

Usuwa podmiot i kasuje powiązane dane monitorowania.

TOOL corween_list_events

Lista zdarzeń

Zwraca zdarzenia monitorowania — wykryte zmiany w rejestrach (niewypłacalność, własność, sygnały finansowe itd.).

Parametry opcjonalne

Nazwa Typ Opis
subjectId number Filtr według numerycznego ID podmiotu.
country enum Kod kraju. Dozwolone wartości: AUSTRIA, BULGARIA, CZECHIA, ESTONIA, GREECE, CROATIA, HUNGARY, LITHUANIA, LATVIA, POLAND, ROMANIA, SLOVAKIA, UKRAINE.
page number Indeks strony (od zera).
resultsPerPage number Maksymalna liczba pozycji na stronę.

Typowy workflow agenta

  1. Podłącz klienta AI do /mcp z ważnym tokenem API (lub wywołaj corween_register).
  2. Potwierdź konto przez e-mail (corween_confirm_registration lub confirmation link).
  3. Dodaj dostawców przez corween_add_subject (kraj, nazwa, IČO).
  4. Odpytuj corween_list_events lub corween_get_subject pod kątem nowych ryzyk.
  5. Pozwól agentowi podsumować ustalenia, przygotować alerty lub zaktualizować notatki przez corween_update_subject.