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

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.

Вам потрібен API-ключ Meshy. Створіть його на сторінці API Keys у 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. Він викликає REST API Meshy напряму — MCP server не потрібен.

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

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

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

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

  • meshy_text_to_3d — створення 3D-моделі з текстового prompt
  • meshy_image_to_3d — створення 3D-моделі з одного зображення
  • meshy_multi_image_to_3d — створення 3D-моделі з кількох зображень одного об'єкта
  • meshy_text_to_3d_refine — додавання текстури до попередньої сітки (preview mesh)

Постобробка

  • 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 server.

Приклади промптів

Використайте їх як відправну точку у вашому чаті з підтримкою 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