Обзор
Сервер 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 или более поздняя версия
API-ключ Meshy — создайте его в 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
Часто задаваемые вопросы
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 клиента, затем перезапустите клиент. См. раздел устранения неполадок в GitHub README.
3. Используют ли генерации через MCP те же кредиты, что и веб-приложение?
Они используют кредиты API на аккаунте, которому принадлежит ваш API-ключ.
4. Куда попадают созданные модели?
Попросите агента скачать нужный вам формат, например GLB или FBX. Локальные загрузки сохраняются в meshy_output/ и готовы к использованию в вашем DCC-приложении или слайсере.
5. Можно ли использовать один API-ключ в нескольких инструментах?
Да, в клиентах, которым вы доверяете, — но не храните его в общих или публичных файлах конфигурации.