Настройка Codex

Codex поддерживает MCP-серверы в CLI и IDE extension. Настройки хранятся в ~/.codex/config.toml Для доверенного проекта можно использовать .codex/config.toml внутри репозитория.

Вариант 1: OAuth

Создайте OAuth-приложение — см. инструкцию по созданию OAuth-приложения — со scope forms.
Добавьте MCP-сервер FormDesigner в config.toml

[mcp_servers.formdesigner]
url = "https://mcp.formdesigner.ru/v1/mcp"

Redirect URI для OAuth-приложения

По умолчанию Codex использует локальный callback на случайном порту. Если в FormDesigner OAuth-приложении нужен заранее заданный redirect URI, закрепите порт в config.toml

mcp_oauth_callback_port = 5555

[mcp_servers.formdesigner]
url = "https://mcp.formdesigner.ru/v1/mcp"

Добавьте в OAuth-приложение FormDesigner redirect URI http://127.0.0.1:5555/ и, если нужно, http://localhost:5555/ Если Codex при логине покажет redirect URI с дополнительным путём или callback ID, добавьте именно полный URI, который показал Codex.

Выполните авторизацию в терминале:

codex mcp login formdesigner

После входа откройте новый чат Codex или проверьте подключение командой /mcp в Codex CLI.

Вариант 2: client credentials

Создайте OAuth-приложение — см. инструкцию по созданию OAuth-приложения — со scope forms и включите useClientCredentials.
Сохраните client_id и client_secret в переменных окружения FORMDESIGNER_CLIENT_ID и FORMDESIGNER_CLIENT_SECRET
Добавьте конфигурацию с заголовками из переменных окружения:

[mcp_servers.formdesigner]
url = "https://mcp.formdesigner.ru/v1/mcp"
env_http_headers = { "X-Client-Id" = "FORMDESIGNER_CLIENT_ID", "X-Client-Secret" = "FORMDESIGNER_CLIENT_SECRET" }

OAuth удобнее для личного подключения. Client credentials подходят для автоматизации, контейнеров и командных окружений, где браузерный OAuth неудобен.

Проверочный запрос: попросите Codex создать тестовую форму в FormDesigner или показать список ваших форм.

Настройка Codex