Visão geral
O servidor Meshy MCP (Model Context Protocol) permite que agentes de IA locais — como Claude Code, Cursor, Codex e qualquer outro cliente compatível com servidores MCP via stdio — chamem as ferramentas 3D do Meshy diretamente de uma conversa.
Uma única conexão dá ao seu agente 24 ferramentas do Meshy: text to 3D, image to 3D, texturização, remesh, rigging, verificações de imprimibilidade, downloads e muito mais. Para a página completa de configuração, consulte meshy.ai/mcp.
Meshy 3D Agent vs. Meshy MCP
O Meshy 3D Agent é executado dentro do meshy.ai no seu navegador — sem necessidade de configuração.
O Meshy MCP leva as mesmas ferramentas de geração para o cliente de IA em que você já trabalha, para que você possa criar e baixar assets 3D sem sair do seu editor ou terminal.
O que você precisa
Node.js 18 ou posterior
Uma chave de API do Meshy — crie uma na Meshy Developer Platform
Configuração
Opção A: Deixe seu agente instalar (recomendado)
Em uma sessão do Claude Code, Cursor ou Codex, cole:
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.
Opção B: Configuração manual
Siga as etapas manuais para o seu cliente em meshy.ai/mcp ou no README do GitHub.
Verifique a conexão
O servidor é carregado na sua próxima mensagem. Pergunte ao seu agente: "Qual é o meu saldo de créditos do Meshy?"
Se ele responder, você está conectado — basta descrever o modelo que deseja.
Usando o ChatGPT?
Adicione o Meshy 3D a partir dos Plugins do ChatGPT e entre com sua conta Meshy. Não é necessária uma chave de API nem configuração local, e funciona tanto na web quanto no desktop.
Créditos e segurança
As gerações feitas via MCP usam créditos de API da conta vinculada à sua chave de API, assim como as chamadas diretas à API.
Trate sua chave de API como uma senha: nunca a cole em um chat e não a envie para controle de código-fonte nem para arquivos de configuração compartilhados.
Saiba mais
Tutorial: Usando a API do Meshy e o MCP
Todas as integrações: meshy.ai/integrations
Documentação para agentes de IA: docs.meshy.ai/api/ai.md
Perguntas frequentes
1. O MCP server é o mesmo que o Meshy Agent no navegador?
Não. O Meshy 3D Agent é a interface de chat em meshy.ai. O MCP server expõe as ferramentas do Meshy para clientes de IA externos, como Claude Code, Cursor ou Codex.
2. Meu cliente não lista as ferramentas do Meshy. O que devo fazer?
Verifique se o Node.js 18+ está instalado e se MESHY_API_KEY está definida nas configurações de MCP do cliente; depois, reinicie o cliente. Consulte a seção de solução de problemas do README no GitHub.
3. As gerações via MCP usam os mesmos créditos que o aplicativo web?
Elas usam os créditos de API da conta proprietária da sua chave de API.
4. Para onde vão os modelos gerados?
Peça ao agente para baixar o formato de que você precisa, por exemplo GLB ou FBX. Os downloads locais são salvos em meshy_output/, prontos para seu aplicativo DCC ou slicer.
5. Posso reutilizar uma mesma chave de API em várias ferramentas?
Sim, entre clientes confiáveis — mas mantenha a chave fora de arquivos de configuração compartilhados ou públicos.