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

Meshy надає два канали для агентів ШІ та асистентів з кодування: Meshy MCP server для виклику інструментів та llms.txt / llms-full.txt для поглинання документації.

Якщо ви інтегруєте Meshy з Claude Code, Cursor, Windsurf, Codex або будь-яким іншим інструментом, сумісним з MCP, встановіть MCP server нижче. Якщо ви інтегруєте з простим чат-агентом без підтримки MCP, вкажіть йому на https://docs.meshy.cn/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.

Вам потрібен API-ключ Meshy. Створіть його на 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

Віддаєте перевагу готовому навику? Відкритий пакет навичок 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 — додати текстуру до попередньої сітки

Постобробка

  • 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-адреси endpoint. Приклад: https://docs.meshy.cn/api/text-to-3d.md.

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

FAQ

Чи є MCP server безстанним?
Так. Ваш MESHY_API_KEY використовується для кожного запиту і ніколи не зберігається на стороні сервера.
Чи коштує MCP стільки ж, скільки REST API?
Так — кожен виклик інструменту MCP відповідає одному виклику REST і споживає кредити з тією ж швидкістю. Дивіться сторінку Ціни для повної матриці.
Які обмеження швидкості?
MCP server ділить ту ж площину обмеження швидкості, що і REST API. Дивіться сторінку Обмеження швидкості для обмежень за рівнями.
Які дані Meshy може отримати MCP?
Тільки те, до чого MESHY_API_KEY може отримати доступ через REST. Області та дозволи ідентичні.
Як повідомити про проблеми?
Створіть проблему в репозиторії meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues