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. 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ć

Samodzielnie hostowany, działa już dziś z Twoim własnym kluczem API. Dodaj to do konfiguracji swojego klienta MCP — Claude Desktop, Claude Code, Cursor lub dowolnego innego agenta obsługującego MCP:

{"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.

Samodzielnie hostowany, na razie. Nie ma jeszcze hostowanego punktu końcowego mcp.crateapi.com — uruchamiasz serwer samodzielnie, jeden proces Pythona (python -m einvoicing.mcp_server), który wywołuje to samo produkcyjne API Twoim własnym kluczem. Jeśli pojawi się wystarczające zapotrzebowanie na hostowaną wersję, zbudujemy ją; na razie to uczciwy stan rzeczy.

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ę