Інтеграція зі ШІ

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 обгортає REST API Meshy у вигляді набору інструментів, які ваш агент може викликати — згенерувати модель, перевірити завдання, завантажити результат — без ручного написання 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 надає REST API Meshy у вигляді інструментів, згрупованих за можливостями.

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

• meshy_text_to_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_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: виявляє встановлені слайсери та повертає команду для відкриття моделі в одному з них (виконується локально; без виклику API Meshy)
• 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-документацією.

Поширені запитання

Чи є 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