1. Выберите тип подключения

    Для установленного на вашей машине сервера нужен исполняемый процесс stdio. Для уже работающего удалённого сервера нужен точный адрес Streamable HTTP; заранее выясните его способ входа.

  2. Откройте настройки

    В приложении откройте Settings → MCP servers → Add server; в расширении IDE — меню с шестерёнкой → MCP servers → Add server. Можно также работать через codex mcp add или config.toml. Личная конфигурация по умолчанию находится в ~/.codex/config.toml.

  3. Добавьте параметры

    В интерфейсе задайте имя и выберите STDIO с командой издателя либо Streamable HTTP с URL. Для CLI локальная форма — codex mcp add <имя> -- <команда> <аргументы>, удалённая — codex mcp add <имя> --url <URL_MCP>; угловые скобки здесь обозначают плейсхолдеры.

    Shell
    codex mcp add <имя> --url <URL_MCP>

  4. Сохраните и проверьте вход

    Сохраните сервер и выберите Restart в приложении или Restart extension в IDE. Для OAuth нажмите Authenticate либо выполните codex mcp login <имя>. Ключ для HTTP задавайте через переменную окружения, например bearer_token_env_var, в конфигурации, если сервер требует bearer token.

  5. Проверьте доступность инструмента

    Выполните codex mcp list; в терминальном интерфейсе откройте /mcp. Затем задайте задачу на чтение с заранее известным ответом и сверьте результат с источником.

Что проверить

  • Локальный stdio-процесс должен запускаться там, где работает Codex; облачная среда требует отдельной проверки доступности.
  • Сервер может быть сохранён, но ждать OAuth или не подключиться: проверяйте статус отдельно.
  • Если используете проектный .codex/config.toml, он применяется только к доверенному проекту.