Dokumentacja

Przewodnik po aplikacji KSeFka

Integracja z AI#

KSeFka potrafi rozmawiać z asystentami AI — takimi jak Claude, ChatGPT czy Cursor. Tworzysz faktury, sprawdzasz statystyki i zarządzasz kontrahentami zwykłym tekstem, bez klikania w formularze.

Jak to działa#

Asystent AI łączy się z KSeFką przez protokół MCP. Działa to jak tłumacz: piszesz po polsku czego potrzebujesz, a AI wykonuje odpowiednie operacje w aplikacji.

Konfiguracja w 2 krokach#

1. Zainstaluj CLI#

Otwórz KSeFkę i przejdź do Ustawienia → CLI. Kliknij Zainstaluj. Zamknij i otwórz ponownie terminal, a następnie sprawdź:

ksefka --version

2. Podłącz asystenta AI#

Najszybsza metoda: Wklej do czatu z AI: https://ksefka.com/llms.txt — asystent sam się skonfiguruje i wyjaśni jak zacząć.

Lub ręcznie — otwórz ustawienia MCP w swoim narzędziu AI i dodaj:

{
  "mcpServers": {
    "ksefka": {
      "command": "ksefka",
      "args": ["mcp"]
    }
  }
}

Szczegóły konfiguracji dla konkretnych narzędzi (Claude Desktop, Cursor i innych) znajdziesz na stronie MCP.

Przykłady użycia#

Po podłączeniu KSeFki napisz do asystenta AI:

„Wystaw fakturę dla firmy ABC sp. z o.o. (NIP 1234567890) na usługę Konsultacje IT za 5000 zł netto, stawka VAT 23%.”
„Ile faktur wystawiłem w tym miesiącu? Jaka jest łączna kwota?”
„Znajdź wszystkie niezapłacone faktury.”
„Dodaj kontrahenta: Jan Kowalski, NIP 9876543210. Wyszukaj dane w GUS.”
„Skopiuj fakturę FV/2026/03/001 jako nową z dzisiejszą datą.”

Co AI może zrobić#

OperacjaOpis
Wystawianie fakturTworzy fakturę na podstawie opisu tekstowego
Przeglądanie fakturWyszukuje i pokazuje szczegóły faktur
KontrahenciDodaje, edytuje, wyszukuje kontrahentów
ProduktyZarządza katalogiem produktów
Kurs NBPPobiera aktualny kurs walut
StatystykiPokazuje podsumowanie miesiąca i dashboard
SzablonyWyświetla dostępne szablony faktur
Status zapłatyOznacza faktury jako zapłacone
ZatwierdzanieFinalizuje faktury do wysyłki KSeF

Ważne#

  • AI pracuje na danych aktywnej firmy i aktywnego środowiska (test / demo / produkcja) — upewnij się, że masz wybrane właściwe środowisko w KSeFce.
  • Zanim wyślesz fakturę do KSeF, zawsze sprawdź ją w aplikacji.
  • AI tworzy faktury jako szkice. Możesz poprosić AI o zatwierdzenie do wysyłki, ale zawsze najpierw sprawdź fakturę w aplikacji. Faktury zatwierdzone do wysyłki trafiają do KSeF automatycznie przy najbliższej synchronizacji.