Документация по API

MCP-сервер

Подключение ИИ-сервисов Problembo к ChatGPT, Claude, Cursor, VS Code и другим ассистентам через Model Context Protocol: адрес сервера, вход, инструменты, оплата и ошибки.

Что это

MCP-сервер Problembo подключает ИИ-сервисы Problembo к ассистентам с поддержкой Model Context Protocol: ChatGPT, Claude, Claude Code, Cursor, VS Code, Codex и другим. Вы пишете задачу обычным текстом, например «убери фон с этого фото» или «сделай 5-секундное видео из этой картинки». Ассистент сам выбирает сервис и модель, узнаёт цену, запускает задачу и возвращает ссылку на результат.

Сервер работает поверх того же Client API, что и REST-интеграции: те же модели, цены, проверка параметров и история задач в личном кабинете.

Адрес сервера:

https://mcp.problembo.com/mcp

Транспорт — Streamable HTTP, вход — OAuth через аккаунт Problembo. Для серверных сценариев без браузера подходит .

Что доступно

Сервис	Инструмент
Генерация изображений	`generate_image`
ИИ-редактор фото, расширение кадра	`edit_image`
Генерация видео	`generate_video`
Увеличение и улучшение фото	`upscale_image`
Удаление фона	`remove_background`
Удаление объектов	`submit_task`
Виртуальная примерка	`submit_task`
Озвучка текста	`submit_task`
Генерация музыки	`submit_task`
Улучшение видео: апскейл, FPS, стабилизация	`submit_task`
Обучение модели изображений (LoRA)	`submit_task`

Актуальный список ассистент получает инструментом list_services, модели и их параметры — инструментом list_models.

Подключение

Во всех клиентах указывается один адрес: https://mcp.problembo.com/mcp. При первом обращении клиент откроет страницу входа Problembo. Войдите в аккаунт и разрешите доступ. Если аккаунта нет, он будет создан при входе.

Названия пунктов меню у клиентов меняются, а доступность собственных MCP-серверов зависит от тарифа клиента. Если шаги ниже не совпадают с вашим интерфейсом, ищите раздел с названием «Connectors», «Apps», «Plugins» или «MCP».

ChatGPT

Откройте настройки ChatGPT и раздел подключаемых приложений (Apps / Plugins).
Добавьте собственный MCP-сервер, указав название Problembo и адрес https://mcp.problembo.com/mcp.
Выберите аутентификацию OAuth и войдите в аккаунт Problembo.
В новом чате выберите Problembo в списке инструментов и опишите задачу.

Claude и Claude Desktop

Откройте Settings → Connectors и добавьте свой коннектор (Add custom connector).
Укажите название Problembo и адрес https://mcp.problembo.com/mcp.
Нажмите Connect и войдите в аккаунт Problembo.

Коннектор привязан к аккаунту Claude, поэтому работает и в веб-версии, и в Claude Desktop.

Claude Code

claude mcp add --transport http --scope user problembo https://mcp.problembo.com/mcp

Затем выполните /mcp в сессии Claude Code и пройдите вход в браузере.

Cursor

Добавьте сервер в ~/.cursor/mcp.json (для всех проектов) или .cursor/mcp.json (для одного проекта):

{
  "mcpServers": {
    "problembo": {
      "url": "https://mcp.problembo.com/mcp"
    }
  }
}

VS Code

Выполните команду MCP: Add Server, выберите HTTP и укажите адрес сервера. Или добавьте его в .vscode/mcp.json:

{
  "servers": {
    "problembo": {
      "type": "http",
      "url": "https://mcp.problembo.com/mcp"
    }
  }
}

Codex

codex mcp add problembo --url https://mcp.problembo.com/mcp
codex mcp login problembo

Подключение по API-токену

Для скриптов, CI и клиентов без браузерного входа передавайте API-токен в заголовке Authorization:

{
  "mcpServers": {
    "problembo": {
      "url": "https://mcp.problembo.com/mcp",
      "headers": {
        "Authorization": "Bearer pbo_pat_ВАШ_ТОКЕН"
      }
    }
  }
}

Токен даёт полный доступ: и чтение, и запуск платных задач. Не храните его в репозитории.

Права доступа

При входе через OAuth клиент запрашивает два разрешения:

Разрешение	Что открывает
`problembo:read`	Список сервисов и моделей, баланс, оценка цены, статус и результаты задач этого аккаунта
`problembo:generate`	Запуск платных задач и загрузка входных файлов

Доступ, выданный ассистенту, действует только на MCP-сервере: открыть с ним сайт или другие API Problembo нельзя.

Оплата

Задачи через MCP оплачиваются только с платного баланса, бонусный баланс для них не используется. Пополнить баланс можно на странице Платежи.
Цены такие же, как у API: платите за запущенные задачи, без подписки.
Инструмент estimate_price показывает цену и примерное время выполнения до запуска и проверяет, хватает ли баланса. Ничего не запускается и не списывается.
При запуске цена резервируется. Если задача завершится ошибкой, резерв возвращается.
В ответе каждой задачи есть объект billing: state — NONE, RESERVED (сумма удерживается, пока задача выполняется), CHARGED или REFUNDED, а amountUsd — сумма.
Повтор вызова с тем же idempotencyKey не создаёт вторую задачу и не списывает деньги повторно.

