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

Meshy предоставляет два канала для ИИ-агентов и инструментов кодирования: MCP server Meshy для вызова инструментов и 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) — это открытый стандарт, позволяющий ИИ-ассистентам вызывать внешние инструменты и получать структурированный контекст. MCP server Meshy оборачивает Meshy REST API в набор инструментов, которые может вызывать ваш агент — сгенерировать модель, проверить задачу, скачать результат — без написания HTTP-кода вручную.

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

Вам понадобится API-ключ Meshy. Создайте его на странице API-ключей в Developer Platform. 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 — добавить текстуру к preview-сетке

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

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

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

  • 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 printability 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

Is the MCP server stateless?
Yes. Your MESHY_API_KEY is used per request and never persisted on the server side.
Does MCP cost the same as the REST API?
Yes — every MCP tool call maps to a single REST call and consumes credits at the exact same rate. See the Pricing page for the full matrix.
What are the rate limits?
The MCP server shares the same rate-limit plane as the REST API. See the Rate Limits page for per-tier limits.
What Meshy data can the MCP access?
Only what the MESHY_API_KEY can access via REST. Scopes and permissions are identical.
How do I report issues?
File an issue at the meshy-mcp-server repository: https://github.com/meshy-dev/meshy-mcp-server/issues