Instrukcja krok po kroku

Jak zacząć z Fakto.app?

Kompletna instrukcja konfiguracji MCP z Claude, ChatGPT, n8n i Make.com

1

Uzyskaj klucz subskrypcji

Aby uzyskać klucz subskrypcji:

  1. Zarejestruj się w panelu Fakto.app MCP (lub zaloguj się jeśli masz już konto)
  2. Wybierz plan subskrypcji
  3. Po aktywacji subskrypcji, przejdź do Dashboard → Klucze API
  4. Skopiuj swój Subscription API Key
  5. Zapisz ten klucz - będzie potrzebny podczas autoryzacji OAuth dla obu systemów

💡 Wskazówka: Jeden klucz subskrypcji działa dla wFirma i Fakturownia. Możesz używać obu systemów jednocześnie!

2

Przygotuj dane do autoryzacji

W
Dla wFirma:

  1. Zaloguj się do swojego konta wFirma.pl
  2. Przejdź do: Ustawienia → Bezpieczeństwo → Aplikacje → Klucze API
  3. Kliknij "Dodaj" Podaj nazwę aplikacji i kliknij "Zapisz"
  4. System wygeneruje:
    • accessKey - klucz dostępu
    • secretKey - klucz tajny (wyświetlany tylko raz!)
    • appKey - klucz aplikacji (dostarczany indywidualnie przez wFirma.pl)
  5. Skopiuj wszystkie trzy klucze i zapisz je w bezpiecznym miejscu
⚠️ UWAGA dla wFirma:
  • secretKey jest wyświetlany tylko raz podczas tworzenia - zapisz go natychmiast!
  • Każda modyfikacja klucza aplikacji spowoduje zmianę zarówno accessKey jak i secretKey
  • Do poprawnego działania potrzebne są wszystkie 3 klucze

F
Dla Fakturownia:

  1. Zaloguj się do swojego konta Fakturownia.pl
  2. Przejdź do: Ustawienia → API → API token → kliknij: Zobacz
  3. Kliknij "Dodaj nowy Token"
  4. System wygeneruje:
    • Token API - unikalny token autoryzacyjny
    • Subdomain - subdomain Twojego konta (np. moja-firma)
  5. Skopiuj token i zapisz subdomain

💡 Gdzie znaleźć subdomain?

  • Subdomain znajduje się w adresie URL Twojego konta Fakturownia
  • Jeśli logujesz się na moja-firma.fakturownia.pl, to Twój subdomain to moja-firma
3

Konfiguracja Claude Desktop

Krok 3.1: Dodaj custom connector

  1. Otwórz Claude Desktop
  2. Przejdź do Settings → Manage Connectors
  3. Kliknij "Add custom connector"
  4. Wprowadź następujące dane:
    • Nazwa: MCP wFirma (lub MCP Fakturownia)
    • Remote MCP server URL:
      Dla wFirma:https://fakto.app/wfirma/stream
      Dla Fakturownia:https://fakto.app/fakturownia/stream
  5. Kliknij "Add" lub "Save"

Krok 3.2: Połącz z serwerem MCP

  1. W liście connectorów znajdź dodany connector
  2. Kliknij "Connect" przy dodanym connectorze
  3. Claude Desktop automatycznie rozpocznie proces autoryzacji OAuth

Krok 3.3: Autoryzacja OAuth dla wFirma

  1. Zostaniesz przekierowany do formularza autoryzacji w przeglądarce
  2. Wprowadź swoje dane:
    • wFirma Access Key - z ustawień API wFirma (krok 2)
    • wFirma Secret Key - z ustawień API wFirma (krok 2)
    • wFirma App Key - z ustawień API wFirma (krok 2)
    • Company ID - identyfikator firmy (opcjonalne)
    • Subscription API Key - klucz z panelu (krok 1)
  3. Kliknij "Authorize"
  4. Zostaniesz przekierowany z powrotem do Claude Desktop
  5. Gotowe! Możesz teraz używać narzędzi wFirma w Claude

Krok 3.4: Autoryzacja OAuth dla Fakturownia

  1. Zostaniesz przekierowany do formularza autoryzacji w przeglądarce
  2. Wprowadź swoje dane:
    • Token API - token z ustawień API Fakturownia (krok 2)
    • Subdomain - subdomain Twojego konta Fakturownia (krok 2)
    • Subscription API Key - klucz z panelu (krok 1) - ten sam klucz co dla wFirma!
  3. Kliknij "Authorize"
  4. Zostaniesz przekierowany z powrotem do Claude Desktop
  5. Gotowe! Możesz teraz używać narzędzi Fakturownia w Claude

