# 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](https://ksefka.com/docs/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](https://ksefka.com/docs/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ć

| Operacja | Opis |
| --- | --- |
| Wystawianie faktur | Tworzy fakturę na podstawie opisu tekstowego |
| Przeglądanie faktur | Wyszukuje i pokazuje szczegóły faktur |
| Kontrahenci | Dodaje, edytuje, wyszukuje kontrahentów |
| Produkty | Zarządza katalogiem produktów |
| Kurs NBP | Pobiera aktualny kurs walut |
| Statystyki | Pokazuje podsumowanie miesiąca i dashboard |
| Szablony | Wyświetla dostępne szablony faktur |
| Status zapłaty | Oznacza faktury jako zapłacone |
| Zatwierdzanie | Finalizuje faktury do wysyłki KSeF |

## Ważne

> [!WARNING]
> - 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.