Integracja wFirma z ChatGPT - kompletna instrukcja

Co daje połączenie wFirma + ChatGPT

Serwer MCP Fakto.app wystawia dla wFirma komplet narzędzi: faktury (tworzenie, wyszukiwanie, pobieranie PDF), kontrahenci, wydatki, płatności, magazyn, KPiR i podatki, a do tego raporty, analizy finansowe i predykcje (np. cashflow). Łącznie w obu systemach - wFirma i Fakturownia - dostępne są 83 narzędzia MCP. ChatGPT sam wybiera właściwe narzędzie na podstawie Twojego polecenia, np. „pokaż nieopłacone faktury z czerwca" wywoła wyszukiwanie faktur z filtrem dat i statusu.

Zanim zaczniesz: klucze

1. Konto Fakto.app z aktywnym planem - 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.

Wariant 1: ChatGPT z trybem deweloperskim (natywny MCP)

Obsługa własnych serwerów MCP w ChatGPT jest dostępna po włączeniu trybu deweloperskiego (Developer Mode) w ustawieniach konta - Settings → Connectors → Advanced. Tryb deweloperski jest dostępny wyłącznie w planach Business, Enterprise i Edu (w workspace włącza go administrator). W planie Plus ta opcja nie występuje - przejdź wtedy do wariantu 2 (n8n) albo użyj Claude. Po aktywacji trybu deweloperskiego:

1. Dodaj nowy serwer MCP (Add Server) i podaj adres: https://fakto.app/wfirma/stream
2. Jako metodę uwierzytelniania wybierz OAuth 2.0. Pola Client ID i Client Secret zostaw puste - serwer Fakto.app obsługuje dynamiczną rejestrację klienta (RFC 7591), więc ChatGPT zarejestruje się automatycznie. Konfiguracja discovery: https://fakto.app/.well-known/openid-configuration
3. Kliknij Connect - otworzy się formularz autoryzacji, w którym wpisujesz accessKey, secretKey, appKey wFirma oraz Subscription API Key z panelu Fakto.app.
4. Po zatwierdzeniu wracasz do ChatGPT i narzędzia wFirma są dostępne w rozmowie. Przetestuj poleceniem: „Pokaż 10 ostatnich faktur z tego miesiąca".

Zaleta tego wariantu: klucze API nie są zapisywane w żadnym pliku konfiguracyjnym - trafiają do zaszyfrowanego magazynu serwera, a ChatGPT posługuje się wyłącznie tokenem OAuth, który można unieważnić.

Wariant 2: przez n8n (automatyzacje + modele OpenAI)

Jeśli zamiast rozmowy w ChatGPT chcesz zbudować automatyczny proces (np. cotygodniowy raport sprzedaży na Slacku), użyj n8n z modelem OpenAI jako agentem:

1. W n8n dodaj węzeł AI Agent z modelem OpenAI, a do niego narzędzie MCP Client Tool (transport: Streamable HTTP, URL: https://fakto.app/wfirma/stream).
2. Autoryzację najprościej załatwić tokenem Bearer wygenerowanym w panelu Fakto.app (Dashboard → Tokeny MCP) - wszystkie klucze są zaszyfrowane w tokenie, więc w n8n dodajesz tylko header Authorization: Bearer ….
3. Alternatywnie zainstaluj community node n8n-nodes-faktoapp-wfirma - natywny węzeł wFirma z pełnym GUI (42 narzędzia w 10 grupach zasobów), który również można podpiąć pod agenta AI.
4. Gotowe workflow do importu znajdziesz na stronie Szablony n8n.

Przykładowe polecenia w ChatGPT

• ›Pokaż listę kontrahentów, którzy mają nieopłacone faktury po terminie.
• ›Wystaw fakturę dla firmy ABC Sp. z o.o. za abonament miesięczny 990 zł netto, VAT 23%.
• ›Porównaj przychody z tego i poprzedniego miesiąca.
• ›Jaki jest aktualny stan magazynowy produktów poniżej 10 sztuk?
• ›Przygotuj prognozę cashflow na najbliższe 3 miesiące.

Najczęstsze problemy

Pełna instrukcja konfiguracji wszystkich klientów (Claude, ChatGPT, n8n, Make) znajduje się na stronie Instrukcje.