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
- En el panel, abre Cuenta, pestaña Servicios, y copia la Dirección del servidor MCP.
- Añade esa dirección como servidor MCP en tu agente.
- 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.