# Настройки Codex

`config.toml` и запускной скрипт `toolchain/run-mame-mcp.sh` хранятся в Git.
Запускайте Codex из корня репозитория или любой вложенной папки.
Корень определяется через `git rev-parse --show-toplevel`.

На каждом компьютере установите `uv` и `pyenv`. Используется локальный
pyenv Python 3.12 из `.python-version`; uv ставит только пакет `mcp<2`,
не управляет версией Python. По умолчанию сервер расположен в соседнем
`../MAME/src/mame_mcp.py`. При иной раскладке задайте явный путь.

Если расположение отличается, создайте `.codex/mame.local.env` (игнорируется Git):

```sh
MAME_UV="/opt/homebrew/bin/uv"
MAME_MCP_SCRIPT="/путь/к/MAME/src/mame_mcp.py"
MAME_PYTHON="/путь/к/pyenv/versions/3.12/bin/python"
```

Путь к серверу может быть абсолютным или относительно корня проекта.
Пути к uv/Python могут быть абсолютными или именами из PATH; если
`MAME_PYTHON` не задан, скрипт вызывает `pyenv which python`.
Переменные можно также передать через окружение Codex; локальный файл имеет
приоритет. Файл читается как shell-код запускным скриптом, а не самим Codex.
Не храните в нём секреты и не добавляйте его в Git.

После изменения настроек перезапустите подключение MCP или Codex.
Инициализация MCP не требует запущенного эмулятора; для команд отладки нужен
MAME с `mame_bridge.lua` (см. `docs/mame-autotest.md`).