Instrukcja krok po kroku

Jak zacząć z Fakto.app?

Kompletna instrukcja konfiguracji MCP z ChatGPT i Claude Desktop

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: Konfiguracja headerów

W n8n musisz dodać odpowiedni header z credentials. Oto przykłady konfiguracji:

W
Header dla wFirma
Nazwa headera:x-wfirma-credentials
Wartość (JSON):
{
  "accessKey": "2158c549........",
  "secretKey": "182a0dda2........",
  "appKey": "408ead4b........",
  "companyId": "25...9",
  "subscription_api_key": "ak_prod_SgtDf........"
}
F
Header dla Fakturownia
Nazwa headera:x-fakturownia-credentials
Wartość (JSON):
{
  "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

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