lowpoly será descontinuado a 30/10/2026. Mude de modelo antes destas datas para evitar erros nos pedidos. Ver todas as descontinuações

Integração de IA

Ligue agentes de IA e assistentes de programação ao Meshy, com o MCP server da Meshy para chamadas a ferramentas, ou com llms.txt e llms-full.txt para ler a documentação.

Se utiliza o Claude Code, Cursor, Windsurf, Codex, ou outro cliente MCP, instale o MCP server. Se o seu agente de chat não suportar MCP, aponte-o antes para https://docs.meshy.ai/llms.txt.

O que é o MCP

O Model Context Protocol (MCP) é um padrão aberto que permite que os assistentes de IA chamem ferramentas externas e obtenham contexto estruturado. O MCP server da Meshy encapsula a Meshy API REST como ferramentas que o seu agente pode chamar. Com elas, o agente pode gerar um modelo, verificar uma tarefa e transferir o resultado sem código HTTP escrito manualmente.

O MCP server é open source. Está publicado no npm como @meshy-ai/meshy-mcp-server, e o seu código-fonte está no repositório meshy-mcp-server no GitHub.

Precisa de uma chave de API da Meshy. Crie uma na página de API Keys da Developer Platform. O MCP server lê-a a partir da variável de ambiente MESHY_API_KEY.

Instalar o MCP server

Para instalar o servidor, utilize o separador do seu cliente de IA. Substitua msy_YOUR_API_KEY pela sua chave de API.

# 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

Prefere um skill? O pacote de skills open-source meshy-3d-agent tem workflows da Meshy já prontos para o Claude Code, Cursor e OpenClaw, como gerar um modelo, consultar a tarefa (polling) e transferir o resultado. Chama diretamente a Meshy API REST, pelo que não precisa do MCP server.

npx skills add meshy-dev/meshy-3d-agent

Ferramentas disponíveis

O MCP server disponibiliza a Meshy API REST como as seguintes ferramentas, agrupadas por funcionalidade.

Geração 3D

  • meshy_text_to_3d: cria uma malha de pré-visualização sem textura a partir de um prompt de texto
  • meshy_image_to_3d: cria um modelo 3D a partir de uma imagem
  • meshy_multi_image_to_3d: cria um modelo 3D a partir de múltiplas imagens do mesmo objeto
  • meshy_text_to_3d_refine: adiciona textura a uma malha de pré-visualização

Pós-processamento

  • meshy_remesh: altera a topology ou a contagem de polígonos de um modelo existente, ou ambas
  • meshy_retexture: aplica uma nova textura a um modelo existente
  • meshy_rig: adiciona um esqueleto a uma personagem 3D humanoide
  • meshy_animate: aplica uma animação a uma personagem com rig
  • meshy_convert: converte um modelo para outro formato de ficheiro
  • meshy_resize: redimensiona um modelo para dimensões reais
  • meshy_uv_unwrap: gera uma nova disposição UV para um modelo
  • meshy_text_to_motion: gera uma animação a partir de um prompt de texto
  • meshy_list_animations: consulta os IDs das ações de animação predefinidas, gratuitamente

Creative Lab

  • meshy_creative_lab: transforma uma fotografia num produto Creative Lab acabado (executa as tarefas de protótipo e de construção)

Geração de imagens

  • meshy_text_to_image: cria uma imagem 2D a partir de texto
  • meshy_image_to_image: cria uma imagem 2D a partir de uma imagem de referência

Gestão de tarefas

  • meshy_get_task_status: verifica o estado da tarefa e os URLs de transferência
  • meshy_list_tasks: lista as tarefas recentes, opcionalmente filtradas por tipo ou estado
  • meshy_cancel_task: elimina uma tarefa. A Meshy remove e reembolsa uma tarefa PENDING, e elimina uma tarefa concluída. Uma tarefa IN_PROGRESS não pode ser cancelada, e a API devolve 409.
  • meshy_download_model: transfere um ficheiro de modelo concluído e guarda-o localmente

Espaço de trabalho

  • meshy_list_models: lista os seus modelos Texto para 3D recentes. Para outros tipos de tarefa, utilize meshy_list_tasks.

Impressão 3D

  • meshy_send_to_slicer: encontra os slicers instalados no seu computador, e devolve um comando que abre o modelo num deles. Executa localmente e não chama a Meshy API.
  • meshy_analyze_printability: verifica gratuitamente a imprimibilidade FDM de um modelo, incluindo estanquidade, volume, buracos, arestas non-manifold e faces degeneradas
  • meshy_process_multicolor: converte um modelo com textura num ficheiro 3MF multicolor para impressão
  • meshy_repair_printability: repara um modelo para impressão FDM
  • meshy_auto_split: divide um modelo em partes que podem ser impressas separadamente

Conta

  • meshy_check_balance: verifica os créditos que lhe restam
  • meshy_list_usage: lista as tarefas de API concluídas da sua equipa e os créditos que cada uma utilizou, para equipas Studio e Enterprise

Os nomes e o comportamento das ferramentas podem mudar. Para a lista completa, consulte as ferramentas no código-fonte do MCP server.

Exemplos de prompts

Para começar, experimente estes prompts no seu chat com MCP ativado:

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 e llms-full.txt

Se o seu agente não suportar MCP, ou se quiser colocar a documentação da Meshy diretamente num prompt, aponte-o para as versões em texto simples da documentação:

  • llms.txt: um índice compacto com instruções de integração, como consultar tarefas assíncronas (polling), autenticação, limites de taxa, escolha de modelo e erros comuns.
  • llms-full.txt: todas as páginas da API num único ficheiro, para que um agente possa ler a documentação numa única pergunta.
  • Markdown por página: adicione .md a qualquer URL de endpoint, por exemplo https://docs.meshy.ai/api/text-to-3d.md.

A Meshy regenera os três ficheiros sempre que o site de documentação é gerado, para que correspondam à documentação em HTML.

FAQ

O MCP server é stateless?
Não armazena as suas credenciais. O servidor mantém a sua MESHY_API_KEY em memória e nunca a escreve em disco. Por predefinição, guarda os modelos que transfere, com os respetivos metadados, numa pasta meshy_output no seu diretório de trabalho. Para guardar uma transferência noutro local, indique à ferramenta de transferência um caminho save_to.
O MCP tem o mesmo custo que a API REST?
Sim. As chamadas às ferramentas MCP fazem as mesmas chamadas REST e utilizam créditos à mesma taxa. Consulte a página Preços para ver todos os preços.
Quais são os limites de taxa?
As chamadas do MCP server contam para os mesmos limites de taxa que as suas chamadas à API REST. Consulte a página Rate limits para os limites de cada plano.
A que dados da Meshy o MCP server pode aceder?
Apenas aos dados a que a sua MESHY_API_KEY pode aceder através da API REST, com as mesmas permissões.
Como posso reportar problemas?
Abra um issue no repositório meshy-mcp-server no GitHub: https://github.com/meshy-dev/meshy-mcp-server/issues