Как выполняется задача

Ассистент вызывает инструмент сервиса, например edit_image.
Сервер ждёт результат до 25 секунд. Быстрые задачи возвращают результат сразу.
Если задача ещё выполняется, ассистент получает taskId и проверяет статус инструментом get_task. Видео, обучение LoRA и другие долгие задачи могут выполняться несколько минут.
Готовый результат приходит как список файлов со ссылками на скачивание.

Ссылки на результаты временные. Сохраните файлы, которые нужны надолго. Все задачи, запущенные через MCP, также видны в истории задач.

Входные файлы

Инструменты принимают файл одним из способов:

публичная ссылка http/https — Problembo сам скачает файл;
ссылка на прошлый результат — например, чтобы увеличить только что сгенерированное изображение;
fileId — для локальных файлов: create_upload выдаёт ссылку для загрузки, файл отправляется одним PUT-запросом, затем complete_upload подтверждает загрузку.

Загрузка через create_upload требует, чтобы клиент умел отправлять HTTP-запросы. Так работают Claude Code, Codex, Cursor и другие агенты с доступом к файлам и сети. В чат-клиентах без такой возможности передайте файл публичной ссылкой.

Инструменты

Инструмент	Что делает	Разрешение
`list_services`	Список сервисов и инструмент для каждого	read
`describe_service`	Параметры, примечания и формат результата сервиса	read
`list_models`	Модели сервиса: id, количество результатов, соотношения сторон, разрешения	read
`get_balance`	Платный и бонусный баланс, зарезервированная сумма	read
`estimate_price`	Цена, примерное время и хватает ли баланса — без запуска	read
`get_task`	Статус, результат и оплата задачи	read
`create_upload`	Ссылка для загрузки входного файла	generate
`complete_upload`	Подтверждение загруженного файла	generate
`generate_image`	Генерация изображений по тексту и референсам	generate
`edit_image`	Правка фото по текстовой инструкции	generate
`generate_video`	Генерация видео по тексту, кадрам и референсам	generate
`upscale_image`	Увеличение и улучшение изображений	generate
`remove_background`	Удаление фона	generate
`submit_task`	Остальные сервисы с параметрами из `describe_service`	generate

Схемы параметров инструментов строятся из контрактов Client API, поэтому совпадают с REST API.

Примеры запросов к ассистенту

«Сколько у меня денег на Problembo?»
«Сгенерируй через Problembo логотип кофейни в стиле линогравюры, квадрат, 2 варианта. Сначала скажи цену».
«Замени на этом фото фон на зимний лес: https://example.com/photo.jpg»
«Убери фон с картинки и увеличи результат в 2 раза».
«Сделай 5-секундное видео, где камера медленно приближается к этому кадру».
«Озвучь этот текст мужским голосом».

Ошибки

Ошибка инструмента приходит с isError: true и объектом error:

{
  "error": {
    "key": "BILLING_ACCESS_DENIED",
    "message": "..."
  }
}

`key`	Что случилось	Что делать
`BILLING_ACCESS_DENIED`	Не хватает платного баланса	Пополните баланс
`PARSE_TASK`	Неверные или неподдерживаемые параметры	Проверьте модель и опции через `list_models`
`SECURE`	Подключению не хватает разрешения	Переподключите сервер и разрешите `problembo:generate`
`UNAUTHENTICATED`	Нет входа или срок доступа истёк	Войдите заново в настройках клиента
`NOT_FOUND`	Задача не найдена или принадлежит другому аккаунту	Проверьте `taskId`
`SD_PROMPT_NOT_SAFE`	Запрос не прошёл модерацию	Переформулируйте запрос

Полный список ключей — в документации API.

Проверка и отладка

Проверить сервер без ассистента можно в MCP Inspector:

npx @modelcontextprotocol/inspector

Укажите транспорт Streamable HTTP, адрес https://mcp.problembo.com/mcp и войдите через OAuth или добавьте заголовок Authorization: Bearer pbo_pat_….

Отключение

Удалите сервер в настройках клиента. Если подключение шло по API-токену, отзовите токен в личном кабинете.

Поддержка

Email: support@problembo.com
Telegram: @problembo_support

При обращении укажите taskId и название клиента (ChatGPT, Claude, Cursor и т. д.).

Последнее обновление: 20 октября 2026

Улучшение промптов через API

Как синхронно улучшать промпты для генерации изображений и видео через Problembo Client API, передавать кадры и обрабатывать ошибки.

Помощь

Ответы на частые вопросы о входе, оплате, ежедневном бонусе, задачах и результатах, аккаунте Problembo и партнёрской программе.