MCP

Tinypoly también es un servidor MCP (Model Context Protocol). Al conectar un asistente de IA que hable MCP, como Claude o Cursor, puedes pedirle conversando que cree objetos, edite mallas y aplique modificadores en tus proyectos. Cada cambio se guarda en el momento y ya está ahí cuando abres el editor.

Conectar

  1. En el panel, abre Cuenta, pestaña Servicios, y copia la Dirección del servidor MCP.
  2. Añade esa dirección como servidor MCP en tu agente.
  3. La primera vez, el agente abre una página de Tinypoly. Inicia sesión si aún no lo hiciste, comprueba el nombre del agente y haz clic en Permitir acceso.

No hay clave ni token que copiar: la autorización ocurre en esa página, y el agente recibe el acceso por sí solo.

La dirección tiene este formato:

https://tinypoly.com/api/mcp

Claude Code

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

Cursor y otros agentes

Los agentes configurados con un archivo JSON aceptan el servidor como entrada HTTP:

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

Qué puede hacer el agente

El agente actúa en nombre de tu cuenta y con tus roles. Alcanza los proyectos que son tuyos, los compartidos contigo y los de los espacios de trabajo de los que formas parte. En un proyecto en el que eres Visor, solo lee.

  • Proyectos: Listar, crear y leer un proyecto entero, con la jerarquía, las transformaciones y las medidas de cada objeto.
  • Objetos: Crear primitivas, grupos y modificadores, cambiar propiedades, posición, color y jerarquía, y eliminar.
  • Malla: Inspeccionar las caras y extruir, insertar, biselar, mover, escalar y borrar caras elegidas por dirección, región o índice.
  • Módulos: Crear y cambiar los objetos y modificadores de los módulos instalados.
  • Documentación: Leer estas mismas páginas y lo que acepta cada propiedad, para no tener que adivinar valores.

Limitaciones

  • El agente no puede crear texto 3D.
  • El modificador de desplazamiento solo acepta ruido, no una textura.
  • Los materiales y las texturas no los edita el agente.
  • El contenido de módulo que necesita generar una textura o un material solo funciona en el editor.
  • Editar las caras de una primitiva y después cambiar sus propiedades vuelve a generar la malla y descarta esas ediciones, igual que en el editor.

Revocar el acceso

La misma pestaña Servicios lista los agentes conectados, con la fecha de la autorización y del último uso. Revocar corta el acceso en el momento, y el agente necesita autorizarse de nuevo para volver a usar tus proyectos.