MCP

O Tinypoly também é um servidor MCP (Model Context Protocol). Com um assistente de IA que fala MCP, como o Claude ou o Cursor, você pede em conversa que ele crie objetos, edite malhas, pinte texturas e aplique modificadores nos seus projetos. Cada alteração já aparece quando você abre o editor.

Conectar

  1. No painel, abra Conta, aba Serviços, e copie o Endereço do servidor MCP.
  2. Adicione esse endereço como servidor MCP no seu agente.
  3. Na primeira vez, o agente abre uma página do Tinypoly. Entre na conta, confira o nome do agente e clique em Permitir acesso.

Não há chave nem token para copiar: a autorização acontece nessa página.

O endereço tem este formato:

https://tinypoly.com/api/mcp

Claude Code

claude mcp add --transport http tinypoly https://tinypoly.com/api/mcp

Cursor e outros agentes

Agentes configurados por arquivo JSON aceitam o servidor como entrada HTTP:

{
  "mcpServers": {
    "tinypoly": { "url": "https://tinypoly.com/api/mcp" }
  }
}

O que o agente pode fazer

O agente age em nome da sua conta, com os seus papéis: ele alcança os seus projetos, os compartilhados com você e os dos espaços de trabalho de que você participa. Onde você é Visualizador, ele só lê.

  • Projetos: Listar, criar e ler projetos, com a hierarquia e as medidas de cada objeto.
  • Objetos: Criar primitivos, grupos, câmeras e modificadores, alterá-los e excluí-los.
  • Malha: Extrudar, afastar para dentro, chanfrar, mover, escalar e apagar faces.
  • Materiais: Criar e alterar materiais e aplicá-los aos objetos.
  • Variantes de aparência: Trocar cores e materiais do que está dentro de um grupo ou de um asset, sem mexer nos objetos.
  • Texturas: Criar e pintar texturas a partir de uma descrição, inclusive com imagens e camadas de forma e de texto que continuam editáveis no editor.
  • Quadros: Montar os Quadros como no editor, com formas, textos, imagens, tabelas, gráficos, cotas e vistas do modelo, e exportá-los em PDF ou PNG.
  • Prévia: Ver imagens da textura e do modelo, de qualquer lado, para conferir o resultado.
  • Módulos: Criar e alterar os objetos e modificadores dos módulos instalados.
  • Documentação: Ler estas mesmas páginas, para não precisar adivinhar valores.

Limitações

  • O agente não cria Texto 3D nem camada vetorial, não redimensiona texturas e não edita material com shader personalizado.
  • O modificador de deslocamento feito pelo agente só aceita ruído, não uma textura.
  • A prévia usa luzes fixas e não mostra céu nem água.
  • Mudar as propriedades de um primitivo descarta as edições de face feitas nele, como no editor.

Revogar o acesso

A aba Serviços lista os agentes conectados. Revogar corta o acesso na hora, e o agente precisa ser autorizado de novo para voltar.