Codex

Konfiguracja serwera MCP Hypris w kliencie Codex (OpenAI), krok po kroku.

  • OpenAI
  • Terminal
  • Logowanie OAuth
Na tej stronie

Hypris działa w kliencie Codex jako zdalny serwer MCP. Logujesz się przez OAuth 2.1 tym samym kontem co w aplikacji, bez kopiowania kluczy. Klient sam wykrywa serwer autoryzacji, otwiera okno logowania, a na ekranie zgody wybierasz workspace i zakres dostępu.

Konfiguracja

  1. Dodaj serwer komendą albo wpisz go do ~/.codex/config.toml.

  2. Zaloguj się do Hypris komendą codex mcp login.

  3. Gotowe, Codex sięga do Hypris w każdym zadaniu.

terminal
# dodaj serwer i zaloguj się przez OAuth
codex mcp add hypris --url https://mcp.staging.hypris.com
codex mcp login hypris

Sprawdź połączenie

Napisz w Codex: „Jakie bazy mam w Hypris?”. Klient powinien wywołać narzędzie search_tools, znaleźć narzędzie do listowania baz i uruchomić je przez execute_tool. Jeśli widzisz listę swoich baz, połączenie działa.

Gdy coś nie działa

  • 401 Unauthorized albo pętla logowania. Usuń serwer w kliencie, dodaj go ponownie i zaloguj się jeszcze raz. Jeśli klient pozwala wybrać typ uwierzytelnienia, zostaw OAuth.

  • Asystent nie widzi bazy albo dokumentu. Serwer pokazuje tylko to, do czego masz dostęp w wybranym workspace. Asystent może poprosić administratora o brakujące uprawnienie narzędziem create_permission_request.

  • Narzędzia się nie pojawiają. Upewnij się, że klient obsługuje transport Streamable HTTP i że adres to dokładnie https://mcp.staging.hypris.com.

Co dalej