💡 Wskazówka: Możesz dodać oba connectory (wFirma i Fakturownia) i używać ich jednocześnie!

4

Konfiguracja ChatGPT

ChatGPT obsługuje MCP przez OAuth 2.0. Oto jak skonfigurować:

  1. 1. Otwórz ChatGPT i przejdź do ustawień MCP:
    • Przejdź do Settings → MCP Servers
    • Kliknij "Add Server" lub "Add MCP Server"
  2. 2. Wprowadź dane serwera dla wFirma:
    • Server Name: wFirma MCP
    • Server URL: https://fakto.app/wfirma/stream
    • Authentication: OAuth 2.0
    • Discovery URL: https://fakto.app/.well-known/openid-configuration
    • Client ID i Client Secret: Zostaw PUSTE (automatyczna rejestracja)
  3. 3. Wprowadź dane serwera dla Fakturownia:
    • Server Name: Fakturownia MCP
    • Server URL: https://fakto.app/fakturownia/stream
    • Authentication: OAuth 2.0
    • Discovery URL: https://fakto.app/fakturownia/.well-known/openid-configuration
    • Client ID i Client Secret: Zostaw PUSTE (automatyczna rejestracja)
  4. 4. Autoryzacja OAuth:
    1. Kliknij "Connect" lub "Authorize" przy serwerze MCP
    2. ChatGPT automatycznie zarejestruje się jako klient OAuth (RFC 7591)
    3. Zostaniesz przekierowany do formularza autoryzacji
    4. Wprowadź swoje dane (tak jak w kroku 3)
    5. Kliknij "Authorize"
    6. Gotowe! Możesz teraz używać narzędzi w ChatGPT
💡 Zalety OAuth:
  • Nie musisz instalować i uruchamiać lokalnego serwera
  • Klucze API nie są przechowywane w plikach konfiguracyjnych
  • Automatyczna rejestracja klienta (nie potrzebujesz Client ID/Secret)
  • Bezpieczne połączenie z automatycznym odświeżaniem
5

Integracja z n8n

n8n to platforma automatyzacji workflow, która pozwala łączyć MCP z innymi aplikacjami. Oto jak skonfigurować:

Krok 5.1: Przygotuj workflow w n8n

  1. Utwórz nowy workflow w n8n
  2. Dodaj węzeł AI Agent (np. Google Gemini lub OpenAI)
  3. Dodaj do agenta narzędzie MCP Client Tool
  4. Wybierz typ transportu: Streamable HTTP

Krok 5.2: Konfiguracja URL

URL dla wFirma:https://fakto.app/wfirma/stream
URL dla Fakturownia:https://fakto.app/fakturownia/stream

Krok 5.3: Autoryzacja — wybierz metodę

Metoda 1: Bearer Token (zalecana)Prostsza i bezpieczniejsza
  1. Zaloguj się do panelu Fakto.app i przejdź do Dashboard → Tokeny MCP
  2. Wygeneruj zaszyfrowany token Bearer dla wFirma lub Fakturownia
  3. W n8n MCP Client Tool dodaj header:
Nazwa headera: Authorization
Wartość: Bearer <wygenerowany token>

Wszystkie credentials są zaszyfrowane w tokenie — nie musisz wklejać kluczy API jako JSON.

Metoda 2: Community Nodes (natywna integracja)Najlepsza integracja z n8n

Zainstaluj dedykowane węzły Fakto.app bezpośrednio w n8n — pełne GUI z listą zasobów, operacji i wbudowaną autoryzacją.

W
wFirma
n8n-nodes-faktoapp-wfirma

42 narzędzia, 10 grup zasobów: Faktury, Kontrahenci, Wydatki, Płatności, Produkty, Magazyn, Analityka, Prognozy, Automatyzacja, KPiR/Podatki

F
Fakturownia
n8n-nodes-faktoapp-fakturownia

37 narzędzi, 5 grup zasobów: Faktury, Kontrahenci, Produkty, Magazyn, Analityka

Instalacja:

  1. W n8n przejdź do Settings → Community Nodes
  2. Wpisz nazwę pakietu (np. n8n-nodes-faktoapp-wfirma) i zainstaluj
  3. Dodaj węzeł wFirma lub Fakturownia do workflow
  4. Utwórz credentials — podaj klucze API systemu + klucz subskrypcji Fakto

