Dostęp dla AI (MCP)

MojaFaktura na Macu potrafi udostępnić Twoje dane asystentowi AI — np. Claude, ChatGPT (Codex) lub Cursor. Dzięki temu możesz zadawać pytania o swoją firmę zwykłym językiem, a asystent sam odnajdzie potrzebne dokumenty i policzy wynik:

  • „Kto był moim największym klientem w zeszłym roku?"
  • „Jak zmieniała się cena paliwa za litr w ostatnich 5 latach?"
  • „Pokaż sprzedaż i koszty miesiąc po miesiącu oraz zmianę procentową."
  • „Które faktury są po terminie płatności?"
  • „Których towarów jest mniej niż stan minimalny?"

Połączenie korzysta z otwartego standardu MCP (Model Context Protocol). Asystent ma dostęp do faktur i innych dokumentów sprzedaży, kosztów, kontrahentów, płatności, produktów oraz danych magazynowych.

Wymagania

  • MojaFaktura w wersji 3.3.1 lub nowszej na komputerze Mac
  • plan Pro
  • program MojaFaktura musi być uruchomiony — asystent łączy się z nim tylko wtedy, gdy jest otwarty
  • asystent AI zainstalowany na tym samym Macu

Krok 1 — Włącz dostęp

Otwórz Ustawienia programu (menu MojaFaktura → Ustawienia…) i przejdź do zakładki Dostęp AI. Włącz przełącznik Zezwól klientom AI na odczyt danych. Pole Status pokaże zieloną kropkę i adres serwera, np. http://127.0.0.1:64045/mcp.

Krok 2 — Wybierz udostępniane konta

W sekcji Udostępnione konta zaznacz konta (firmy), które asystent może czytać. Domyślnie żadne konto nie jest udostępnione. W każdej chwili możesz wyłączyć udostępnianie — działa to natychmiast.

Krok 3 — Połącz asystenta

Claude Desktop

Kliknij Zainstaluj w Claude Desktop…, zapisz plik MyInvoice.mcpb (np. w folderze Pobrane) — otworzy się on w programie Claude Desktop. Potwierdź instalację przyciskiem Install. Port i token są już wpisane, nie trzeba instalować żadnego dodatkowego oprogramowania.

Po zmianie portu lub wygenerowaniu nowego tokenu zainstaluj rozszerzenie ponownie.

Claude Code

W sekcji Połącz klienta kliknij Kopiuj przy pozycji Claude Code i wklej polecenie w Terminalu.

ChatGPT / Codex

Skopiuj fragment konfiguracji z pozycji ChatGPT / Codex i dodaj go w aplikacji ChatGPT na Macu (Settings → MCP servers) albo w pliku ~/.codex/config.toml. Z tej konfiguracji korzysta Codex w aplikacji ChatGPT, Codex CLI oraz rozszerzenie do edytorów.

Zwykłe rozmowy w ChatGPT (także w przeglądarce) łączą się wyłącznie z serwerami dostępnymi publicznie w internecie, dlatego nie mogą korzystać z danych zapisanych na Twoim Macu.

Cursor

Skopiuj konfigurację z pozycji Cursor i dodaj ją do pliku ~/.cursor/mcp.json.

Inne programy

Każdy program obsługujący MCP przez HTTP może się połączyć: podaj adres serwera z pola Status oraz nagłówek Authorization: Bearer <token> z tokenem z sekcji Bezpieczeństwo.

Bezpieczeństwo i prywatność

  • Tylko odczyt. Asystent nie może niczego zmienić ani usunąć w programie.
  • Tylko ten Mac. Serwer przyjmuje połączenia wyłącznie z tego samego komputera i tylko wtedy, gdy MojaFaktura jest uruchomiona.
  • Token dostępu. Każde połączenie wymaga tokenu. Jeśli podejrzewasz, że ktoś go poznał, użyj Wygeneruj token ponownie… — dotychczasowe połączenia przestaną działać do czasu aktualizacji konfiguracji.
  • Tylko wybrane konta. Asystent widzi wyłącznie konta zaznaczone w sekcji Udostępnione konta.
  • Bez danych wrażliwych. Numery rachunków bankowych oraz pliki i dane techniczne KSeF nie są udostępniane.
  • Pamiętaj: dane, które asystent odczyta, są przesyłane do dostawcy danego modelu AI (np. Anthropic lub OpenAI) i podlegają jego regulaminowi. Udostępniaj tylko te konta, których dane chcesz tam przekazać. Producent programu MojaFaktura nie pośredniczy w tym połączeniu i nie ma dostępu do tych danych.

Rozwiązywanie problemów

Asystent zgłasza, że MojaFaktura jest niedostępna
Uruchom program MojaFaktura na tym Macu i sprawdź, czy w zakładce Dostęp AI przełącznik jest włączony, a Status pokazuje zieloną kropkę.
Asystent zgłasza odrzucony token
Token został zmieniony. W Claude Desktop zainstaluj rozszerzenie ponownie, w pozostałych programach skopiuj konfigurację jeszcze raz.
Asystent nie widzi żadnego konta
Zaznacz co najmniej jedno konto w sekcji Udostępnione konta.
Status pokazuje błąd portu
Port jest zajęty przez inny program. Kliknij Wybierz inny port, a następnie zaktualizuj konfigurację asystenta.
Zakładka pokazuje tylko informację o planie Pro
Dostęp dla AI jest częścią planu Pro. Po przejściu na plan Pro wszystkie opcje pojawią się automatycznie.
Asystent pokazuje nieaktualne dane
Dane są odświeżane kilka sekund po każdej zmianie w programie. Zadaj pytanie ponownie.