Serwer MCP

Daj Claude, Cursor lub dowolnemu agentowi AI obsługującemu MCP bezpośredni dostęp do e-fakturowania — waliduj, naprawiaj, generuj i konwertuj unijne faktury prosto z rozmowy, bez osobnej integracji do napisania.

Czym to jest

CrateAPI udostępnia serwer Model Context Protocol (MCP) dla API e-fakturowania — hostowany przez nas albo uruchamiany samodzielnie. Skieruj agenta obsługującego MCP — Claude Desktop, Claude Code, Cursor lub własną pętlę agenta — na niego, a otrzyma cztery narzędzia, które może wywołać bezpośrednio: zwalidować fakturę, naprawić ją, wygenerować ze strukturalnych danych lub przekonwertować między składnią UBL i CII. Agent czyta opisy narzędzi i sam decyduje, kiedy ich użyć; sama logika fakturowania działa na tym samym deterministycznym API, co reszta CrateAPI.

Dostępne narzędzia

Cztery narzędzia, jeden proces. Każde jest proxy do dokładnie tego samego publicznego API, które możesz wywołać przez HTTP — te same reguły, te same limity, te same odpowiedzi.

validate_invoicedarmowe

Sprawdza XML faktury (UBL lub CII) względem oficjalnych reguł EN 16931, Peppol BIS, XRechnung, RO_CIUS i BR-FR. Zwraca ustrukturyzowany raport — poprawna czy nie, liczba błędów/ostrzeżeń, znaleziska. Nie wymaga klucza API.

repair_invoicewymaga klucza API

Automatyczna naprawa na zasadzie najlepszego wysiłku: poprawia formaty dat inne niż ISO i sumy, które się nie zgadzają, przeliczone na nowo z pozycji faktury. Nigdy nie wymyśla brakujących danych biznesowych — zgłasza, co udało się naprawić, a czego nie.

generate_invoicewymaga klucza API

Buduje zgodny XML faktury (UBL lub CII) ze strukturalnego modelu faktury w JSON — sprzedawca, nabywca, pozycje, sumy.

convert_invoicewymaga klucza API

Konwertuje fakturę między składnią UBL i CII, bezstratnie albo odrzucona: jeśli czegoś nie da się przekonwertować czysto, operacja kończy się błędem z jasnym powodem zamiast po cichu tracić dane.

Jak go uruchomić

Dwa sposoby połączenia — te same cztery narzędzia w obu przypadkach.

Hostowany endpoint

Dodaj URL bezpośrednio do konfiguracji swojego klienta MCP. Nic do zainstalowania, nic do utrzymywania w działaniu. validate_invoice działa bez żadnego klucza; pozostałe trzy odczytują nagłówek X-API-Key.

{"mcpServers": {"crateapi-einvoicing": {
    "type": "http", "url": "https://api.crateapi.com/mcp",
    "headers": {"X-API-Key": "your-key-here"}}}}

Dokładne nazwy pól type/url/headers różnią się nieco między klientami MCP (Claude Desktop, Claude Code, Cursor…) — dostosuj do swojego. Walidacja przez hostowany endpoint bez klucza jest ograniczona fair-use per IP, tak samo jak darmowy walidator na stronie (10/min · 50/dzień · 200/miesiąc); ważny klucz API znosi ten limit i podlega wtedy limitowi Twojego planu.

Samodzielnie hostowany

Wolisz uruchomić go samodzielnie — ze względu na prywatność, środowisko odizolowane (air-gapped) albo lokalny rozwój? To wciąż pojedynczy proces Pythona, wywołujący to samo produkcyjne API Twoim własnym kluczem:

{"mcpServers": {"crateapi-einvoicing": {
    "command": "python", "args": ["-m", "einvoicing.mcp_server"],
    "env": {"EINVOICE_API_KEY": "your-key-here"}}}}

validate_invoice nie wymaga w ogóle klucza. Pozostałe trzy odczytują EINVOICE_API_KEY ze środowiska — zdobądź go na stronie cennika. EINVOICE_API_BASE może nadpisać docelowe API, przydatne przy wskazywaniu lokalnej instancji lub środowiska testowego.

Oba są prawdziwe. Hostowany endpoint uruchamia dokładnie ten sam kod narzędzi co proces samodzielnie hostowany — te same reguły, te same limity, te same odpowiedzi. Użyj hostowanego URL-a dla zerowej konfiguracji albo self-hostingu dla pełnej lokalnej kontroli.

Dlaczego to ważne

Agenci AI coraz częściej tworzą, sprawdzają i składają dokumenty biznesowe. Jeśli Twój może wywoływać te narzędzia bezpośrednio, może zwalidować fakturę zanim zostanie wysłana, albo wygenerować zgodną na żądanie — zamiast pomylić format i dowiedzieć się o tym dopiero po kilku dniach z odrzucenia. Silnik stojący za narzędziami jest tym samym, co stoi za resztą CrateAPI — deterministyczny, zero LLM w czasie działania (zobacz Trust & Security) — agent decyduje, kiedy wywołać narzędzie, same reguły faktury pozostają oparte na regułach, nigdy nie są zgadywane.

Chcesz sprawdzić sam?

Każde narzędzie powyżej wywołuje to samo API, które możesz wywołać już dziś — przeczytaj pełną dokumentację lub wypróbuj darmowy walidator z własną fakturą.

Wypróbuj darmowy walidator Przeczytaj dokumentację

Zwaliduj e-fakturę za darmoBez rejestracji. Wklej lub prześlij, raport natychmiast.

Otwórz walidator →