Integração de IA

A Meshy disponibiliza dois canais para agentes de IA e assistentes de programação: o MCP server da Meshy para chamadas de ferramentas, e llms.txt / llms-full.txt para ingestão de documentação.

Se está a integrar a Meshy a partir do Claude Code, Cursor, Windsurf, Codex, ou qualquer outra ferramenta compatível com MCP, instale o MCP server abaixo. Se está a integrar a partir de um agente de chat simples sem suporte para 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 assistentes de IA chamem ferramentas externas e obtenham contexto estruturado. O MCP server da Meshy encapsula a API REST da Meshy como um conjunto de ferramentas que o seu agente pode invocar — gerar um modelo, verificar uma tarefa, descarregar o resultado — sem ter de escrever código HTTP manualmente.

O MCP server é open source e está publicado no npm como @meshy-ai/meshy-mcp-server. Código-fonte: github.com/meshy-dev/meshy-mcp-server.

Instalação Rápida

# 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

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

Ferramentas Disponíveis

O MCP server expõe a Meshy API como 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 várias 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 e/ou a contagem de polígonos de um modelo existente
• meshy_retexture: aplica uma nova textura a um modelo existente
• meshy_rig: adiciona um esqueleto a uma personagem 3D humanóide
• 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

Creative Lab

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

Geração de Imagem

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

Gestão de Tarefas

• meshy_get_task_status: verifica o estado de uma tarefa e os URLs de download
• meshy_list_tasks: lista tarefas recentes, opcionalmente filtradas por tipo/estado
• meshy_cancel_task: elimina uma tarefa. Uma tarefa PENDING é removida e reembolsada; uma tarefa IN_PROGRESS não pode ser cancelada (a API devolve 409); uma tarefa concluída é eliminada.
• meshy_download_model: obtém um ficheiro de modelo concluído e guarda-o localmente

Espaço de Trabalho

• meshy_list_models: lista os seus modelos recentes de Texto para 3D (use meshy_list_tasks para outros tipos de tarefa)

Impressão 3D

• meshy_send_to_slicer: deteta slicers instalados e devolve um comando para abrir o modelo num deles (executa localmente; sem chamadas à Meshy API)
• meshy_analyze_printability: verificação gratuita e automática de imprimibilidade FDM (estanquidade, volume, buracos, arestas non-manifold, 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

Conta

• meshy_check_balance: consulta os créditos restantes

Exemplos de Prompts

Insira estes exemplos no seu chat com suporte para MCP como ponto de partida.

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 ingerir a documentação da Meshy diretamente num prompt, aponte-o para as nossas superfícies em texto simples:

• llms.txt — índice compacto + instruções de integração (o padrão correto de polling assíncrono, regras de autenticação, limites de taxa, escolha de modelo, erros comuns).
• llms-full.txt — todas as páginas da API concatenadas num único ficheiro para ingestão numa única obtenção.
• Markdown por página: adicione .md a qualquer URL de endpoint. Exemplo: https://docs.meshy.ai/api/text-to-3d.md.

Os três ficheiros são regenerados sempre que o site de documentação é gerado, pelo que nunca ficam desatualizados em relação à documentação HTML.

Perguntas Frequentes

O MCP server é stateless?

Sim. A sua MESHY_API_KEY é usada por pedido e nunca é persistida do lado do servidor.

O MCP custa o mesmo que a API REST?

Sim — cada chamada de ferramenta MCP corresponde a uma única chamada REST e consome créditos exatamente à mesma taxa. Consulte a página de Preços para a matriz completa.

Quais são os limites de taxa?

O MCP server partilha o mesmo plano de limites de taxa que a API REST. Consulte a página de Limites de Taxa para os limites por nível.

A que dados da Meshy o MCP pode aceder?

Apenas aos que a MESHY_API_KEY consegue aceder via REST. Os âmbitos e permissões são idênticos.

Como reporto problemas?

Registe um issue no repositório meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues