Wystaw API · MCP

Wystaw w Claude i innych agentach AI

Serwer MCP (Model Context Protocol) pozwala asystentowi AI działać na Twoim koncie: „wystaw fakturę dla Kawiarni Pod Lipą za 20 h konsultacji po 150 zł netto, termin 14 dni, po angielsku” — agent tworzy szkic, pokazuje podsumowanie, a po Twoim potwierdzeniu wystawia fakturę i wysyła ją do KSeF. Odpowiada też na pytania („kto mi nie zapłacił?”, „ile zafakturowałem w październiku?”).

Dodaj do Claude

Adres serwera MCP (Streamable HTTP, logowanie OAuth):

https://wystaw.io/api/mcp

W Claude (claude.ai, aplikacja na komputer lub telefon) otwórz Ustawienia → Konektory i wybierz Dodaj własny konektor.
Wpisz nazwę Wystaw i wklej adres powyżej. Kliknij Dodaj, potem Połącz.
Zaloguj się do Wystaw (link e-mail lub passkey). Na ekranie zgody wybierz firmę, zakres dostępu — Odczyt, Szkice, Wystawianie (domyślnie wyłączone) — i dzienny limit wystawionych faktur, potem Zezwól.
W rozmowie włącz konektor Wystaw i napisz np.: „wystaw fakturę dla Kawiarni Pod Lipą za 20 h konsultacji po 150 zł netto”.

Otwórz konektory w Claude

Claude Code

Przez OAuth (logowanie w przeglądarce przy pierwszym użyciu):

claude mcp add --transport http wystaw https://wystaw.io/api/mcp

Albo lokalnie przez @wystaw/mcp z kluczem API (Ustawienia → API, plan Pro, scope invoices:write dla szkiców i wystawiania):

claude mcp add wystaw --env WYSTAW_API_KEY=wst_live_… --env WYSTAW_API_URL=https://wystaw.io -- npx -y @wystaw/mcp

Cursor

Plik ~/.cursor/mcp.json — przez OAuth:

{
  "mcpServers": {
    "wystaw": {
      "url": "https://wystaw.io/api/mcp"
    }
  }
}

albo z kluczem API (stdio):

{
  "mcpServers": {
    "wystaw": {
      "command": "npx",
      "args": [
        "-y",
        "@wystaw/mcp"
      ],
      "env": {
        "WYSTAW_API_KEY": "wst_live_…",
        "WYSTAW_API_URL": "https://wystaw.io"
      }
    }
  }
}

Narzędzia

Agent zawsze zaczyna od get_context (marki, domyślne ustawienia, dzisiejsza data), dzięki czemu nie dopytuje o rzeczy, które już wiemy.

get_contextKontekst kontaOdczyt
find_customersSzukaj kontrahentówOdczyt
lookup_company_by_nipDane firmy po NIPOdczyt
search_productsSzukaj w kataloguOdczyt
list_invoicesLista fakturOdczyt
get_invoiceSzczegóły fakturyOdczyt
get_invoice_pdfPDF fakturyOdczyt
monthly_summaryPodsumowanie miesiącaOdczyt
create_customerDodaj kontrahentaSzkice
draft_invoiceSzkic fakturySzkice
update_draftPopraw szkicSzkice
duplicate_last_invoicePowtórz ostatnią fakturęSzkice
issue_invoiceWystaw fakturęWystawianie
send_invoiceWyślij fakturę e-mailemWystawianie
mark_paidOznacz jako zapłaconąWystawianie
draft_correctionSzkic korektyWystawianie

Zasoby: wystaw://context, wystaw://customers, wystaw://invoice/{id}, wystaw://invoice/{id}/pdf/{lang}. Prompty: invoice-from-description, unpaid-reminder-list, month-close-summary.

Bezpieczeństwo

Dwuetapowe wystawianie. Agent tworzy szkic i pokazuje podsumowanie; wystawić może dopiero z tokenem potwierdzenia (confirmationToken, ważny 10 minut, unieważniany każdą zmianą szkicu). To samo dotyczy wysyłki e-mailem i korekt.
Limit dzienny wystawionych faktur na połączenie (0–50, ustawiany na ekranie zgody i w Ustawieniach), ograniczony planem: Free 0, Solo 5, Pro 50. Opcjonalnie maksymalna kwota jednej faktury.
Rozłącz w każdej chwili: Ustawienia → Agenci AI — agent traci dostęp przy następnym żądaniu. Tam też widzisz dziennik wszystkich jego działań.
Agent widzi tylko dane wybranej firmy (te same uprawnienia i izolacja co w aplikacji) i nigdy nie dostaje sekretów (kluczy, certyfikatów KSeF).

Plany

Free: tylko odczyt (listy, statusy, podsumowania, PDF-y).
Solo i Pro: odczyt, szkice i wystawianie (Solo do 5, Pro do 50 faktur dziennie przez agenta). @wystaw/mcp z kluczem API wymaga planu Pro.