Zaloguj sięWypróbuj za darmo

Integracja · Próba, Studio i Firma

Faktury KSeF w rozmowie z Claude.

Połącz KSeF Canvas z Claude lub Claude Code. Asystent znajdzie kontrahenta i produkt, przygotuje szkic faktury i go sprawdzi. Do KSeF wyśle fakturę dopiero wtedy, gdy potwierdzisz nabywcę, NIP, kwoty i datę.

  1. 01Dodaj serwerW Claude: Settings → Connectors → „Add custom connector”, adres https://api.ksefcanvas.pl/mcp. W Claude Code jedno polecenie w terminalu (poniżej).
  2. 02Zaloguj się i zatwierdźLogujesz się do KSeF Canvas, wybierasz jedną firmę i zakresy. Wystawianie w KSeF nie jest zaznaczone domyślnie. Połączenie zatwierdza tylko właściciel firmy.
  3. 03Pracuj w rozmowieAsystent wyszukuje kontrahentów i produkty, przygotowuje i sprawdza szkice, pokazuje podgląd PDF, stan wystawienia i dokumenty.
  4. 04Odłącz, kiedy chceszPołączenie widzisz w aplikacji: Ustawienia → Integracje → Aplikacje AI. Odłączenie od razu zatrzymuje dostęp asystenta.

Połączenie

Jeden adres, logowanie do KSeF Canvas.

Serwer MCP działa pod adresem https://api.ksefcanvas.pl/mcp. Claude prosi o zalogowanie przy pierwszym użyciu; na ekranie zgody wybierasz firmę i zakresy, a przy pierwszym połączeniu firmy akceptujesz warunki API.

Claude (web, desktop, mobile)

Settings → Connectors → „Add custom connector”. Nazwa: KSeF Canvas, adres: https://api.ksefcanvas.pl/mcp. Następnie „Connect” i logowanie do KSeF Canvas.

Claude Code

claude mcp add --transport http --scope user ksefcanvas https://api.ksefcanvas.pl/mcp, a potem claude mcp login ksefcanvas. Wybierz jeden sposób: konektor z Claude działa też w Claude Code.

W planie Studio lub Firma zamiast logowania możesz użyć klucza API utworzonego w Ustawienia → Integracje → API, przesyłanego jako nagłówek Authorization: Bearer. W aktywnej próbie połącz Claude lub Claude Code przez logowanie — klucze API i webhooki nie są dostępne w próbie.

Narzędzia

Asystent czyta i przygotowuje. Wystawiasz Ty.

Narzędzia odczytu niczego nie zmieniają. Szkic można utworzyć i zmienić, ale do KSeF trafia tylko przez issue_draft: po sprawdzeniu tej samej wersji szkicu i po Twoim potwierdzeniu.

Odczyt

  • get_firm — firma, NIP, środowisko KSeF i zakresy połączenia
  • search_clients, get_client — kontrahenci z kartoteki, po nazwie lub NIP
  • search_products, get_product — produkty i usługi z kartoteki, z ceną, jednostką i stawką VAT
  • list_drafts, get_draft — szkice faktur z pozycjami i sumami
  • validate_draft — sprawdzenie szkicu tym samym walidatorem co w aplikacji
  • preview_draft — podgląd PDF szkicu, bez wysyłki i bez zapisu
  • list_issues, get_issue — wystawione faktury, stan w KSeF i numer KSeF
  • get_issue_document — XML, UPO i PDF przyjętej faktury

Zmiany

  • create_draft, update_draft — tworzy i zmienia szkic; nic nie trafia do KSeF
  • issue_draft — wystawia sprawdzony szkic w KSeF, tylko z zakresem „wystawianie faktur w KSeF” i po Twoim potwierdzeniu nabywcy, NIP, kwot i daty

Asystent nie wykonuje

  • wysyłka e‑maili, usuwanie danych i zmiany w kartotekach
  • klucze, połączenia, webhooki, poświadczenia KSeF, płatności, członkowie zespołu i ustawienia
  • wystawianie szkiców ze sprzedaży Stripe — te wystawiasz w aplikacji
  • cofnięcie faktury przyjętej w KSeF — taką fakturę można tylko skorygować

Połączenie przez logowanie działa od pierwszego dnia aktywnej próby oraz w planach Studio i Firma. Do wystawiania potrzebne jest także zweryfikowane połączenie firmy z KSeF. Asystent może się pomylić — przed potwierdzeniem sprawdź dane faktury. Za treść faktury odpowiada wystawca.

Prywatność i wsparcie

Twoje dane, Twój wybór asystenta.

Dane faktur, kontrahentów i produktów, które asystent odczyta, trafiają do aplikacji AI wybranej przez Ciebie (np. Claude firmy Anthropic) i są tam przetwarzane na podstawie Twojej umowy z dostawcą. Szczegóły: prywatność API, polityka prywatności i warunki API. Pytania: support@ksefcanvas.pl.

In English

KSeF Canvas MCP server

KSeF Canvas issues Polish structured e-invoices in KSeF, the national e-invoicing system. Its MCP server lets Claude and Claude Code look up a firm's saved clients and products, create and update invoice drafts, validate them, preview the PDF, issue a validated draft to KSeF and fetch the invoice state and its XML, UPO and PDF.

Server URL: https://api.ksefcanvas.pl/mcp (Streamable HTTP). Sign-in is OAuth 2.1 with PKCE: the firm's owner signs in to KSeF Canvas, picks one firm and the scopes (invoices:read, drafts:write, invoices:issue; issuing is never preselected) and accepts the API terms on the first connection. On Studio or Firma, API keys created in the app also work as a Bearer token; API keys and webhooks are not available during the trial.

Requirements: a KSeF Canvas firm with an active trial or the Studio or Firma plan. OAuth sign-in works from the first day of the trial in Claude and Claude Code; issuing also needs the firm's verified KSeF connection. Every tool declares a title and read-only and destructive hints. create_draft is additive; update_draft replaces existing draft content and is marked destructive. issue_draft is also marked destructive: it needs a fresh confirmation from validate_draft for the same draft version and asks the user to confirm the buyer, NIP, totals and issue date.

The server never sends e-mail, deletes data or changes keys, connections, webhooks, KSeF credentials, billing, members or settings. Data the assistant reads goes to the AI application chosen by the customer and is processed under the customer's agreement with that provider.

Privacy: API privacy notice and privacy policy (Polish). Support: support@ksefcanvas.pl.

Zacznij

Wystawiasz faktury w KSeF Canvas? Połącz Claude.

W Ustawienia → Integracje wybierz Aplikacje AI, aby skonfigurować MCP i zarządzać połączeniami z asystentami. Klucze i webhooki znajdziesz osobno w API. Masz pytanie o swój przypadek? Napisz do nas.

Przejdź do aplikacji →