РУКОВОДСТВА / ИНТЕГРАЦИЯ MCP

Подключить MCP-клиент к TO3D

Используйте живой HTTP endpoint v2, чтобы обнаружить инструменты TO3D из MCP-клиента. Руководство фиксирует endpoint и read-only доказательства; оно не утверждает, что протестированы все клиенты или что MCP выполняет автоматический риггинг.

Открыть документацию API и MCP Прочитать сценарий API

Проверено 27 сентября 2026

Подключиться к живому endpoint

Настройте в клиенте https://mcp.to3d.app/v2/mcp. OAuth-клиенты могут выполнить вход через TO3D WorkOS AuthKit; no-auth инструменты готовят или проверяют запрос, но генерация требует аккаунт.

Используйте путь /v2/mcp для текущего набора из 14 инструментов.
Запросите openid и email, когда клиент предлагает OAuth-области.
Вход авторизует соединение, но сам по себе не отправляет задачу генерации.

{
  "mcpServers": {
    "to3d": {
      "url": "https://mcp.to3d.app/v2/mcp"
    }
  }
}

Выполнить MCP discovery

Клиент начинает с initialize, затем запрашивает tools/list и resources/list. Это безопасные вызовы live gate; на этой странице генерация не запускается.

initialize устанавливает протокол и сведения о сервере.
tools/list возвращает имена, схемы и схемы безопасности.
resources/list возвращает ресурсы виджета, объявленные сервером.

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"your-client","version":"1.0"}}}
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}
{"jsonrpc":"2.0","id":3,"method":"resources/list","params":{}}

14 живых инструментов

Ответ v2 разделяет защищённые OAuth операции аккаунта и задач и no-auth операции подготовки и диагностики. Имена и схемы ответа — источник истины.

OAuth означает, что клиент должен предъявить сессию подключённого аккаунта.
Без аутентификации инструмент можно вызвать без токена аккаунта; это не означает бесплатную генерацию.
Подсказки только для чтения описывают аннотацию инструмента и не заменяют проверки авторизации сервера.

curl -fsS https://mcp.to3d.app/v2/mcp -H 'content-type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

Инструменты, возвращённые tools/list на live gate
Инструмент	Доступ	Назначение
`get_3d_credits`	OAuth	Прочитать доступные кредиты
`estimate_3d_generation`	OAuth	Оценить кредиты генерации
`generate_3d`	OAuth	Сгенерировать из изображения
`image-to-3d`	Без авторизации	Открыть выбор изображения
`process_image_url_to_3d`	Без авторизации	Предпросмотр URL изображения
`prepare_3d_generation`	Без авторизации	Подготовить выбранное изображение
`cancel_3d_generation`	Без авторизации	Отменить неотправленный запрос
`generate_3d_authenticated`	OAuth	Запустить подготовленную генерацию
`get_authenticated_generation`	OAuth	Проверить генерацию
`create_3d_job_from_url`	OAuth	Возобновить задание по URL
`get_3d_job_status`	OAuth	Проверить статус задания
`get_3d_result`	OAuth	Получить результат задания
`get_3d_status`	OAuth	Проверить задачу
`report_widget_diagnostic`	Без авторизации	Записать диагностику виджета

Следовать потоку задачи

Подготовьте изображение, авторизуйтесь при выборе генерации, запустите или возобновите job и прочитайте статус и результат. Сохраняйте resumeKey, intentId, jobId или taskId без изменений.

Проверьте кредиты и оценку до запроса платной генерации.
Используйте get_3d_job_status или get_3d_status для наблюдения за задачей, затем get_3d_result после сообщения сервера о завершении.
Текущий endpoint не предоставляет MCP-инструмент humanoid-риггинга; для отдельной задачи риггинга используйте REST-процесс Skin Tokens.

prepare -> authenticate -> generate_3d_authenticated -> get_3d_job_status -> get_3d_result

Границы клиента и возможностей

Web-студия и REST API имеют собственные контракты. MCP-клиент должен показывать обнаруженное и не переносить утверждения об OAuth, авто-риггинге или совместимости из другого маршрута.

Старый путь /mcp — маршрут совместимости existing-v1 и не подтверждает этот список инструментов v2.
Поддержка OAuth зафиксирована для этого live endpoint; вход в каждом клиенте всё ещё требует отдельной проверки.
В рамках этого руководства запрос генерации не выполнялся.

endpoint=https://mcp.to3d.app/v2/mcp
legacy=https://mcp.to3d.app/mcp