Streamable HTTP

MCP-сервер Omni Router

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

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

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-баланса.
`generate_image`	Codex OAuth или Omni Credits	Требует явный `source: codex \| credits`. Credits-режим принимает до восьми reference images.
`get_image_generation`	Omni Credits	Проверяет durable job по `job_id` и возвращает image IDs после завершения.
`download_image`	Omni Credits	Скачивает готовое RU-stored изображение и возвращает MCP image content block с фактическим MIME.

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

Одно MCP-подключение авторизуется одним ключом. Если нужны оба image-источника, зарегистрируйте два MCP-подключения с разными локальными переменными окружения.

Credits image workflow

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

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

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

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

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

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

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