Visão geral
O servidor MCP (Model Context Protocol) da Meshy permite que agentes de IA locais — como Claude Code, Cursor, Codex e qualquer outro cliente que suporte servidores MCP stdio — chamem as ferramentas 3D da Meshy diretamente a partir de uma conversa.
Uma única ligação dá ao teu agente acesso a 24 ferramentas Meshy: Text to 3D, Image to 3D, texturização, remeshing, rigging, verificações de imprimibilidade, transferências e muito mais. Para a página de configuração completa, consulta meshy.ai/mcp.
Agente 3D Meshy vs. MCP Meshy
O Agente 3D Meshy funciona dentro de meshy.ai no teu navegador — não é necessária configuração.
O MCP Meshy traz as mesmas ferramentas de geração para o cliente de IA em que já trabalhas, para que possas criar e transferir recursos 3D sem sair do teu editor ou terminal.
O que precisas
Node.js 18 ou posterior
Uma chave API da Meshy — cria uma na Meshy Developer Platform
Configuração
Opção A: deixa o teu agente instalá-lo (recomendado)
Numa sessão do Claude Code, Cursor ou Codex, cola:
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
Segue os passos manuais para o teu cliente em meshy.ai/mcp ou no README do GitHub.
Verifica a ligação
O servidor carrega na tua mensagem seguinte. Pergunta ao teu agente: "Qual é o meu saldo de créditos Meshy?"
Se ele responder, estás ligado — basta descreveres o modelo que queres.
Usas o ChatGPT?
Adiciona o Meshy 3D a partir dos Plugins do ChatGPT e inicia sessão com a tua conta Meshy. Não é necessária nenhuma chave API nem configuração local, e funciona tanto na web como no desktop.
Créditos e segurança
As gerações feitas através do MCP usam créditos de API da conta associada à tua chave API, tal como as chamadas diretas à API.
Trata a tua chave API como uma palavra-passe: nunca a coles num chat e não a coloques em sistemas de controlo de versões nem em ficheiros de configuração partilhados.
Saber mais
Tutorial: Usar a API e o MCP da Meshy
Todas as integrações: meshy.ai/integrations
Documentação para agentes de IA: docs.meshy.ai/api/ai.md
Perguntas frequentes
1. O servidor MCP é o mesmo que o Agente Meshy no navegador?
Não. O Agente 3D Meshy é a interface de chat em meshy.ai. O servidor MCP expõe as ferramentas da Meshy a clientes de IA externos, como Claude Code, Cursor ou Codex.
2. O meu cliente não lista as ferramentas Meshy. O que devo fazer?
Verifica se o Node.js 18+ está instalado e se MESHY_API_KEY está definida nas configurações MCP do cliente e, em seguida, reinicia o cliente. Consulta a secção de resolução de problemas do README no GitHub.
3. As gerações via MCP usam os mesmos créditos que a aplicação web?
Utilizam os créditos da API na conta à qual pertence a tua chave API.
4. Para onde vão os modelos gerados?
Pede ao agente que transfira o formato de que precisas, por exemplo GLB ou FBX. As transferências locais são guardadas em meshy_output/, prontas para a tua aplicação DCC ou slicer.
5. Posso reutilizar uma chave API em várias ferramentas?
Sim, entre clientes em que confies — mas mantém-na fora de ficheiros de configuração partilhados ou públicos.