Integração de IA

Meshy expõe dois canais para agentes de IA e assistentes de codificação: o servidor Meshy MCP para chamadas de ferramentas, e llms.txt / llms-full.txt para ingestão de documentos.

Se está a integrar Meshy a partir de Claude Code, Cursor, Windsurf, Codex, ou qualquer outra ferramenta compatível com MCP, instale o servidor MCP abaixo. Se está a integrar a partir de um agente de chat simples sem suporte MCP, aponte-o para https://docs.meshy.cn/llms.txt em vez disso.

O que é MCP

O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA chamem ferramentas externas e recuperem contexto estruturado. O servidor Meshy MCP envolve a Meshy REST API como um conjunto de ferramentas que o seu agente pode invocar — gerar um modelo, verificar uma tarefa, descarregar o resultado — sem necessidade de escrever código HTTP manualmente.

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

Necessita de uma chave de API Meshy. Crie uma em https://www.meshy.ai/settings/api. O servidor MCP lê-a da variável de ambiente MESHY_API_KEY.

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

Prefere uma habilidade pronta a usar? O pacote de habilidades open-source meshy-3d-agent fornece fluxos de trabalho Meshy pré-escritos (gerar → verificar → descarregar) para Claude Code, Cursor, e OpenClaw. Chama diretamente a Meshy REST API — não é necessário servidor MCP.

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

Ferramentas Disponíveis

O servidor MCP expõe a Meshy REST API como ferramentas, agrupadas por capacidade.

Geração 3D

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

Pós-Processamento

  • meshy_remesh — alterar a topology e/ou contagem de polígonos de um modelo existente
  • meshy_retexture — aplicar uma nova textura a um modelo existente
  • meshy_rig — adicionar um esqueleto a um personagem humanoide 3D
  • meshy_animate — aplicar uma animação a um personagem com esqueleto

Geração de Imagens

  • 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 — verificar o estado da tarefa e URLs de descarregamento
  • meshy_list_tasks — listar tarefas recentes, opcionalmente filtradas por tipo/estado
  • meshy_cancel_task — cancelar uma tarefa pendente ou em progresso
  • meshy_download_model — buscar um ficheiro de modelo concluído e guardar localmente

Espaço de Trabalho

  • meshy_list_models — listar todos os modelos no espaço de trabalho do utilizador autenticado

Impressão 3D

  • meshy_send_to_slicer — detetar slicers instalados e lançar o modelo num (executa localmente na sua máquina; sem chamada à Meshy API)
  • meshy_analyze_printability — atualmente retorna uma lista de verificação manual de prontidão para impressão (espessura de parede, saliências, malha manifold, etc.). Será atualizado para análise automatizada assim que a Meshy printability API estiver disponível.
  • meshy_process_multicolor — converter um modelo texturizado num ficheiro 3MF multicolor para impressão

Conta

  • meshy_check_balance — consultar créditos restantes

Os nomes e comportamentos das ferramentas podem evoluir. A lista autoritativa está na fonte do servidor MCP.

Exemplos de Prompts

Insira estes no seu chat com suporte 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 suporta MCP, ou se deseja ingerir os documentos Meshy diretamente num prompt, aponte-o para as nossas superfícies de 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 de uma só vez.
  • Markdown por página: adicione .md a qualquer URL de endpoint. Exemplo: https://docs.meshy.cn/api/text-to-3d.md.

Todos os três são regenerados sempre que o site de documentos é construído, para que nunca se desviem dos documentos HTML.

FAQ

O servidor MCP é sem estado?
Sim. A sua MESHY_API_KEY é usada por pedido e nunca é persistida no lado do servidor.
O MCP custa o mesmo que a REST API?
Sim — cada chamada de ferramenta MCP mapeia para uma única chamada REST e consome créditos à mesma taxa. Veja a página de Preços para a matriz completa.
Quais são os limites de taxa?
O servidor MCP partilha o mesmo plano de limite de taxa que a REST API. Veja a página de Limites de Taxa para limites por nível.
Que dados Meshy pode o MCP aceder?
Apenas o que a MESHY_API_KEY pode aceder via REST. Os escopos e permissões são idênticos.
Como posso reportar problemas?
Registe um problema no repositório meshy-mcp-server: https://github.com/meshy-dev/meshy-mcp-server/issues