Poradnik

Integracja wFirma z Claude - księgowość w asystencie AI

Claude obsługuje zdalne serwery MCP przez custom connectors - zarówno w aplikacji Claude Desktop, jak i w przeglądarce na claude.ai. Po jednorazowej, kilkuminutowej konfiguracji możesz rozmawiać z Claude o swoich fakturach, kontrahentach i finansach z wFirma.

Dlaczego Claude + wFirma

Claude bardzo dobrze radzi sobie z zadaniami wieloetapowymi: „znajdź kontrahenta, sprawdź jego nieopłacone faktury i przygotuj podsumowanie" wykona jako sekwencję wywołań narzędzi MCP - bez Twojego udziału. Serwer Fakto.app wystawia dla wFirma 45 narzędzi (faktury, kontrahenci, koszty, magazyn, KPiR, analizy i predykcje), a dla Fakturowni kolejne 37. Claude sam dobiera narzędzia do polecenia.

Zanim zaczniesz: klucze

  1. Konto Fakto.app - darmowy plan wystarczy na start; klucz subskrypcji znajdziesz w Dashboard → Klucze API.
  2. Klucze API wFirma: Ustawienia → Bezpieczeństwo → Aplikacje → Klucze API - zapisz accessKey, secretKey (wyświetlany tylko raz!) i appKey.
  3. Plan Claude z obsługą custom connectors (Pro, Max, Team lub Enterprise).

Krok 1: Dodaj custom connector

  1. Otwórz Claude Desktop lub claude.ai i przejdź do Settings → Connectors.
  2. Kliknij Add custom connector i podaj adres: https://fakto.app/wfirma/stream
  3. Zapisz - connector pojawi się na liście. Możesz od razu dodać drugi dla Fakturowni: https://fakto.app/fakturownia/stream - oba działają równolegle na jednym kluczu subskrypcji.

Krok 2: Autoryzacja OAuth

  1. Przy connectorze kliknij Connect.
  2. Claude przekieruje Cię na stronę autoryzacji Fakto.app - wpisz tam accessKey, secretKey i appKey wFirma oraz klucz subskrypcji.
  3. Po zatwierdzeniu wracasz do Claude. Klucze API trafiają do zaszyfrowanego magazynu serwera (AES-256-GCM) - Claude posługuje się wyłącznie tokenem OAuth, ważnym 7 dni i odświeżanym automatycznie.

Krok 3: Pierwsze polecenia

  • ›Pokaż moje 3 ostatnie faktury.
  • ›Które faktury są po terminie płatności? Posortuj po kwocie.
  • ›Wystaw fakturę dla ABC Sp. z o.o. za usługi doradcze, 5000 zł netto, VAT 23%.
  • ›Porównaj przychody i koszty z ostatnich 3 miesięcy.
  • ›Przygotuj prognozę cashflow na sierpień.

Wskazówka: przy tworzeniu dokumentów Claude zawsze pokaże dane do potwierdzenia, zanim wystawi fakturę. Jeśli chcesz nadać mu spójny styl pracy księgowego, użyj naszego gotowego promptu asystenta księgowego jako instrukcji projektu w Claude Projects.

Najczęstsze problemy

Claude nie widzi narzędzi

Rozłącz connector (Disconnect) i połącz ponownie - lista narzędzi odświeży się po nowej autoryzacji. Sprawdź też, czy subskrypcja Fakto.app jest aktywna: lista narzędzi jest dopasowana do uprawnień Twojego planu.

Autoryzacja kończy się błędem

Najczęstsza przyczyna to niekompletne klucze wFirma - potrzebne są wszystkie trzy (accessKey, secretKey, appKey). Po wygenerowaniu nowego kompletu kluczy w wFirma stare przestają działać.

Narzędzie odmawia dostępu

Plan Free obejmuje odczyt faktur, kontrahentów i podsumowań finansowych. Wystawianie faktur i moduły magazynu/predykcji wymagają planów płatnych - zobacz cennik.

Pełna instrukcja konfiguracji wszystkich klientów znajduje się na stronie Instrukcje.

Połącz wFirma z Claude w 5 minut

Załóż darmowe konto, dodaj connector i zapytaj Claude o swoje faktury.

Załóż darmowe kontoZobacz instrukcje