Streamable HTTP

MCP-сервер Omni Router

Подключите агента к одному защищённому эндпоинту для списка доступных моделей, веб-поиска и генерации изображений.

Параметры подключения

URL: https://api.omnirouter.ru/mcp
Транспорт: Stateless Streamable HTTP
Авторизация: Authorization: Bearer omni_…

Ключ выпускается в личном кабинете. Храните его в переменной окружения и не вставляйте значение в конфигурацию, командную строку или чат.

Быстрая настройка Codex

Сначала загрузите OMNIROUTER_API_KEY в окружение, затем зарегистрируйте удалённый MCP-сервер. Значение ключа в команду не попадает.

codex mcp add omnirouter \
  --url https://api.omnirouter.ru/mcp \
  --bearer-token-env-var OMNIROUTER_API_KEY

codex mcp get omnirouter

То же самое можно задать в пользовательском ~/.codex/config.toml:

[mcp_servers.omnirouter]
url = "https://api.omnirouter.ru/mcp"
bearer_token_env_var = "OMNIROUTER_API_KEY"

Формат bearer_token_env_var соответствует текущей документации Codex для Streamable HTTP.

Инструменты и оплата

Инструмент	Ключ	Поведение
`list_models`	Любой активный `omni_`	Возвращает модели, доступные именно этому ключу.
`search`	Omni Credits	Выполняет платный веб-поиск и списывает стоимость с Credits-баланса.
`image_sources / list_image_models`	Любой активный omni_	Показывает доступность генерации изображений и каталог моделей Omni Credits.
`generate_image`	Любой активный omni_	Требует явный `source: credits`. Можно передать до восьми reference images своего запроса.
`get_image_generation`	Любой активный ключ владельца	Проверяет durable job по `job_id` и возвращает image IDs после завершения.
`download_image`	Любой активный ключ владельца	Скачивает готовое изображение, хранимое в РФ, и возвращает MCP-блок изображения с фактическим MIME.

Codex: у владельца ключа должны быть подключён ChatGPT и активен Personal или Pro. Credits: нужны активный Credits-аккаунт, достаточный баланс и стабильный idempotency_key для одинаковых повторов.

Используйте ключ Omni Credits. Сначала вызовите image_sources и list_image_models с source: credits, затем выберите модель из ответа. Генерация и веб-поиск оплачиваются из баланса Omni Credits.

Сценарий генерации изображений на Credits

1. Вызовите generate_image с source: "credits", моделью, промптом и стабильным idempotency_key. Для режима «изображение в изображение» передайте input_images.
2. Если статус in_progress, опрашивайте get_image_generation с полученным job_id. Не создавайте новую генерацию.
3. Из завершённого результата возьмите image_id и вызовите download_image. Клиент получит изображение, а не URL провайдера.

MCP определяет фактический PNG, JPEG, WebP или GIF MIME. Не печатайте base64 из блока изображения в чат или логи.

Протокол и лимиты

Сервер согласовывает MCP 2025-06-18 в initialize; после этого клиент передаёт MCP-Protocol-Version. JSON-RPC batch ограничен 32 элементами. Уведомления не получают ответ; платный вызов tools/call без request ID не исполняется.

Большие ответы и входные изображения буферизуются в памяти в рамках лимита MCP. Для очень больших файлов используйте прямой /v1/images/generations вместо MCP.

Границы доступа

MCP-сервер не открывает агенту OmniCode, файловую систему, терминал, репозитории, сессии агентов или администрирование аккаунта. Он не проксирует сторонние MCP-серверы и не принимает произвольные URL.