Jeśli korzystałeś z inFakt MCP w wersji opartej o klucze API, ten artykuł wyjaśni co się zmieniło i jak przejść na nową wersję.
Co się zmieniło?
Nowa wersja inFakt MCP wprowadza dwie duże zmiany:
- Autoryzacja — klucze API zastąpione logowaniem OAuth 2.1 przez przeglądarkę.
- Możliwości — oprócz odczytu danych, AI może teraz też wykonywać operacje (np. tworzyć faktury).
Dlaczego zmieniliśmy sposób logowania?
| Klucze API (stara wersja) | OAuth 2.1 (nowa wersja) | |
| Logowanie | Generowanie klucza, kopiowanie, wklejanie | Logowanie w przeglądarce — jak do każdej innej usługi |
| Bezpieczeństwo | Statyczny klucz — jeśli wycieknie, trzeba go wymienić | Tokeny z ograniczonym czasem ważności, automatycznie odświeżane |
| Kontrola dostępu | Klucz daje pełny dostęp do odczytu | Zakresy (scopes) — sam decydujesz do czego dajesz dostęp |
| Ilość sesji | Maks. 3 klucze | Wiele sesji jednocześnie bez ograniczeń |
| Instalacja | Wymagany pakiet @infakt/mcp-bridge przez npm | Wystarczy adres serwera — zero instalacji |
| Możliwości | Tylko odczyt | Odczyt + 9 operacji zapisu (z potwierdzeniem) |
Co musisz zrobić? (krok po kroku)
Krok 1: Usuń starą konfigurację
Otwórz plik konfiguracji MCP w swoim narzędziu AI i usuń starą konfigurację, która wygląda tak:
{
"mcpServers": {
"infakt": {
"command": "npx",
"args": ["-y", "infakt-mcp-bridge"],
"env": {
"INFAKT_API_KEY": "TWOJ_KLUCZ_API"
}
}
}
}
Krok 2: Dodaj nową konfigurację
W tym samym pliku wklej nową, prostszą konfigurację:
{
"mcpServers": {
"infakt": {
"url": "https://mcp.infakt.pl/mcp"
}
}
}
Krok 3: Opcjonalnie — posprzątaj
- Odinstaluj pakiet: npm uninstall @infakt/mcp-bridge (jeśli był zainstalowany globalnie: npm uninstall -g @infakt/mcp-bridge)
- Usuń zmienną środowiskową INFAKT_API_KEY jeśli była ustawiona
Krok 4: Uruchom ponownie narzędzie AI
Zamknij i uruchom ponownie swoje narzędzie AI (Claude Desktop, Cursor itp.).
Krok 5: Zaloguj się
Przy pierwszym połączeniu otworzy się przeglądarka z ekranem logowania do inFakt. Zaloguj się, zatwierdź dostęp i gotowe.
Co z moimi starymi kluczami API?
Stare klucze API możesz usunąć w ustawieniach inFakt (Ustawienia → MCP). Nie będą one już potrzebne do korzystania z nowej wersji MCP.
Czy moje dane się zmienią?
Nie. Migracja dotyczy wyłącznie sposobu logowania i konfiguracji. Wszystkie Twoje dane w inFakt pozostają bez zmian.
Nowe możliwości po migracji
Po przejściu na nową wersję zyskujesz dostęp do operacji zapisu:
- Tworzenie faktur VAT, korygujących i OSS
- Tworzenie faktur na wzór istniejących
- Oznaczanie faktur jako opłaconych
- Wysyłanie faktur e-mailem
- Wysyłanie faktur do KSeF
- Dodawanie klientów
- Dodawanie produktów
Każda z tych operacji wymaga Twojego potwierdzenia przed wykonaniem.
Potrzebujesz pomocy?
Jeśli masz problemy z migracją, skontaktuj się z naszym zespołem wsparcia. Pomożemy Ci przejść na nową wersję.
Komentarze
Komentarze: 0
Zaloguj się, aby dodać komentarz.