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

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

Віддаєте перевагу готовій skill? Пакет skill із відкритим кодом meshy-3d-agent постачається з готовими робочими процесами Meshy (generate → poll → download) для 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 — наразі повертає ручний контрольний список готовності до друку (товщина стінки, нависання, багатовидна сітка тощо). Буде оновлено до автоматизованого аналізу, щойно API придатності до друку Meshy стане доступним.
  • 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 безстановим?
Так. Ваш 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