Węzły mają wbudowaną obsługę AI Agent — możesz je podpiąć jako narzędzia agenta bez MCP Client Tool.

GitHub: n8n-nodes-polish-accounting
Metoda 3: Custom headers (bezpośrednie credentials)

Zaawansowana metoda — podaj credentials bezpośrednio w headerach MCP Client Tool:

W
Header dla wFirma
Nazwa: x-wfirma-credentials
{
  "accessKey": "2158c549........",
  "secretKey": "182a0dda2........",
  "appKey": "408ead4b........",
  "companyId": "25...9",
  "subscription_api_key": "ak_prod_SgtDf........"
}
F
Header dla Fakturownia
Nazwa: x-fakturownia-credentials
{
  "token": "SNTVP8P.........",
  "subdomain": "moja-firma",
  "subscriptionApiKey": "ak_prod_SgtDfY...."
}

Krok 5.4: Opcjonalne ustawienia

  • SSE (Server-Sent Events): Ustaw na true dla lepszej wydajności strumieniowania
  • Timeout: Zalecane 30-60 sekund dla operacji na dużych zbiorach danych
  • Max Retries: Ustaw 2-3 dla stabilności połączenia
💡 Przykładowe workflow:

Gotowe przykłady workflow do importu znajdziesz na naszym GitHub:

github.com/nulline-apps/fakto.app_n8n_example
6

Integracja z Make.com

Make.com posiada dedykowany moduł MCP Client, który automatycznie obsługuje komunikację z serwerem MCP. Wystarczy podać URL i token.

Krok 6.1: Wygeneruj token Bearer

  1. Zaloguj się do panelu Fakto.app
  2. Przejdź do Dashboard → Tokeny MCP
  3. Wybierz system (wFirma lub Fakturownia)
  4. Wprowadź dane dostępowe i klucz subskrypcji
  5. Kliknij "Generuj token MCP" i skopiuj wygenerowany token

Krok 6.2: Dodaj moduł MCP Client w Make.com

  1. Utwórz nowy scenariusz w Make.com
  2. Dodaj moduł MCP Client (znajdziesz go w kategorii AI)
  3. Kliknij "Create a connection"

Krok 6.3: Utwórz połączenie z serwerem MCP

  1. W polu MCP Server kliknij + New MCP Server
  2. Wprowadź URL serwera:
    Dla wFirma:https://fakto.app/wfirma/stream
    Dla Fakturownia:https://fakto.app/fakturownia/stream
  3. W polu API key / Access token wklej wygenerowany token Bearer (z kroku 6.1)
  4. Kliknij "Save"

Krok 6.4: Wybierz typ modułu

MCP Client oferuje dwa tryby pracy:

Execute an action with AI

AI automatycznie wybiera i uruchamia odpowiednie narzędzia. Opisz zadanie (np. "Pobierz ostatnie 10 faktur") — AI sam wybierze właściwe narzędzie.

Call a tool

Ręcznie wybierz narzędzie z listy i podaj parametry. Idealne do testowania i precyzyjnych scenariuszy automatyzacji.

💡 Wskazówka:

Po utworzeniu połączenia, MCP Client automatycznie pobierze listę dostępnych narzędzi z serwera Fakto.app. Nie musisz ręcznie konfigurować zapytań JSON-RPC — moduł obsługuje to za Ciebie.

7

Przetestuj połączenie

Po skonfigurowaniu, możesz przetestować integrację zadając pytania w Claude lub ChatGPT:

W
Przykłady dla wFirma:

  • "Pokaż mi ostatnie 10 faktur z tego miesiąca"
  • "Stwórz nową fakturę dla kontrahenta ABC Sp. z o.o."
  • "Pokaż mi listę wszystkich kontrahentów"
  • "Jaki jest stan magazynowy?"
  • "Pokaż podsumowanie finansowe za ostatni miesiąc"

F
Przykłady dla Fakturownia:

  • "Pokaż mi ostatnie 10 faktur z tego miesiąca"
  • "Stwórz nową fakturę dla kontrahenta ABC Sp. z o.o."
  • "Pokaż mi listę wszystkich kontrahentów"
  • "Jaki jest stan magazynowy w magazynie głównym?"
  • "Pokaż wszystkie produkty z kodem SKU-123"

🎉 Gratulacje! Jeśli otrzymujesz odpowiedzi z danymi z Twojego systemu księgowego, konfiguracja przebiegła pomyślnie!

Masz pytania?

Sprawdź nasze FAQ lub skontaktuj się z nami

Przejdź do FAQZałóż konto