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ć

1. Sprawdź wersję: claude --version.
2. Dodaj serwer w konfiguracji użytkownika:

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

3. Uruchom claude, wpisz /mcp, wybierz xSale i rozpocznij uwierzytelnianie.
4. Sprawdź domenę login.futuriti.pl, zaloguj się własnym kontem i przeczytaj zgodę.
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.