MCP

Tinypoly también es un servidor MCP (Model Context Protocol). Con un asistente de IA que hable MCP, como Claude o Cursor, le pides en una conversación que cree objetos, edite mallas, pinte texturas y aplique modificadores en tus proyectos. Cada cambio 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, comprueba el nombre del agente y haz clic en Permitir acceso.

No hay clave ni token que copiar: la autorización sucede en esa página.

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, con tus roles: llega a tus proyectos, a los compartidos contigo y a los de los espacios de trabajo de los que formas parte. Donde eres Visor, solo lee.

  • Proyectos: Listar, crear y leer proyectos, con la jerarquía y las medidas de cada objeto.
  • Objetos: Crear primitivas, grupos, cámaras y modificadores, cambiarlos y eliminarlos.
  • Malla: Extruir, insertar, biselar, mover, escalar y borrar caras.
  • Materiales: Crear y cambiar materiales y aplicarlos a los objetos.
  • Variantes de apariencia: Cambiar colores y materiales de lo que está dentro de un grupo o de un asset, sin tocar los objetos.
  • Texturas: Crear y pintar texturas a partir de una descripción, incluso con imágenes y capas de forma y de texto que siguen siendo editables en el editor.
  • Cuadros: Armar los Cuadros como en el editor, con formas, textos, imágenes, tablas, gráficos, cotas y vistas del modelo, y exportarlos en PDF o PNG.
  • Vista previa: Ver imágenes de la textura y del modelo, desde cualquier lado, para comprobar el resultado.
  • Módulos: Crear y cambiar los objetos y modificadores de los módulos instalados.
  • Documentación: Leer estas mismas páginas, para no tener que adivinar valores.

Limitaciones

  • El agente no crea Texto 3D ni capas vectoriales, no cambia el tamaño de las texturas y no edita materiales con shader personalizado.
  • Un modificador de desplazamiento hecho por el agente solo acepta ruido, no una textura.
  • La vista previa usa luces fijas y no muestra cielo ni agua.
  • Cambiar las propiedades de una primitiva descarta las ediciones de caras hechas en ella, como en el editor.

Revocar el acceso

La pestaña Servicios lista los agentes conectados. Revocar corta el acceso al instante, y el agente tiene que volver a autorizarse para volver.