Problem
Faktury zakupowe leżą w KSeF, a praca na nich — znaleźć fakturę za miesiąc, przekazać zestawienie księgowej, sprawdzić, co przyszło od ostatniego razu — dzieje się gdzie indziej. Darmowa aplikacja Ministerstwa nie powie, które faktury są nowe, a zdalne serwery MCP przepuszczają dokumenty i uwierzytelnienie przez cudzą usługę.
Jak to rozwiązujemy
- Lokalnie. Klient MCP uruchamia serwer przez
uvx; archiwum XML zostaje na Twoim dysku. - Token w keyringu. Poświadczenia trafiają do systemowego magazynu kluczy, nie do pliku konfiguracyjnego.
- Domyślnie środowisko testowe. Produkcja wymaga świadomego wyboru.
- Oszczędnie z limitami. Z narzędzi MCP do KSeF sięga tylko synchronizacja; po odmowie z powodu limitu nic nie ponawia samo.
Instalacja w trzech krokach
Potrzebujesz tylko
uv
— jedno polecenie instalacyjne dla Windows, macOS i Linuksa; to z niego
pochodzi uvx.
-
uvx ksef-mcp onboardingNIP, token KSeF, środowisko, katalog roboczy i rejestracja w Claude Code. -
uvx ksef-mcp verifyPotwierdza połączenie i pokazuje ostatnie faktury. -
„Zsynchronizuj faktury z KSeF”Poproś agenta — resztę robią narzędzia MCP.
Wymaga Pythona 3.13 (pobiera go uv). Node jest potrzebny
wyłącznie do PDF-ów — bez niego działa wszystko poza nimi.
Narzędzia MCP
| Narzędzie | Co robi | Sięga do KSeF |
|---|---|---|
synchronise_invoices | pobiera, odszyfrowuje i archiwizuje nowe paczki faktur | tak |
review_new_invoices | pokazuje faktury, które przyszły od ostatniego przeglądu | nie |
list_recent_invoices | listuje metadane faktur z ostatnich trzydziestu dni | nie |
export_period_statement | zapisuje faktury zakupowe za miesiąc jako CSV dla księgowej | nie |
render_invoice_pdf | zapisuje zarchiwizowaną fakturę jako PDF generatorem Ministerstwa | nie |
server_info | zwraca nazwę i wersję serwera | nie |
Dla kogo
Dla użytkownika technicznego: instalacja wymaga terminala. Dziś obsługujemy jeden podmiot i faktury zakupowe w trybie odczytu; faktury sprzedażowe i biura rachunkowe z wieloma podmiotami są w planie prac. Wysyłka faktur jest świadomie poza zakresem.