Mcp-Ksef
KSeF MCP Simple Server
Links
README
From the repo.
MCP KSeF Server
To jest serwer MCP dla KSeF - Krajowy System e-Faktur to platforma do wystawiania, przesyłania, otrzymywania i przechowywania faktur.
Połączenie do KSeF wymaga wygenerowania tokenu lub certyfikatu. Obie metody są wspierane przez ten serwer MCP.
Serwer MCP w rozwoju. Na razie działa tylko pobieranie faktur. Będą dodawane nowe funkcje.
Spis treści
- Jak uruchomić jako Docker
- Jak uruchomić klienta Visual Studio Code
- Jak uruchomić klienta Cloud Desktop
- Przykłady użycia
- Punkty dostępu
- Instalacja z kodu
Co zawiera
Instrukcje dla KSeF
| Opis | Uzycie |
|---|---|
| Pobranie faktury w XML na podstawie numeru KSeF | #get_invoice_by_ksef |
| Pobiera listę faktur z podanego okresu z systemu ksef oraz InvoiceSubjectType (domyślnie Subject1=wystawca), DateType (domyślnie IssueData=data wystawienienia fv) | #query_invoices |
| Pobiera fakturę o podanym numerze faktury (*) | #get_invoice_by_invoice_number |
| Pobierz faktury dla kupującego o numerze NIP (*) | #get_invoices_for_buyer_by_nip |
| Pobierz faktury dla kupującego o numerze VAT UE (*) | #get_invoices_for_buyer_by_vateu |
| Pobierz link do faktury po numerze ksef | #get_invoice_url_by_ksef |
| Pobierz QR kod do faktury po numerze ksef | #get_invoice_qr_ksef |
(*) repozytorium KSeF ma ograniczenie na zwrot listy faktur do maksymalnie 3 miesiące wstecz
Jak użyć
Użyj podobnego opisu lub użyj bezpośrednio nazwy w celu wywołania pożądanej funkcji.
Np.
Pobierz fakturę o numerze referencyjnym 5242764991-20260131-01002063FA88-AD i pokaż dane identyfkacyjne podmiotu2 oraz number faktury
Lub bezpośrednio
#get_invoice_by_invoice_number "FV 2026/1/31/754149652576"
Przykład
Przykład użycia połączenia do KSeF w kliencie Claude Desktop
Collected info
- ★ 23 stars
- ⎇ 1 forks
- Language: C#
- Source updated: 9/22/2026
Config for your environment
Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.
Tool
OS
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "{MCP_ENDPOINT_URL}"
}
}
}Paste into mcpServers in the config file. Restart Cursor after saving.
If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.