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
Identyfikator klienta OAuth	HLdQzTtL9KZO6yYm5OpHkellPGOCV81V
Sekret klienta	Nie jest wymagany. Pozostaw puste pole.

Zakresy openid email służą logowaniu. Nie oznaczają uprawnień tylko do odczytu w xSale. Nie wpisuj adresu wystawcy jako adresu serwera MCP.

Jak połączyć

1. Sprawdź wersję i opcje lokalnego klienta: codex --version oraz codex mcp add --help.
2. Dodaj połączenie:

   codex mcp add xsale --url https://mcp.xsale.ai/mcp --oauth-client-id HLdQzTtL9KZO6yYm5OpHkellPGOCV81V

3. Zachowaj adres OAuth callback URL wyświetlony przez Codex. Nie zastępuj go adresem callback innej aplikacji.
4. Rozpocznij logowanie:

   codex mcp login xsale --scopes openid,email

5. W przeglądarce sprawdź domenę login.futuriti.pl, zaloguj się własnym kontem xSale i sprawdź zgodę.
6. Uruchom nową sesję Codex. Wpisz /mcp i sprawdź połączenie xSale.

Konfiguracja MCP lokalnego hosta jest współdzielona między klientami Codex. Nie oznacza to automatycznie dostępu w Codex Cloud. Dokumentacja: OpenAI Docs — MCP i polecenia CLI.

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.

Weryfikacja dokumentacji producenta: 2026-10-20. Zasady logowania i retencji: OpenAI Docs — Authentication. Nie wykonano testu połączenia z xSale w Codex.