Паветта
Как подключить MCP-сервер к Codex
Codex хранит MCP-серверы в ~/.codex/config.toml, общем для Codex CLI, расширения для IDE и приложения ChatGPT на компьютере. Поддерживаются stdio и Streamable HTTP.
Где лежит конфиг
~/.codex/config.tomlДля всех проектов.codex/config.tomlДля одного проекта, только в доверенных проектахКак добавить сервер
1
Командой, локальный сервер
codex mcp add context7 -- npx -y @upstash/context7-mcp. Переменные окружения ставьте до разделителя: --env VAR1=VALUE1 --env VAR2=VALUE2 -- <команда>.
2
Командой, удалённый сервер
codex mcp add example --url https://mcp.example.com. Флаг --url идёт после имени сервера.
3
Через файл
Таблица [mcp_servers.<имя>] в config.toml: command и args для локального сервера, url для удалённого.
4
В расширении для IDE
Меню с шестерёнкой → MCP servers → Add server. Настройки общие с CLI и приложением.
Как проверить и удалить
ПроверкаВ интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Удалениеcodex mcp remove <имя> удаляет запись из конфига. Чтобы выключить сервер с сохранением настроек, впишите enabled = false в его таблицу.
Токены для HTTPbearer_token_env_var = "FIGMA_OAUTH_TOKEN" берёт токен из переменной окружения и шлёт его в заголовке Authorization. Постоянные заголовки задаёт http_headers, заголовки из переменных — env_http_headers.
Окружение для stdioenv задаёт значения переменных, env_vars пропускает к серверу переменные из вашего окружения, cwd задаёт рабочую папку.
Тайм-аутыstartup_timeout_sec — время на запуск, по умолчанию 10. tool_timeout_sec — время на вызов инструмента, по умолчанию 60.
Выбор инструментовenabled_tools — список разрешённых инструментов, disabled_tools — запрещённых. Запрет применяется после разрешения.
Вход через OAuthcodex mcp login <имя>. Если на машине нет браузера, добавьте --no-browser.
Готовые конфиги для Codex
Нажмите на сервер, чтобы раскрыть конфиг в формате Codex.
Playwright MCPДаёт агенту настоящий браузер
[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]
GitHub MCPПодключает агента к GitHub
[mcp_servers.github]
url = "https://api.githubcopilot.com/mcp/"
http_headers = { "Authorization" = "Bearer <GitHub PAT>" }
Context7 MCPПодтягивает в контекст агента свежую документацию и примеры кода…
[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"
http_headers = { "Authorization" = "Bearer <ключ Context7>" }
Figma MCPПодключает агента к макетам Figma
[mcp_servers.figma]
command = "npx"
args = ["-y", "figma-developer-mcp", "--stdio"]
[mcp_servers.figma.env]
FIGMA_API_KEY = "<ваш токен Figma>"
Chrome DevTools MCPДаёт агенту живой Chrome с инструментами DevTools
[mcp_servers.chrome-devtools]
command = "npx"
args = ["-y", "chrome-devtools-mcp@latest"]
Filesystem MCPОткрывает агенту доступ к файлам в папках, которые вы перечислили при…
[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Desktop", "/path/to/other/allowed/dir"]
Fetch MCPДаёт агенту читать веб-страницы
[mcp_servers.fetch]
command = "uvx"
args = ["mcp-server-fetch"]
Memory MCPДаёт агенту долгую память между чатами
[mcp_servers.memory]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-memory"]
[mcp_servers.memory.env]
MEMORY_FILE_PATH = "<полный путь>/memory.jsonl"
Supabase MCPПодключает агента к проектам Supabase
[mcp_servers.supabase]
url = "https://mcp.supabase.com/mcp"
Notion MCPЛокальный сервер Notion поверх Notion API
[mcp_servers.notion]
command = "npx"
args = ["-y", "@notionhq/notion-mcp-server"]
[mcp_servers.notion.env]
NOTION_TOKEN = "ntn_<токен интеграции>"
Blender MCPСвязывает агента с запущенным Blender
[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]
1С MCPПоказывает агенту метаданные и содержимое базы 1С:Предприятие
[mcp_servers.1c]
url = "http://<веб-сервер>/<имя публикации>/hs/mcp/"
http_headers = { "Authorization" = "Basic <логин и пароль пользователя 1С>" }Ограничения
!
Транспорта SSE в списке нет: только STDIO и Streamable HTTP.
!
Проектный .codex/config.toml работает только в доверенных проектах.
!
Произвольный заголовок командой codex mcp add не добавить: для токена есть --bearer-token-env-var, остальные заголовки прописывают в http_headers.
Если не работает
Сервер долго стартует и отваливается при запуске
Увеличьте startup_timeout_sec в таблице сервера: по умолчанию на запуск отводится 10 секунд.
Инструмент обрывается на долгих задачах
Поднимите tool_timeout_sec, по умолчанию он равен 60 секундам.
Частые вопросы
Где у Codex файл с MCP-серверами?
В ~/.codex/config.toml. В доверенном проекте можно держать отдельный .codex/config.toml. Тот же файл читают расширение для IDE и приложение ChatGPT на компьютере.
Как передать токен удалённому серверу?
Положите токен в переменную окружения и укажите её имя в bearer_token_env_var. Тогда токен не попадёт в config.toml.
Как временно выключить сервер?
Впишите enabled = false в таблицу [mcp_servers.<имя>]. Запись останется, Codex просто не будет её запускать.
Codex подключается к серверам по SSE?
В списке транспортов Codex только STDIO и Streamable HTTP, SSE там нет. Если у сервера есть HTTP-адрес, подключайте его через url.
Источники: learn.chatgpt.com, github.com, github.com