Универсальная настройка для программ, которые подключаются к серверам MCP по HTTP: пример для Codex, формат для Cursor и проверка через curl.
Общая схема
Любая программа, поддерживающая «удалённые серверы MCP по HTTP» (Streamable HTTP), подключается тремя данными: адрес сервера, тип подключения HTTP и заголовок Authorization: Bearer ВАШ_ТОКЕН. Токен создаётся в «Компоненты → Dharma MCP → Токены доступа» (см. статью про Claude Code).
Codex
Codex читает серверы MCP из файла настроек ~/.codex/config.toml. Пример:
[mcp_servers.dharma]
url = "https://dharma-demo.ru/index.php/mcp"
bearer_token_env_var = "DHARMA_MCP_TOKEN"Токен передайте через переменную окружения, а не записывайте в файл:
export DHARMA_MCP_TOKEN="dhmcp_…"Названия ключей зависят от версии Codex, поэтому сверьтесь со справкой вашей версии (codex mcp --help). Проверить подключение можно внутри Codex командой /mcp.
Если Codex не видит инструментов (например, «MCP не умеет менять файлы шаблона»), причин обычно три: набор «Шаблон» или «Система» выключен в плагинах Joomla; у токена нет нужной области (например, template:write); клиент держит старый список инструментов — запустите сессию заново.
Запасной способ без настройки MCP: Codex может сам вызывать сервер командой curl из терминала. Тогда у него должен быть доступ к сети и токен в окружении:
curl -s -X POST https://dharma-demo.ru/index.php/mcp \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $DHARMA_MCP_TOKEN" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Cursor и подобные программы
Добавьте в файл настроек MCP (для Cursor это ~/.cursor/mcp.json или .cursor/mcp.json в проекте):
{
"mcpServers": {
"dharma": {
"url": "https://dharma-demo.ru/index.php/mcp",
"headers": { "Authorization": "Bearer ВАШ_ТОКЕН" }
}
}
}Antigravity и другие
В настройках MCP добавьте сервер с адресом и заголовком Authorization из общей схемы. Имена полей у программ разные (url, serverUrl, httpUrl) — смотрите справку конкретной программы.
Как проверить, что адрес и токен верны
Любая программа, которая «не видит» сервер, проверяется командой curl: ответ со списком инструментов (tools) означает, что адрес и токен верны, а проблема в настройке программы. Ответ 401 — неверный или отозванный токен; 403 — запрос блокирует защита хостинга или у токена нет доступа (см. «Если что-то не работает»).