MCP-сервер ToRun
Последнее обновление: 11 нояб. 2026
Что это такое
MCP-сервер ToRun позволяет агенту для программирования использовать ToRun, пока он работает над вашим проектом. Агент, поддерживающий удалённые MCP-серверы, например Claude Code, Cursor или opencode, может создавать изображения, речь, музыку и видео, редактировать изображения, расшифровывать аудио, запускать глубокие исследования и шаблоны рабочих процессов ToRun и публиковать HTML-страницу или браузерную игру по ссылке — и всё это без выхода из вашего редактора. То, что создаёт агент, оплачивается из вашего аккаунта ToRun по тем же ценам, что и в приложении, и сохраняется в вашем аккаунте ToRun, как всё, что вы создаёте в приложении.
Адрес и вход
| Адрес сервера | https://mcp.torun.ai/mcp |
| Транспорт | HTTP (удалённый MCP-сервер) |
| Вход | Authorization: Bearer <your developer key> |
Ключ разработчика начинается с trn_live_. Вы создаёте его на странице «Разработчикам» в своём аккаунте ToRun: см. Ключи разработчика. Настройка для каждого инструмента:
Инструменты
| Инструмент | Что делает | Платный |
|---|---|---|
image_generate |
Создаёт изображения по промпту: спрайты, иконки, фоны, иллюстрации. Возвращает изображения или id задания, если они создаются дольше, чем агент решил ждать. | Да |
image_edit |
Изменяет изображение по письменной инструкции: новый фон, другой цвет, добавленный или удалённый объект, другой стиль. Изображение — созданное агентом с помощью ToRun или ссылка на файл PNG, JPEG или WebP размером до 20 МБ; изображение, переданное по ссылке, сначала сохраняется в вашей библиотеке ToRun. Возвращает изображения или id задания, как image_generate. |
Да |
tts_generate |
Превращает текст в речь и возвращает аудиофайл и его длительность, измеренную по файлу. | Да |
stt_transcribe |
Превращает речь из аудио- или видеофайла в текст, с размеченными по времени фрагментами для субтитров, если агент их запрашивает. Принимает файлы mp3, m4a, wav, webm, ogg, opus, flac, aac и mp4 размером до 25 МБ. | Да |
music_generate |
Сочиняет трек с вокалом или без и возвращает id задания. | Да |
video_generate |
Создаёт короткий клип по промпту и возвращает id задания. | Да |
job_status |
Сообщает о ходе задания на изображение, музыку или видео и возвращает файл, когда он готов. | Бесплатно |
deep_research_start |
Запускает глубокое исследование по вопросу: ищет в интернете по множеству источников и пишет отчёт со ссылками на источники. Возвращает id задания. | Да |
deep_research_status |
Сообщает о ходе глубокого исследования и возвращает отчёт, когда он готов. | Бесплатно |
workflow_template_search |
Находит шаблоны рабочих процессов ToRun — готовые многошаговые конвейеры — и показывает, что выдаёт каждый из них, сколько он обычно стоит и какие входные данные принимает. | Бесплатно |
workflow_run |
Запускает шаблон рабочего процесса с входными данными от агента и возвращает id задания. | Да |
workflow_run_status |
Сообщает о ходе запуска рабочего процесса и о том, сколько Runs он уже стоил, и возвращает результаты, когда они готовы. | Бесплатно |
canvas_publish |
Публикует по ссылке HTML-страницу из одного файла или браузерную игру. | Бесплатно |
account_balance |
Показывает остаток лимита тарифа и кошелька, а также месячный лимит и расходы этого ключа. | Бесплатно |
Ссылка на файл, которую возвращает инструмент, скачивается без входа в аккаунт, поэтому агент может сохранить файл в вашем проекте. Сохраняйте ссылку целиком, включая часть после вопросительного знака.
Опубликованная страница не попадает в каталог: открыть её может любой, у кого есть ссылка, но она не показывается в разделе «Обзор» ToRun, и поисковые системы её не индексируют.
Долгие задания
Музыка, видео, глубокие исследования и запуски рабочих процессов занимают больше времени, чем один вызов. Инструмент возвращает id задания, и агент спрашивает снова, пока результат не будет готов: job_status для изображений, музыки и видео, deep_research_status для отчёта об исследовании и workflow_run_status для запуска рабочего процесса. Изображение, которое не готово за выбранное агентом время ожидания, тоже возвращается как id задания.
Исследование занимает от 1 до 10 минут и продолжается, даже если разговор с агентом закончился; отчёт также появляется отдельным разговором в вашем списке чатов ToRun. Запуск рабочего процесса занимает от минуты до десятков минут, а сам запуск и его файлы появляются в вашем аккаунте ToRun. Длинный отчёт или длинный набор результатов приходит частями, и агент запрашивает остальное.
Как оплачиваются вызовы
- Каждый платный вызов списывается в Runs по тем же ценам, что и в приложении.
- Сначала он оплачивается из лимита вашего тарифа, затем из кошелька, если вы разрешили это для ключа.
- Бесплатный лимит никогда не оплачивает вызовы API.
- Запуск рабочего процесса оплачивается пошагово по мере выполнения.
- Каждое списание отображается на странице биллинга под ключом, который его сделал.
Вызов дороже порога ключа сначала спрашивает
У каждого ключа есть порог. Если один вызов стоил бы больше, инструмент пока его не выполняет. Для запуска рабочего процесса сравнивается его оценочная стоимость.
- Если ваш инструмент умеет показывать форму, когда MCP-сервер задаёт вопрос (MCP elicitation), ToRun спрашивает вас там: форма показывает цену и спрашивает, продолжать ли. Если вы соглашаетесь, вызов выполняется; если отказываетесь, ничего не запускается.
- Иначе инструмент отвечает ценой, агент показывает её вам, и вызов выполняется только тогда, когда агент повторяет его после вашего согласия.
За сам вопрос ничего не списывается.
Ограничения
У каждого ключа есть месячный и дневной лимит расходов, а также лимит вызовов в минуту. У каждого аккаунта также есть дневной лимит опубликованных страниц. Месячный лимит и порог ключа вы задаёте при его создании; значения по умолчанию указаны на torun.ai/developers. Чтобы их изменить, создайте новый ключ с нужными настройками и отзовите старый.
Когда вызов отклонён
| Что сообщают агенту | Что делать |
|---|---|
| Для вызова нужен ключ разработчика | Проверьте, что в TORUN_API_KEY записан весь ключ и что ключ не отозван. |
| Лимит тарифа исчерпан, а ключу нельзя тратить из кошелька | Дождитесь обновления лимита или создайте ключ, которому можно тратить из кошелька. |
| Ключи разработчика тратят только лимит платного тарифа или кошелёк | Пополните баланс или оформите подписку. |
| Ключ достиг месячного или дневного лимита расходов | Дождитесь следующего дня или месяца или создайте ключ с более высоким лимитом. |
| Ключ сделал слишком много вызовов за минуту | Подождите немного и повторите попытку. |
| У ключа нет области, нужной инструменту | Области ключа изменить нельзя. Создайте новый ключ: новый ключ получает все области. |
| Файл нужно указать как id из библиотеки ToRun или как https-ссылку, но не то и другое сразу | Укажите ровно одно из двух. |
| В библиотеке ToRun аккаунта нет такого файла | Используйте файл этого аккаунта. Ссылка ToRun на файл другого аккаунта отклоняется так же. |
| Файл слишком большой, не в том формате, который принимает инструмент, или его не удалось скачать | Изображения для image_edit: PNG, JPEG или WebP, до 20 МБ. Файлы для stt_transcribe: mp3, m4a, wav, webm, ogg, opus, flac, aac или mp4, до 25 МБ. Ссылка должна скачиваться без входа в аккаунт. |