Чи є MCP server безстановим (stateless)?

Він не зберігає ваші облікові дані. Сервер тримає MESHY_API_KEY у пам'яті та ніколи не записує його на диск. За замовчуванням він зберігає завантажені моделі разом з їхніми метаданими у папці meshy_output у своєму робочому каталозі. Щоб зберегти завантаження в іншому місці, вкажіть інструменту завантаження шлях save_to.

Чи коштує MCP стільки ж, скільки REST API?

Так. Виклики інструментів MCP виконують ті самі звернення до REST і використовують кредити за тим самим тарифом. Усі ціни дивіться на сторінці Ціни.

Які обмеження частоти запитів?

Виклики MCP server враховуються в ті самі обмеження частоти запитів, що й ваші виклики REST API. Ліміти для кожного плану дивіться на сторінці Rate limits.

До яких даних Meshy має доступ MCP server?

Лише до тих, до яких ваш MESHY_API_KEY має доступ через REST API, з тими самими дозволами.

Як повідомити про проблеми?

Створіть issue в репозиторії meshy-mcp-server на GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues

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

Підключайте ШІ-агентів та асистентів для написання коду до Meshy за допомогою MCP server Meshy для викликів інструментів, або за допомогою llms.txt та llms-full.txt для читання документації.

Якщо ви використовуєте 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, а його вихідний код знаходиться в репозиторії meshy-mcp-server на GitHub.

Вам знадобиться API-ключ Meshy. Створіть його на сторінці API Keys Developer Platform. MCP server зчитує його зі змінної середовища MESHY_API_KEY.

Встановлення MCP server

Щоб встановити сервер, скористайтеся вкладкою для вашого ШІ-клієнта. Замініть msy_YOUR_API_KEY на свій API-ключ.

# 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? Пакет навичок з відкритим вихідним кодом 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: створення нетекстурованої preview-сітки з текстового 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: застосування анімації до персонажа з rig
meshy_convert: конвертування моделі в інший формат файлу
meshy_resize: зміна розміру моделі відповідно до реальних розмірів
meshy_uv_unwrap: генерація нової UV-розкладки для моделі
meshy_text_to_motion: генерація анімації з текстового prompt
meshy_list_animations: безкоштовний пошук ID готових дій анімації

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: видалення завдання. Meshy видаляє та повертає кошти за завдання зі статусом PENDING, а також видаляє завершене завдання. Завдання зі статусом IN_PROGRESS скасувати неможливо, і API повертає 409.
meshy_download_model: завантаження файлу готової моделі та збереження його локально

Робоча область

meshy_list_models: перелік ваших останніх моделей Текст у 3D. Для інших типів завдань використовуйте meshy_list_tasks.

3D-друк

meshy_send_to_slicer: пошук слайсерів, встановлених на вашому комп'ютері, та повернення команди, яка відкриває модель в одному з них. Виконується локально і не звертається до Meshy API.
meshy_analyze_printability: безкоштовна перевірка придатності моделі до FDM-друку, включно з водонепроникністю, об'ємом, отворами, немноговидними ребрами та виродженими гранями
meshy_process_multicolor: конвертування текстурованої моделі у багатоколірний файл 3MF для друку
meshy_repair_printability: виправлення моделі для FDM-друку
meshy_auto_split: розділення моделі на окремо придатні для друку частини

Обліковий запис

meshy_check_balance: перевірка кількості кредитів, що залишилися
meshy_list_usage: перелік завершених завдань API вашої команди та кількості кредитів, витрачених на кожне з них, для команд Studio та Enterprise

Назви інструментів та їх поведінка можуть змінюватися. Повний перелік дивіться серед інструментів у вихідному коді MCP server.

Приклади prompt

Для початку спробуйте ці 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.

Meshy регенерує всі три файли щоразу під час збирання сайту документації, тому вони відповідають HTML-документації.

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

Чи є MCP server безстановим (stateless)?: Він не зберігає ваші облікові дані. Сервер тримає MESHY_API_KEY у пам'яті та ніколи не записує його на диск. За замовчуванням він зберігає завантажені моделі разом з їхніми метаданими у папці meshy_output у своєму робочому каталозі. Щоб зберегти завантаження в іншому місці, вкажіть інструменту завантаження шлях save_to.
Чи коштує MCP стільки ж, скільки REST API?: Так. Виклики інструментів MCP виконують ті самі звернення до REST і використовують кредити за тим самим тарифом. Усі ціни дивіться на сторінці Ціни.
Які обмеження частоти запитів?: Виклики MCP server враховуються в ті самі обмеження частоти запитів, що й ваші виклики REST API. Ліміти для кожного плану дивіться на сторінці Rate limits.
До яких даних Meshy має доступ MCP server?: Лише до тих, до яких ваш MESHY_API_KEY має доступ через REST API, з тими самими дозволами.
Як повідомити про проблеми?: Створіть issue в репозиторії meshy-mcp-server на GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues