Harness – Codex

Połącz lokalny Codex z xSale MCP, aby sprawdzać dane xSale z rozmowy. Instrukcja obejmuje Codex CLI oraz lokalną aplikację i rozszerzenie korzystające z tej samej konfiguracji hosta.

Wymagania

• Aktywne konto xSale z dostępem do właściwej organizacji.
• Aktualny Codex CLI i przeglądarka na komputerze.
• Konto OpenAI dopuszczone w firmie oraz zgoda administratora, jeśli polityka firmy ogranicza serwery MCP.

Najpierw zabezpiecz dane

Nie przekazuj danych osobowych ani poufnych do trenowania modeli AI. Dotyczy to też odpowiedzi narzędzi: danych klientów, zamówień, cen zakupu i dokumentów. Przed połączeniem wyłącz wykorzystanie treści do ulepszania modeli w ustawieniach konta. Sprawdź także osobne ustawienie udostępniania pełnych środowisk w Codex, jeśli jest dostępne. Jeśli nie możesz potwierdzić tych ustawień, nie pobieraj danych produkcyjnych.

Przy logowaniu kontem ChatGPT obowiązują zasady tego obszaru roboczego. Przy logowaniu kluczem API obowiązują ustawienia organizacji API. Sprawdź czas przechowywania danych i dostęp do historii, logów oraz plików lokalnych. Wyłączenie treningu nie oznacza braku przechowywania. Nie umieszczaj haseł ani tokenów w rozmowie i repozytorium.

Na początek korzystaj wyłącznie z odczytu. Polecenie „nie zmieniaj danych” wyraża zamiar, ale nie blokuje technicznie zapisu. Uprawnienia konta xSale i dostępne narzędzia muszą odpowiadać zakresowi pracy. Zobacz zasady bezpieczeństwa danych.

Dane połączenia

Nazwa	xSale
Transport	Streamable HTTP
Adres MCP	https://mcp.xsale.ai/mcp
Logowanie	OAuth, wystawca https://login.futuriti.pl/
Zakresy logowania	openid email xsale production mcp::read
Identyfikator klienta OAuth	HLdQzTtL9KZO6yYm5OpHkellPGOCV81V
Sekret klienta	Nie jest wymagany. Pozostaw puste pole.

Polecenie logowania poniżej zawiera zakresy openid,email,xsale,production,mcp::read. Dostęp do danych zależy również od uprawnień Twojego konta xSale. Nie wpisuj adresu wystawcy jako adresu serwera MCP.

Jak połączyć

Poniższe kroki wykonaj w terminalu na swoim komputerze, np. w PowerShell na Windowsie lub aplikacji Terminal na macOS. Poleceń zaczynających się od codex nie wpisuj w rozmowie z asystentem. Wklejaj je pojedynczo do terminala i zatwierdzaj klawiszem Enter.

1. Sprawdź instalację Codex CLI.

   codex --version

   Wyświetlenie numeru wersji oznacza, że Codex CLI jest zainstalowany i dostępny w tym terminalu. Jeśli polecenie nie zostanie rozpoznane, sprawdź instalację i dostępność programu, a następnie otwórz terminal ponownie. Samo zainstalowanie aplikacji graficznej nie potwierdza dostępności polecenia w terminalu.

   Sprawdź też, czy Twoja wersja obsługuje opcję --oauth-client-id:

   codex mcp add --help

   Jeśli nie ma jej w pomocy, zaktualizuj Codex CLI przed kontynuowaniem.

2. Dodaj połączenie z xSale.

   codex mcp add xsale --url https://mcp.xsale.ai/mcp --oauth-client-id HLdQzTtL9KZO6yYm5OpHkellPGOCV81V -c mcp_oauth_callback_port=7026 -c mcp_oauth_callback_url=http://127.0.0.1:7026/callback/zQi8YDhWBC3n

   Wklej całe polecenie jako jeden wiersz. xsale to nazwa połączenia używana w dalszych poleceniach. Nie dopisuj hasła ani sekretu klienta. Jeśli połączenie o tej nazwie już istnieje, najpierw sprawdź je poleceniem codex mcp get xsale; nie usuwaj go automatycznie.

   Codex może od razu rozpocząć logowanie podczas dodawania serwera. Postępuj zgodnie z komunikatem w terminalu, a następnie wykonaj poniższe polecenie logowania z podanymi zakresami. Sam komunikat o dodaniu serwera nie oznacza jeszcze, że konto xSale zostało połączone.

