Огляд
Сервер Meshy MCP (Model Context Protocol) дозволяє локальним AI-агентам — таким як Claude Code, Cursor, Codex та будь-яким іншим клієнтам, що підтримують stdio MCP-сервери, — викликати 3D-інструменти Meshy безпосередньо з розмови.
Одне з'єднання надає вашому агенту 24 інструменти Meshy: Text to 3D, Image to 3D, текстурування, ремешинг, ригінг, перевірка придатності до друку, завантаження та інше. Повну сторінку налаштування дивіться на meshy.ai/mcp.
Meshy 3D Agent проти Meshy MCP
Meshy 3D Agent працює всередині meshy.ai у вашому браузері — налаштування не потрібне.
Meshy MCP переносить ті самі інструменти генерації в AI-клієнт, у якому ви вже працюєте, тож ви можете створювати й завантажувати 3D-активи, не виходячи з редактора чи термінала.
Що вам потрібно
Node.js 18 або новіша версія
Ключ Meshy API — створіть його в Meshy Developer Platform
Налаштування
Варіант A: дозвольте агенту встановити його (рекомендовано)
У сеансі Claude Code, Cursor або Codex вставте:
Install the Meshy MCP server for me. Docs: https://github.com/meshy-dev/meshy-mcp-server Help me configure MESHY_API_KEY locally in the client settings. Do not ask me to paste an API key into this chat.
Варіант B: ручне налаштування
Виконайте ручні кроки для свого клієнта на meshy.ai/mcp або в README на GitHub.
Перевірка з'єднання
Сервер завантажиться з вашим наступним повідомленням. Запитайте у свого агента: "Який баланс моїх кредитів Meshy?"
Якщо він відповість, з'єднання встановлено — просто опишіть модель, яку хочете.
Використовуєте ChatGPT?
Додайте Meshy 3D з ChatGPT Plugins і увійдіть за допомогою свого облікового запису Meshy. API-ключ або локальне налаштування не потрібні, і це працює як у вебверсії, так і в десктопному застосунку.
Кредити та безпека
Генерації, створені через MCP, використовують кредити API з облікового запису, пов'язаного з вашим API-ключем, так само як і прямі виклики API.
Ставтеся до свого API-ключа як до пароля: ніколи не вставляйте його в чат і не додавайте до систем контролю версій чи спільних файлів конфігурації.
Дізнатися більше
Посібник: Використання Meshy API та MCP
Усі інтеграції: meshy.ai/integrations
Документація для AI-агентів: docs.meshy.ai/api/ai.md
Часті запитання (FAQ)
1. Чи MCP-сервер — це те саме, що Meshy Agent у браузері?
Ні. Meshy 3D Agent — це чат-інтерфейс на meshy.ai. MCP-сервер надає інструменти Meshy зовнішнім AI-клієнтам, як-от Claude Code, Cursor або Codex.
2. У моєму клієнті немає інструментів Meshy. Що робити?
Перевірте, чи встановлено Node.js 18+, і чи задано MESHY_API_KEY у налаштуваннях MCP клієнта, потім перезапустіть клієнт. Див. розділ усунення несправностей у README на GitHub.
3. Чи генерації через MCP використовують ті самі кредити, що й вебзастосунок?
Вони використовують кредити API на обліковому записі, якому належить ваш API-ключ.
4. Куди потрапляють згенеровані моделі?
Попросіть агента завантажити потрібний вам формат, наприклад GLB або FBX. Локальні завантаження зберігаються в meshy_output/ і готові для вашого DCC-застосунку або слайсера.
5. Чи можна повторно використовувати один API-ключ у кількох інструментах?
Так, у клієнтах, яким ви довіряєте, — але не зберігайте його у спільних або публічних файлах конфігурації.