KSeF przez AI: wystawiasz e-fakturę, mówiąc do Claude
KSeF staje się obowiązkowy, a integracja z jego API to koszt i czas. To otwarty serwer MCP do KSeF: prosisz Claude o wystawienie faktury, a on ją tworzy, sprawdza i wysyła do KSeF.
Branża: Księgowość, firmy, integratorzy
W skrócie
- Otwarty serwer MCP do KSeF, kod na GitHubie
- 32 narzędzia: logowanie, wystawianie, walidacja, pobieranie
- Działa w Claude Desktop, Claude Code i ChatGPT
- KSeF API v2, format FA(3), sesje online i batch
O projekcie
KSeF, czyli Krajowy System e-Faktur, staje się obowiązkowy. Firmy muszą wystawiać faktury przez jego API, a to oznacza integrację, tokeny, format XML i sesje. Dla wielu to ściana.
Wyzwanie
Trzeba było sprawić, żeby wystawienie faktury do KSeF było tak proste jak napisanie zdania. Zamiast pisać integrację, prosisz AI, a ona rozmawia z KSeF za Ciebie.
Cele
- Ukryć złożoność API KSeF za prostą rozmową z AI
- Objąć pełny obieg: logowanie, wystawienie, walidacja, pobranie
- Trzymać się oficjalnego formatu FA(3) i API v2
- Zrobić to bezpiecznie: token, JWT i szyfrowana wysyłka
Wyzwania techniczne
Sesje i tokeny KSeF
KSeF wymaga uwierzytelnienia tokenem, sesji online albo batch i JWT. Serwer obsługuje to pod spodem, żeby użytkownik tego nie dotykał.
Zgodność z FA(3)
Faktura musi pasować do schematu FA(3), inaczej KSeF ją odrzuci. Doszła walidacja przed wysyłką, żeby łapać błędy wcześniej.
Bezpieczna wysyłka
Wysyłka faktury jest szyfrowana, a token nie jest nigdzie logowany.
Rozwiązanie i wdrożenie
Mówisz, AI wystawia
Prosisz o fakturę w zwykłym zdaniu. Claude tworzy szkic, waliduje go wedle FA(3) i wysyła do KSeF, a Ty dostajesz numer KSeF i UPO.
Pełny obieg, nie tylko wysyłka
Wyszukanie faktur, pobranie XML, status przetwarzania, obsługa batch i tokenów. Trzydzieści narzędzi pokrywa realną pracę z KSeF.
Rezultaty
Integracja bez integracji
Zamiast tygodni pisania pod API KSeF, wystawiasz fakturę zdaniem w Claude.
Gotowe na obowiązek
Firma i biuro rachunkowe mają narzędzie na czas, gdy KSeF staje się obowiązkowy.
Wnioski
MCP zdejmuje ścianę integracji
Zamiast uczyć każdego API, dajesz AI narzędzia i mówisz po ludzku. To skraca drogę od pomysłu do działania.
Zakres
- Uwierzytelnianie KSeF
- Wystawianie e-faktur
- Walidacja FA(3)
- Pobieranie i status
Technologie
- MCP
- KSeF API v2
- Node.js
- FA(3)
Najczęstsze pytania
Co to jest ten serwer MCP do KSeF?
To narzędzie, które podłącza KSeF do AI. Prosisz Claude albo ChatGPT o wystawienie faktury, a serwer rozmawia z KSeF za Ciebie.
Czy to działa z obowiązkowym KSeF?
Tak. Opiera się o KSeF API v2 i format FA(3), czyli to, co obowiązuje przy wystawianiu e-faktur.
Czy muszę umieć programować?
Do samego wystawiania nie. Podłączasz serwer raz i wystawiasz faktury zwykłym zdaniem w Claude.
Czy to bezpieczne?
Uwierzytelnianie idzie przez token i JWT, a wysyłka faktury jest szyfrowana. Token nie jest nigdzie logowany.
Gdzie jest kod?
Serwer jest publiczny na GitHub i dostępny jako paczka npm, więc można go sprawdzić i uruchomić u siebie.