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

  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, 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.