KSeF API → MCP
KSeF jako bezpieczny konektor dla ChatGPT i Claude.
Read-only wrapper na API KSeF: 27 typowanych operacji odczytowych, OAuth i certyfikaty przypisane do zalogowanego użytkownika.
KSeF MCP
tool ksef_query_invoice_metadatacompanyId 8c1…2easubjectType Subject2✓ Dane pobrane z KSeF
Klient AIChatGPT / Claude
→KonektorKSeF MCP
→SilnikKSeF Core
→SystemAPI KSeF
Cienka warstwa MCP
Pełny odczyt KSeF bez mieszania logiki biznesowej.
KSeF MCP tłumaczy intencję klienta AI na operację Core. Nie generuje paczek, nie tworzy PDF i nie omija autoryzacji właściciela.
Streamable HTTP
Jeden endpoint dla zgodnych klientów MCP.
Po autoryzacji klient odkrywa dostępne narzędzia, wybiera firmę przez list_companies i wywołuje operację KSeF.
Endpoint KSeF MCP
https://ksef-mcp-five.vercel.app/ksef/mcpTransport: Streamable HTTP · Dostęp: OAuthDwie warstwy, dwa zastosowania
KSeF MCP to silnik narzędzi. KSeF Paczki to gotowe zadanie.
ObszarKSeF MCPKSeF Paczki
CelOgólny odczyt API KSeFMiesięczne dokumenty dla księgowości
WynikDane i statusy KSeFXML, PDF, CSV i ZIP
OdbiorcaDeweloperzy i agenci AIFirmy i księgowość
Najczęstsze pytania
KSeF MCP — pytania i odpowiedzi.
Czym jest KSeF MCP?
To techniczny konektor, który przedstawia operacje odczytowe API KSeF jako typowane narzędzia protokołu Model Context Protocol dla ChatGPT, Claude i innych klientów MCP.
Czy KSeF MCP może wysyłać lub zmieniać faktury?
Nie. Obecna warstwa KSeF MCP jest read-only i opakowuje operacje odczytowe. Operacje zapisujące wymagają osobnego projektu, kontroli ryzyka i świadomej autoryzacji.
Czy KSeF MCP tworzy PDF i ZIP?
Nie. PDF, CSV i ZIP są funkcjami produktu KSeF Paczki. KSeF MCP pozostaje cienkim klientem wspólnego silnika KSeF Core.
Jak wygląda uwierzytelnienie?
Użytkownik loguje się przez OAuth, wybiera własną firmę, a Core dopiero po sprawdzeniu właściciela odszyfrowuje certyfikat i tworzy krótkotrwałą sesję z KSeF.