3. Zaloguj się do xSale.

   codex mcp login xsale --scopes openid,email,xsale,production,mcp::read -c mcp_oauth_callback_port=7026 -c mcp_oauth_callback_url=http://127.0.0.1:7026/callback/zQi8YDhWBC3n

   Polecenie dotyczy konta xSale. Jest to osobne logowanie od konta używanego do korzystania z Codexa.

4. Zaloguj się w przeglądarce.

   Postępuj zgodnie z komunikatem w terminalu. Jeśli przeglądarka nie otworzy się automatycznie, otwórz podany przez Codex link. Przed wpisaniem danych sprawdź domenę login.futuriti.pl. Zaloguj się własnym kontem xSale, przeczytaj zakres żądanego dostępu i zaakceptuj go, jeśli jest zgodny z Twoim zamiarem. Wróć do terminala i sprawdź, czy logowanie zakończyło się powodzeniem. Nie udostępniaj linku logowania ani kodów autoryzacji.

   Jeżeli pojawi się błąd invalid_client lub redirect_uri_mismatch, przerwij konfigurację i skontaktuj się ze wsparciem xSale. Adres powrotu logowania musi być obsługiwany przez konfigurację xSale. Nie zastępuj go adresem z instrukcji Claude Code i nie dodawaj przełącznika --callback-port, którego polecenie codex mcp add nie obsługuje.

5. Sprawdź zapisaną konfigurację.

   codex mcp get xsale

   Sprawdź, czy adres serwera to https://mcp.xsale.ai/mcp. Wyświetlenie konfiguracji potwierdza jej zapisanie, ale nie zastępuje testu dostępu do danych.

6. Uruchom nową sesję Codex.

   codex

   Jeśli program poprosi o zalogowanie do konta używanego z Codexem, postępuj zgodnie z jego instrukcjami. Następnie w uruchomionym Codexie wpisz /mcp i sprawdź dostępność xSale. Wykonaj test opisany w sekcji Sprawdź odczyt. Dopiero poprawna odpowiedź z danymi właściwej organizacji potwierdza możliwość korzystania z połączenia.

Instrukcja dotyczy lokalnego Codex CLI. Dostępność połączenia w innych aplikacjach zależy od tego, czy korzystają z tej samej konfiguracji. Nie oznacza to automatycznie dostępu w Codex Cloud. Szczegóły: oficjalna dokumentacja MCP w Codex.

Sprawdź odczyt

Wyślij:

Pokaż dostępne organizacje. Nie zmieniaj danych.

Sprawdź, czy odpowiedź pochodzi z narzędzia xSale i wskazuje oczekiwaną organizację. Brak dostępu jest wynikiem testu; nie próbuj omijać uprawnień. Nie zatwierdzaj zapisu w ramach tego testu.

Odśwież narzędzia i odłącz konto

Po zmianie listy narzędzi uruchom ponownie lokalnego klienta, rozpocznij nową rozmowę i sprawdź /mcp. Jeśli sesja OAuth wygasła, zaloguj się ponownie.

Aby usunąć lokalną autoryzację i konfigurację, wykonaj kolejno:

codex mcp logout xsale
codex mcp remove xsale

Usunięcie połączenia nie usuwa wcześniejszych rozmów ani raportów. Cofnięcie zgody po stronie dostawcy to osobna operacja, jeżeli konto udostępnia taką funkcję.

Typowe problemy

• Nieznana opcja --oauth-client-id: zaktualizuj Codex i sprawdź pomoc polecenia.
• invalid_client lub redirect_uri_mismatch: zatrzymaj logowanie. To błąd rejestracji klienta; zmiana hasła go nie naprawi. Callback i Client ID wymagają zgodności po stronie logowania.
• Brak organizacji: sprawdź konto xSale i jego uprawnienia.
• Brak narzędzi: sprawdź adres /mcp, stan logowania i uruchom nową sesję.

Zobacz narzędzia MCP, przykłady pracy z AI oraz rozwiązywanie problemów. Do zgłoszenia dołącz wersję klienta i oczyszczony komunikat błędu. Nie dołączaj tokenów, kodów OAuth ani pełnego adresu powrotnego z parametrami.

Polecenia zaktualizowano 29.10.2026 zgodnie z konfiguracją przekazaną przez xSale. Nie wykonano testu połączenia z xSale w Codex. Zasady logowania i retencji: OpenAI Docs — Authentication.