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

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

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

Что такое MCP

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

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

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

# 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

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

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

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

3D-генерация

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

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

• meshy_remesh: изменяет topology и/или число полигонов существующей модели
• meshy_retexture: применяет новую текстуру к существующей модели
• meshy_rig: добавляет скелет человекоподобному 3D-персонажу
• meshy_animate: применяет анимацию к персонажу со скелетом
• meshy_convert: конвертирует модель в другой формат файла
• meshy_resize: изменяет размер модели до реальных размеров
• meshy_uv_unwrap: создаёт новую UV-раскладку для модели

Creative Lab

• meshy_creative_lab: превращает фото в готовый продукт Creative Lab (запускает задачи создания прототипа и сборки)

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

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

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

• meshy_get_task_status: проверяет статус задачи и URL для скачивания
• meshy_list_tasks: выводит список недавних задач, с возможностью фильтрации по типу/статусу
• meshy_cancel_task: удаляет задачу. Задача со статусом PENDING удаляется, и средства возвращаются; задачу со статусом IN_PROGRESS отменить нельзя (API возвращает 409); завершённая задача удаляется.
• meshy_download_model: скачивает файл завершённой модели и сохраняет его локально

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

• meshy_list_models: выводит список ваших недавних моделей Текст в 3D (для других типов задач используйте meshy_list_tasks)

3D-печать

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

Аккаунт

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

Примеры prompt'ов

Используйте их как отправную точку в чате с поддержкой 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 прямо в prompt, используйте наши текстовые версии:

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

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

FAQ

Не хранит ли MCP server состояние?

Да. Ваш MESHY_API_KEY используется только для конкретного запроса и никогда не сохраняется на сервере.

Стоит ли MCP столько же, сколько REST API?

Да — каждый вызов инструмента MCP соответствует одному вызову REST и расходует кредиты по той же ставке. Полную таблицу тарифов см. на странице Цены.

Какие действуют ограничения скорости запросов?

MCP server использует те же ограничения скорости запросов, что и REST API. Лимиты по тарифным уровням см. на странице Rate Limits.

К каким данным Meshy может получить доступ MCP?

Только к тем, к которым может получить доступ MESHY_API_KEY через REST. Области доступа и разрешения идентичны.

Как сообщить о проблеме?

Создайте issue в репозитории meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues