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

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.

Вам нужен Meshy API-ключ. Создайте его на https://www.meshy.ai/settings/api. MCP server считывает его из переменной окружения 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 server не требуется.

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

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

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

Генерация 3D

  • meshy_text_to_3d — создать 3D-модель из текстового prompt
  • 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 — сейчас возвращает ручной чек-лист готовности к печати (толщина стенки, нависания, многообразная сетка и т. д.). Будет обновлён до автоматического анализа, когда станет доступен Meshy API для пригодности к печати.
  • meshy_process_multicolor — конвертировать модель с текстурой в многоцветный файл 3MF для печати

Аккаунт

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

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

Примеры 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 stateless?
Да. Ваш 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