MCP
O Tinypoly também é um servidor MCP (Model Context Protocol). Conectando um assistente de IA que fala MCP, como o Claude ou o Cursor, você pode pedir em conversa que ele crie objetos, edite malhas e aplique modificadores nos seus projetos. Cada alteração é salva na hora e já está lá quando você abre o editor.
Conectar
- No painel, abra Conta, aba Serviços, e copie o Endereço do servidor MCP.
- Adicione esse endereço como servidor MCP no seu agente.
- Na primeira vez, o agente abre uma página do Tinypoly. Entre na conta, se ainda não estiver, confira o nome do agente e clique em Permitir acesso.
Não existe chave nem token para copiar: a autorização acontece nessa página, e o agente recebe o acesso sozinho.
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 e com os seus papéis. Ele alcança os projetos que são seus, os compartilhados com você e os dos espaços de trabalho de que você participa. Em projeto onde você é Visualizador, ele só lê.
- Projetos: Listar, criar e ler um projeto inteiro, com a hierarquia, as transformações e as medidas de cada objeto.
- Objetos: Criar primitivos, grupos e modificadores, alterar propriedades, posição, cor e hierarquia, e excluir.
- Malha: Inspecionar as faces e extrudar, afastar para dentro, chanfrar, mover, escalar e apagar faces escolhidas por direção, região ou índice.
- Módulos: Criar e alterar os objetos e modificadores dos módulos instalados.
- Documentação: Ler estas mesmas páginas e o que cada propriedade aceita, para não precisar adivinhar valores.
Limitações
- Texto 3D não pode ser criado pelo agente.
- O modificador de deslocamento só aceita ruído, não uma textura.
- Materiais e texturas não são editados pelo agente.
- Conteúdo de módulo que precisa gerar textura ou material só funciona no editor.
- Editar as faces de um primitivo e depois mudar as propriedades dele gera a malha de novo e descarta essas edições, como no editor.
Revogar o acesso
A mesma aba Serviços lista os agentes conectados, com a data da autorização e do último uso. Revogar corta o acesso na hora, e o agente precisa ser autorizado de novo para voltar a usar seus projetos.