Sozdai LogoSozdai AIDocs
Integrations/MCP

MCP-сервер Sozdai

Подключите Sozdai к ChatGPT / Codex, Claude Code, Cursor, DSH или Hermes по MCP и создавайте изображения, видео и музыку прямо в диалоге: «сделай обложку для этого лендинга», «оживи этот скриншот в 5-секундное видео». Генерации списываются с баланса Sozdai по обычным ценам.

#Подключение одним сообщением

Выберите клиент и отправьте ему инструкцию ниже. Агент настроит подключение или поможет открыть настройки MCP. Войдите в Sozdai в браузере и разрешите доступ — копировать API-ключ не нужно. Для ChatGPT требуется право добавлять пользовательские MCP-плагины.

text
Подключи удалённый MCP-сервер Sozdai к моему текущему клиенту ChatGPT / Codex. Имя: "sozdai". Адрес: "https://api.sozdai.ai/mcp". Используй OAuth; я подтвержу доступ в браузере.

Сохрани существующие подключения. При локальной настройке используй среду и исполняемый файл текущего клиента; не смешивай Windows и WSL. Передавай имена и URL как данные через массивы аргументов. Сначала проверь существующее подключение. Не выводи учётные данные и callback URL. Не запускай платную генерацию при настройке.

Сначала определи, это Codex или ChatGPT. В Codex проверь codex mcp get sozdai; если подключения нет — codex mcp add sozdai --url https://api.sozdai.ai/mcp. Без CLI используй настройки клиента. Если вход не выполнен и нет активной авторизации, один раз запусти codex mcp login sozdai и дождись завершения. Попроси перезапустить Codex и проверить get_balance в новой сессии. В ChatGPT помоги открыть Plugins → Add custom MCP server, указать "sozdai", "https://api.sozdai.ai/mcp" и OAuth; для старого интерфейса используй Apps → Create. Я подтвержу доступ; затем выберу плагин в чате для проверки get_balance. Не запускай локальные команды Codex из ChatGPT.

Доступ появится в Консоль → API-ключи как ключ «MCP · …» — удалите его, чтобы отключить агента.

#Ручная настройка по API-ключу

ПараметрЗначение
Адрес сервераhttps://api.sozdai.ai/mcp
ТранспортStreamable HTTP
Заголовок авторизацииAuthorization: Bearer sk-corr-…

Возьмите API-ключ в консоли (начинается с sk-corr-) и замените им sk-corr-XXXX в примерах ниже. Не забудьте пополнить баланс.

#Claude Code

Выполните один раз в терминале:

bash
claude mcp add --scope user --transport http sozdai https://api.sozdai.ai/mcp --header "Authorization: Bearer sk-corr-XXXX"

Перезапустите Claude Code и введите /mcp — «sozdai» должен быть в статусе connected.

#Codex

Добавьте в ~/.codex/config.toml (в Windows: %USERPROFILE%\.codex\config.toml) и перезапустите Codex:

toml
[mcp_servers.sozdai]
url = "https://api.sozdai.ai/mcp"
http_headers = { "Authorization" = "Bearer sk-corr-XXXX" }
tool_timeout_sec = 180

tool_timeout_sec

Генерация изображения занимает 20–60 с; увеличенный таймаут не даёт Codex прервать ожидание раньше времени.

#Cursor

Settings → MCP → Add new MCP server, либо пропишите в ~/.cursor/mcp.json:

json
{
  "mcpServers": {
    "sozdai": {
      "url": "https://api.sozdai.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk-corr-XXXX"
      }
    }
  }
}

#Другие клиенты

Любой клиент с поддержкой удалённых MCP-серверов и своих заголовков (Windsurf, Cline, VS Code Copilot, Gemini CLI…) настраивается по адресу и заголовку выше. Для клиентов, которые запускают только локальные (stdio) серверы — например, конфиг Claude Desktop, — используйте мост mcp-remote (нужен Node.js):

json
{
  "mcpServers": {
    "sozdai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.sozdai.ai/mcp",
        "--header",
        "Authorization:Bearer sk-corr-XXXX"
      ]
    }
  }
}

#Инструменты

ИнструментЧто делает
list_modelsМодели изображений / видео / музыки, цены и параметры
generate_imageСоздаёт или редактирует изображение; ждёт и возвращает ссылку
generate_videoЗапускает видео (текст / первый кадр / референсы); возвращает id задачи
generate_musicЗапускает песню (описание или свой текст); возвращает id задачи
get_generationСтатус и ссылки на результат
upload_fileЗагружает локальный файл и даёт ссылку для использования во входных данных
get_balanceАккаунт и доступный баланс

Попробуйте

«Сгенерируй через sozdai обложку 16:9 — лиса в неоновом городе — и сохрани в ./public/hero.png»

Стоимость

Каждая генерация оплачивается как на сайте. Видео тарифицируется посекундно — агенту указано заранее согласовать с вами длительность и разрешение. Неудачные генерации возвращаются автоматически.

#Устранение проблем

СимптомРешение
401 / не подключаетсяПроверьте заголовок: Authorization: Bearer sk-corr-… с вашим ключом.
Недостаточно средствПополните баланс; агент покажет ссылку на пополнение.
Таймаут в CodexДобавьте tool_timeout_sec = 180 (см. выше) или попросите агента проверить через get_generation.