Przejdź do treści
wystaw. — strona głównaCennikBlogEN English versionZaloguj sięZacznij za darmo

API, webhooki i agenci AI (MCP)

Połącz Claude’a albo innego asystenta AI z Wystaw, ustaw limity i wystawiaj faktury z własnego systemu przez API.

W skrócie: Wystaw ma publiczne API z webhookami (plan Pro) i serwer MCP, przez który Claude i inni asystenci AI czytają faktury, przygotowują szkice i — za twoją zgodą — wystawiają faktury. Pełna dokumentacja: Wystaw API.

Agenci AI (MCP)

Połączysz Claude'a (w przeglądarce i Claude Code), Cursor i inne narzędzia obsługujące MCP. W Claude:

  1. Ustawienia → Konektory → Dodaj własny konektor.
  2. Nazwa „Wystaw”, adres serwera MCP z instrukcji dla agentów, potem Dodaj i Połącz.
  3. Zaloguj się do Wystaw. Na ekranie zgody wybierz firmę, uprawnienia (Odczyt, Szkice, Wystawianie — to ostatnie domyślnie wyłączone) i dzienny limit wystawień. Stuknij Zezwól.

Zanim agent wystawi fakturę, musi pokazać ci szkic i dostać potwierdzenie. Każda zmiana w szkicu wymaga nowego potwierdzenia.

PlanCo może agentWystawień dziennie
Freetylko odczyt0
Soloodczyt, szkice, wystawianiedo 5
Proodczyt, szkice, wystawianiedo 50

Połączonych agentów widzisz w Ustawienia → Agenci AI: każdemu ustawisz dzienny limit wystawień i maksymalną kwotę brutto jednej faktury, przejrzysz dziennik jego działań albo go Rozłączysz.

Ekran Agenci AI w Wystaw na telefonie: dzienny limit faktur wystawianych przez agenta w planie Solo i przycisk Jak połączyć agenta
Agenci AI: tu zobaczysz połączenia, limity i dziennik.

API i webhooki (Pro)

W Ustawienia → API i webhooki utworzysz klucz API (Nowy klucz API): nadajesz mu nazwę, tryb (produkcyjny albo testowy), zakresy uprawnień i opcjonalną datę wygaśnięcia. Klucz pokazujemy tylko raz — przechowuj go na serwerze, nigdy w przeglądarce.

  • Adres bazowy: /api/v1, nagłówek Authorization: Bearer wst_live_….
  • POST /invoices wymaga nagłówka Idempotency-Key.
  • Limit: 60 żądań na minutę i 600 na godzinę na klucz.
  • Webhooki (Nowy webhook, tylko HTTPS) informują o wystawieniu faktury, przyjęciu i odrzuceniu przez KSeF, trybie offline24 i zapłacie. Każde żądanie jest podpisane nagłówkiem Wystaw-Signature.

Na planach Free i Solo żądania API zwracają błąd 402. Klucze utworzone wcześniej nadal widzisz i możesz je unieważnić.

Czego API jeszcze nie robi

Faktur zaliczkowych i korekt faktur walutowych — dostaniesz 422 not_supported_yet. Szczegóły: zaliczki i korekty walutowe.