Harness – Claude Code

Połącz Claude Code bezpośrednio z adresem xSale MCP. Nie musisz uruchamiać lokalnego serwera xSale ani kopiować danych do pliku.

Wymagania

• Aktualny Claude Code, działający terminal i przeglądarka.
• Własne konto xSale z dostępem do właściwej organizacji.
• Konto AI dopuszczone w firmie i polityka pozwalająca na użycie tego serwera MCP.

Najpierw zabezpiecz dane

Nie przekazuj danych osobowych ani poufnych do trenowania modeli AI. Ogranicz pobierane dane i nie wczytuj całych zestawów zamówień, jeśli potrzebujesz tylko podsumowania. Dotyczy to treści rozmowy, wyników MCP i plików projektu.

Jeśli logujesz się kontem osobistym Claude, otwórz Settings → Privacy i wyłącz Help Improve our AI models. To ustawienie dotyczy również sesji Claude Code takiego konta. Zobacz ustawienia prywatności Anthropic.

Sprawdź retencję przypisaną do planu i wybranego dostawcy. Claude Code zapisuje także lokalną historię sesji. Wyłączenie treningu nie usuwa tej historii. Ustal dostęp do logów i ich czas przechowywania; nie zakładaj, że plan firmowy automatycznie oznacza zerową retencję. Źródło: Claude Code — użycie danych.

Rozpocznij od odczytu. Nie używaj trybu pomijania potwierdzeń ani ogólnej zgody na wszystkie narzędzia xSale. Tekst „nie zmieniaj danych” nie blokuje zapisu technicznie. Uprawnienia konta xSale muszą odpowiadać zakresowi pracy. Nie zapisuj tokenów i haseł w repozytorium ani rozmowie. Więcej: bezpieczeństwo danych.

Dane połączenia

• Adres: https://mcp.xsale.ai/mcp.
• Transport: HTTP, obsługa Streamable HTTP.
• Logowanie: OAuth; wystawca https://login.futuriti.pl/; zakresy logowania openid email.
• Identyfikator klienta OAuth: HLdQzTtL9KZO6yYm5OpHkellPGOCV81V.
• Sekret klienta: nie jest wymagany. Nie dodawaj opcji --client-secret.

Zakresy logowania nie są uprawnieniami tylko do odczytu. Nie dopisuj do endpointu loginu ani hasła.

Jak połączyć

Poniższe kroki wykonaj w terminalu na swoim komputerze, np. w PowerShell na Windowsie lub aplikacji Terminal na macOS. Poleceń nie wpisuj w rozmowie w aplikacji Claude.

1. Sprawdź, czy Claude Code jest zainstalowany i dostępny w terminalu. Wpisz claude --version i zatwierdź klawiszem Enter. Jeśli zobaczysz numer wersji, możesz przejść dalej. Komunikat, że polecenie nie zostało rozpoznane, może oznaczać brak instalacji lub brak dostępu do programu w tym terminalu. W takim przypadku sprawdź instalację Claude Code, a następnie ponownie otwórz terminal i powtórz polecenie.
2. Dodaj serwer w konfiguracji użytkownika:

   claude mcp add --transport http --scope user --client-id HLdQzTtL9KZO6yYm5OpHkellPGOCV81V --callback-port 7025 xsale https://mcp.xsale.ai/mcp

3. W terminalu uruchom claude i postępuj zgodnie z prośbą o zalogowanie do xSale. Jeśli logowanie nie rozpocznie się automatycznie, wpisz w Claude Code /mcp, wybierz xSale i rozpocznij uwierzytelnianie.
4. Claude Code otworzy przeglądarkę do logowania. Jeśli przeglądarka nie otworzy się automatycznie, skopiuj link wyświetlony w terminalu i otwórz go w przeglądarce. Nie wpisuj adresu strony logowania samodzielnie. Przed podaniem danych sprawdź, czy domena to login.futuriti.pl. Zaloguj się własnym kontem xSale i zapoznaj się z prośbą o udzielenie dostępu. Linku logowania nie udostępniaj innym osobom.
5. Wróć do /mcp i sprawdź stan połączenia.

Nie dodawaj sekretu klienta ani tokenu w jego miejsce. Opis mechanizmu i opcji: oficjalna dokumentacja MCP w Claude Code.

Sprawdź odczyt

Pokaż dostępne organizacje. Nie zmieniaj danych.

Sprawdź, czy Claude Code używa xSale i pokazuje organizacje dostępne dla Twojego konta. Nie zatwierdzaj tworzenia ani zmiany danych w ramach testu.

Odśwież narzędzia

Otwórz /mcp, wybierz xSale i połącz serwer ponownie. Jeśli listy nadal nie ma, uruchom nową sesję Claude Code. Po zmianie zakresu uprawnień może być potrzebne ponowne logowanie.

Odłącz konto

Aby usunąć tę definicję oraz zapisane przez Claude Code dane OAuth dla serwera, wykonaj:

claude mcp remove xsale --scope user

Użyj tego samego zakresu, w którym dodano serwer. Usunięcie nie usuwa wcześniejszych wyników z historii i plików. Cofnięcie zgody u dostawcy logowania, jeżeli jest dostępne, wykonuje się oddzielnie.

Typowe problemy

• Nieznana opcja --client-id: zaktualizuj Claude Code i sprawdź claude mcp add --help.
• Brak obsługi automatycznej rejestracji: nie omijaj OAuth. Potrzebny jest klient zarejestrowany dla tej aplikacji.
• redirect_uri_mismatch: zatrzymaj logowanie. Sprawdź zgodność hosta, ścieżki i portu callback z rejestracją klienta.
• Brak organizacji: sprawdź konto xSale oraz jego uprawnienia.

Zobacz narzędzia MCP, przykłady pracy z AI i problemy i zgłaszanie błędów. Do zgłoszenia dodaj wersję klienta i komunikat bez tokenów, kodów OAuth i danych osobowych.

Weryfikacja dokumentacji producenta: 2026-10-20. Nie wykonano testu połączenia xSale z Claude Code.