Komenda: mcp

Komenda mcp uruchamia serwer Model Context Protocol, który pozwala asystentom AI (Claude, Cursor) korzystać z ksefnik jako narzędzia.

Użycie

ksefnik mcp [--stdio]

Parametry

Parametr	Wymagany	Opis
`--stdio`	Nie	Użyj transportu stdio (domyślnie)

Działanie

Serwer MCP nasłuchuje na stdin i odpowiada na stdout, zgodnie ze specyfikacją MCP. Proces nie kończy się sam — działa do momentu zamknięcia strumienia wejściowego.

Udostępniane narzędzia MCP:

sync-invoices — synchronizacja faktur z KSeF
import-bank — import wyciągu bankowego
reconcile — uzgadnianie faktur z przelewami
get-unmatched — pobranie nieuzgodnionych pozycji
query-invoices — wyszukiwanie faktur
send-invoice — wysyłka faktury
validate-invoice — walidacja faktury
confirm-match — potwierdzenie dopasowania

Podpięcie do klienta AI

Dodaj do claude_desktop_config.json:

{
  "mcpServers": {
    "ksefnik": {
      "command": "ksefnik",
      "args": ["mcp", "--stdio"],
      "env": {
        "KSEFNIK_NIP": "1234567890",
        "KSEFNIK_TOKEN": "eyJhbGciOi...",
        "KSEFNIK_ENV": "demo"
      }
    }
  }
}

Dodaj do .cursor/mcp.json w projekcie:

{
  "mcpServers": {
    "ksefnik": {
      "command": "ksefnik",
      "args": ["mcp", "--stdio"],
      "env": {
        "KSEFNIK_NIP": "1234567890",
        "KSEFNIK_TOKEN": "eyJhbGciOi..."
      }
    }
  }
}

Dodaj do .claude/settings.json:

{
  "mcpServers": {
    "ksefnik": {
      "command": "ksefnik",
      "args": ["mcp", "--stdio"],
      "env": {
        "KSEFNIK_NIP": "1234567890",
        "KSEFNIK_TOKEN": "eyJhbGciOi..."
      }
    }
  }
}