Интеграция с ИИ

Meshy предоставляет два канала для ИИ-агентов и помощников по программированию: сервер Meshy MCP для вызова инструментов и llms.txt / llms-full.txt для поглощения документации.

Если вы интегрируете Meshy из Claude Code, Cursor, Windsurf, Codex или любого другого инструмента, совместимого с MCP, установите сервер MCP ниже. Если вы интегрируете из простого чат-агента без поддержки MCP, направьте его на https://docs.meshy.cn/llms.txt.

Что такое MCP

Model Context Protocol (MCP) — это открытый стандарт, который позволяет ИИ-помощникам вызывать внешние инструменты и получать структурированный контекст. Сервер Meshy MCP оборачивает Meshy REST API в набор инструментов, которые ваш агент может вызвать — сгенерировать модель, проверить задачу, скачать результат — без ручного написания кода HTTP.

Сервер MCP является открытым исходным кодом и опубликован на npm как @meshy-ai/meshy-mcp-server. Исходный код: github.com/meshy-dev/meshy-mcp-server.

Вам нужен API-ключ Meshy. Создайте его на https://www.meshy.ai/settings/api. Сервер MCP считывает его из переменной окружения MESHY_API_KEY.

Быстрая установка

# Detects installed AI clients and configures Meshy for each
npx add-mcp @meshy-ai/meshy-mcp-server --env MESHY_API_KEY=msy_YOUR_API_KEY

Предпочитаете готовый навык? Открытый исходный код meshy-3d-agent поставляется с заранее написанными рабочими процессами Meshy (генерация → опрос → загрузка) для Claude Code, Cursor и OpenClaw. Он вызывает Meshy REST API напрямую — сервер MCP не требуется.

npx skills add meshy-dev/meshy-3d-agent

Доступные инструменты

Сервер MCP предоставляет Meshy REST API как инструменты, сгруппированные по возможностям.

3D Генерация

  • meshy_text_to_3d — создать 3D-модель из текстового запроса
  • meshy_image_to_3d — создать 3D-модель из одного изображения
  • meshy_multi_image_to_3d — создать 3D-модель из нескольких изображений одного и того же объекта
  • meshy_text_to_3d_refine — добавить текстуру к предварительной сетке

Постобработка

  • meshy_remesh — изменить topology и/или число полигонов существующей модели
  • meshy_retexture — применить новую текстуру к существующей модели
  • meshy_rig — добавить скелет к 3D-гуманоидному персонажу
  • meshy_animate — применить анимацию к персонажу с rig

Генерация изображений

  • meshy_text_to_image — 2D-изображение из текста
  • meshy_image_to_image — 2D-изображение из эталонного изображения

Управление задачами

  • meshy_get_task_status — проверить статус задачи и URL для загрузки
  • meshy_list_tasks — перечислить последние задачи, при необходимости отфильтрованные по типу/статусу
  • meshy_cancel_task — отменить ожидающую или выполняющуюся задачу
  • meshy_download_model — получить завершенный файл модели и сохранить локально

Рабочая область

  • meshy_list_models — перечислить все модели в рабочей области аутентифицированного пользователя

3D-печать

  • meshy_send_to_slicer — обнаружить установленные слайсеры и запустить модель в одном из них (работает локально на вашем компьютере; вызов Meshy API не требуется)
  • meshy_analyze_printability — в настоящее время возвращает ручной контрольный список готовности к печати (толщина стенки, свесы, многообразие сетки и т.д.). Будет обновлено до автоматического анализа, как только API пригодности к печати Meshy станет доступным.
  • meshy_process_multicolor — конвертировать текстурированную модель в многоцветный файл 3MF для печати

Аккаунт

  • meshy_check_balance — запросить оставшиеся кредиты

Названия и поведение инструментов могут изменяться. Авторитетный список находится в исходном коде сервера MCP.

Примеры запросов

Вставьте их в ваш чат с поддержкой MCP в качестве отправной точки.

Generate a 3D fox from the prompt "a cartoon fox sitting", preview it, then
texture it with PBR maps. Download the final GLB to ./outputs.

Take the image at https://example.com/sculpture.jpg and convert it into a
riggable 3D character. Use `should_remesh: true` and 50k target polycount.

What's my current Meshy credit balance?

List my last 10 successful text-to-3d tasks and download the top 3 as GLB
into ./downloads/.

llms.txt и llms-full.txt

Если ваш агент не поддерживает MCP или вы хотите напрямую ввести документацию Meshy в запрос, направьте его на наши текстовые поверхности:

  • llms.txt — компактный индекс + инструкции по интеграции (правильный асинхронный шаблон опроса, правила аутентификации, ограничения по скорости, выбор модели, распространенные ошибки).
  • llms-full.txt — каждая страница API объединена в один файл для однократного поглощения.
  • Markdown по страницам: добавьте .md к любому URL эндпоинта. Пример: https://docs.meshy.cn/api/text-to-3d.md.

Все три обновляются каждый раз при сборке сайта документации, поэтому они никогда не расходятся с HTML-документацией.

Часто задаваемые вопросы

Является ли сервер MCP без состояния?
Да. Ваш MESHY_API_KEY используется для каждого запроса и никогда не сохраняется на стороне сервера.
Стоит ли MCP столько же, сколько REST API?
Да — каждый вызов инструмента MCP соответствует одному вызову REST и потребляет кредиты с той же скоростью. См. страницу Цены для полной матрицы.
Каковы ограничения по скорости?
Сервер MCP делит ту же плоскость ограничения скорости, что и REST API. См. страницу Ограничения по скорости для ограничений по уровням.
Какие данные Meshy может получить доступ MCP?
Только те, к которым MESHY_API_KEY может получить доступ через REST. Области и разрешения идентичны.
Как сообщить о проблемах?
Создайте проблему в репозитории meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues