Ir al contenido
Volver al blog
mcpaiintegrationstutorial

MCP del configurador de productos: conecta Claude, Cursor y VS Code con Simplio3D

Simplio3D·
MCP del configurador de productos: conecta Claude, Cursor y VS Code con Simplio3D

Pregúntale hoy a un asistente de IA sobre tu configurador de productos y responderá a partir de cualquier cosa que pegues en el chat: una captura de pantalla, una lista de opciones, un precio que hayas escrito. Los conectores MCP eliminan ese paso. Un conector proporciona al asistente acceso directo y autorizado a tu cuenta de Simplio3D, para que lea el proyecto real (los bloques de opciones, las reglas condicionales, la fórmula de precios, los nombres de las piezas dentro del modelo 3D) y responda basándose en ello.

Esta guía explica qué es un conector MCP, qué puede y qué no puede hacer un agente conectado en Simplio3D, cómo los cambios de riesgo permanecen bajo tu control y cómo conectar Claude, Cursor o VS Code.

¿Qué son los conectores MCP?

El Model Context Protocol (MCP) es un estándar abierto para conectar asistentes de IA con herramientas y datos externos. Tiene dos partes. Un cliente MCP es la herramienta de IA que ya utilizas, como Claude, Cursor o VS Code. Un servidor MCP es el sistema al que se conecta el asistente: publica una lista de herramientas, cada una con una descripción y un esquema, que el asistente puede invocar cuando una pregunta las requiere.

Un conector es el vínculo entre ambos: la dirección del servidor y una credencial que indica quién se conecta y a qué puede acceder. Claude lo llama conector personalizado; otros clientes lo denominan entrada de servidor MCP. Para Simplio3D siempre son las mismas dos cosas:

  • El endpoint: https://app.simplio3d.ai/mcp
  • Una credencial: un inicio de sesión OAuth que apruebas en una pantalla de consentimiento de Simplio3D, o un token de conexión que creas en Panel de control → Integraciones → Conexiones de IA.

Una vez conectado, el asistente ve las herramientas de Simplio3D junto con las suyas y decide cuándo invocarlas según lo que le pidas.

Diagrama: Claude, Cursor y VS Code se conectan al servidor MCP de Simplio3D en app.simplio3d.ai/mcp. Cada llamada supera cuatro comprobaciones (cuenta verificada, plan o prueba activos, rol en el espacio de trabajo y ámbitos de conexión) antes de acceder a 123 herramientas (52 de lectura, 68 de escritura y 3 de flujo de trabajo) y a los proyectos de un espacio de trabajo. Los cambios de alto riesgo se convierten en una propuesta que espera en Cambios de IA pendientes hasta que pulses Aplicar; después se crea una instantánea.
Todos los clientes de IA pasan por el mismo punto de conexión y las mismas cuatro comprobaciones. Un cambio de alto riesgo queda detenido como propuesta hasta que lo apliques en el panel de control.

Qué puede hacer un agente conectado en Simplio3D

El servidor MCP de Simplio3D ofrece 123 herramientas: 52 de lectura, 68 de escritura bajo un modelo de escritura controlada y 3 para ejecutar flujos de trabajo de agentes. En conjunto, cubren proyectos, inspección de modelos 3D, materiales, bloques de opciones, lógica condicional, precios, formularios, solicitudes de presupuesto y conexiones con tiendas. En la práctica, un agente conectado puede:

  • Leer un proyecto real: sus modelos, bloques de opciones y variantes, materiales, reglas condicionales, bloques y fórmulas de precios, y campos de formulario.
  • Examinar el modelo 3D: nombres y jerarquía de las piezas, para comprobar que cada opción siga dirigiéndose a una malla existente.
  • Auditar un configurador: destinos de piezas faltantes, materiales eliminados, reglas que nunca pueden activarse y variantes sin precio.
  • Explicar la lógica y calcular el precio de una configuración: qué regla oculta una opción y cuánto cuesta un conjunto determinado de selecciones, calculado en el servidor.
  • Crear y editar: crear proyectos, bloques de opciones, variantes, materiales, reglas condicionales y campos de formulario, y ordenar lo que ya existe.
  • Ejecutar flujos de trabajo de agentes: iniciar una tarea de varios pasos, como una auditoría de proyecto o una reparación segura, responder a sus preguntas y seguir su progreso. Los flujos de trabajo se detienen para solicitar tu aprobación y nunca publican.
  • Resumir clientes potenciales: leer las solicitudes de presupuesto que has recibido y lo que configuró cada cliente.
  • Responder preguntas sobre el producto a partir de la documentación: buscar en la documentación oficial de Simplio3D y citar la página, en lugar de responder de memoria.

Todas las herramientas, con el alcance que necesitan y si leen o escriben, se enumeran en la referencia de herramientas MCP.

Lo que no puede hacer

Algunas acciones siguen estando fuera de su alcance, independientemente de los permisos que concedas. Un agente conectado no puede publicar un proyecto, crear un enlace para compartir ni cambiar la configuración de inserción. No puede cargar archivos ni eliminar un proyecto. No puede conectar ni desconectar una tienda Shopify o WooCommerce, ni leer las credenciales de esa tienda. Tampoco recibe nunca acceso a la base de datos, claves de API, secretos de webhooks ni contraseñas de vistas compartidas: las herramientas devuelven resúmenes seleccionados, no registros sin procesar.

Permisos: concede a cada conexión solo lo que necesita

Una conexión solo puede ver e invocar las herramientas cubiertas por sus permisos. Empieza con acceso de solo lectura y añade un permiso de escritura cada vez, según lo requiera la tarea.

Ámbitos de conexión MCP de Simplio3D
ÁmbitoLo que permiteConcédelo cuando el agente deba
Espacio de trabajo (lectura)Resumen de tu espacio de trabajo, plan y usoIndicarte qué plan tienes y cuánto utilizas
Proyectos (lectura / escritura)Enumerar e inspeccionar proyectos; crear, renombrar, duplicar y modificar configuraciones segurasInformar sobre tus proyectos o configurar otros nuevos
Recursos (lectura)Enumerar recursos e inspeccionar los nombres y la jerarquía de las piezas de un modeloHablar sobre las mallas dentro de tus modelos
Materiales (lectura / escritura)Consulta la biblioteca; crea y edita materiales y asígnalos a variantesCrea u organiza tu biblioteca de materiales
Configurador (lectura / escritura)Consulta y crea bloques de opciones, variantes y reglas condicionalesCrea o reorganiza las opciones que ven los compradores
Precios (lectura / escritura)Consulta precios y fórmulas; propone cambios en precios, SKU y fórmulasGestiona los precios. Cada modificación de precios es una propuesta que apruebas.
Formularios (lectura / escritura)Consulta y crea campos de formularios de presupuestos y pagoCrea o ajusta tu formulario de captación de leads
Presupuestos (lectura)Solicitudes de presupuesto enviadas, incluidos los datos de los clientesResume los leads entrantes. Estos son datos de clientes, así que concede el acceso de forma deliberada.
Comercio (lectura / escritura)Si una tienda está conectada, sus productos y las propuestas para vincular un producto o configurar el modo de pagoVincula un proyecto a un producto de la tienda. Nunca otorga las credenciales de la tienda.
Flujos de trabajo (lectura / escritura)Sigue los flujos de trabajo del agente; inícialos, responde a sus preguntas, ponlos en pausa o cancélalosEjecuta o supervisa una tarea de mayor duración, como una auditoría de proyecto
Documentación (lectura)La documentación oficial de Simplio3D, sin datos del espacio de trabajoResponde preguntas sobre el producto con una fuente

Varias conexiones pequeñas son más seguras que una que pueda hacerlo todo. Asigna al asistente que revisa precios su propia conexión con permisos de lectura y escritura de precios, y otra distinta al que crea proyectos. Así, revocar una nunca interrumpe a la otra.

Cómo permanecen los cambios bajo tu control

Permitir que una IA edite un configurador activo solo funciona si una edición incorrecta no puede llegar a tus clientes. Simplio3D gestiona cada escritura en tres pasos: proponer, confirmar, guardar una instantánea.

  • Las ediciones de bajo riesgo se realizan sin esperar tu intervención, como cambiar el nombre de un bloque o añadir una variante.
  • Los cambios de alto riesgo solo generan una propuesta: precios, SKU, eliminaciones, ediciones masivas, materiales compartidos y enlaces de productos de la tienda. La propuesta queda pendiente en Cambios de IA pendientes, en la página Conexiones de IA, y enumera todos los cambios que realizaría. Pulsa Aplicar o descártala. Ningún agente puede aprobar su propia propuesta, y esta regla no se puede desactivar.
  • Se guarda una instantánea de cada cambio aplicado, de modo que puede deshacerse, volver a validarse y registrarse en un historial de auditoría.

Las propuestas tienen una duración limitada. Si el proyecto ha cambiado desde que el agente propuso algo, la propuesta anterior se rechaza en lugar de sobrescribir tus ediciones más recientes; vuelve a pedírselo al agente.

Además, una llamada a herramienta solo se realiza cuando se superan cuatro comprobaciones: la dirección de correo de la cuenta está verificada, el plan del propietario del espacio de trabajo está activo, el rol de la plaza permite la acción y la conexión cuenta con el permiso correspondiente. Prevalece siempre la restricción más limitada. Por ejemplo, una plaza de Viewer nunca puede realizar ni confirmar un cambio, independientemente de los permisos de su conexión.

Cómo configurar conectores MCP para Simplio3D

La ruta con token funciona en todos los clientes. ¿Usas Claude? La ruta OAuth de abajo evita el uso del token.

  1. Conexiones de IA

    En Simplio3D, ve a Panel de control → Integraciones → Conexiones de IA y copia el endpoint MCP que aparece en la parte superior de la página.

  2. Crea una conexión por herramienta

    Haz clic en Crear conexión y asígnale el nombre de la herramienta que la utilizará, como «Claude Desktop» o «Cursor». Una conexión por herramienta deja claro cuál revocar más adelante.

  3. Elige el espacio de trabajo

    Una conexión queda vinculada permanentemente al espacio de trabajo que elijas aquí. Para trabajar con dos espacios de trabajo, crea una conexión desde cada uno.

  4. Marca solo los permisos que necesita

    Empieza con acceso de solo lectura y añade permisos de escritura de uno en uno. Concede acceso a Presupuestos solo cuando el agente deba ver los datos de los clientes.

  5. Copia el token y añádelo a tu herramienta

    El token comienza con smcp_ y se muestra una sola vez, nunca más. Pégalo en tu herramienta de IA junto con el endpoint, como se muestra en la tabla siguiente. Trátalo como una contraseña: dura 90 días y puedes renovarlo o revocarlo en cualquier momento.

  6. Comprueba la conexión

    Haz una pregunta que solo tu cuenta pueda responder: «Enumera mis proyectos de Simplio3D y dime cuáles están publicados». Si la respuesta menciona tus proyectos reales, el conector funciona.

Conectar Claude sin un token. Simplio3D aparece en el directorio de conectores de Claude. En Claude, abre Personalizar → Conectores, busca Simplio3D y haz clic en Conectar, o elige Añadir conector personalizado y pega https://app.simplio3d.ai/mcp. En ambos casos, Claude abre el inicio de sesión de Simplio3D y una pantalla de consentimiento en la que eliges el espacio de trabajo y los permisos, con el acceso de solo lectura marcado previamente. A continuación, la conexión aparece en la misma lista de conexiones de IA, identificada como aplicación OAuth, y puedes renovarla o revocarla allí como cualquier otra.

Dónde cada cliente de IA configura el conector de Simplio3D
Cliente de IADónde añadirloQué añadir
Claude (OAuth)Personalizar → Conectores: busca Simplio3D o selecciona Añadir conector personalizadoNinguno del directorio; la URL del endpoint para un conector personalizado. Sin token: en su lugar, apruebas la pantalla de consentimiento de Simplio3D.
Claude DesktopConfiguración → Desarrollador → Editar configuración (claude_desktop_config.json)Un servidor «simplio3d» de tipo http, con la URL del endpoint y un encabezado Authorization: Bearer smcp_…
Claude CodeTu terminalclaude mcp add --transport http simplio3d https://app.simplio3d.ai/mcp --header "Authorization: Bearer smcp_…"
Cursor~/.cursor/mcp.json o .cursor/mcp.json para un proyectoUn servidor «simplio3d» con la URL del endpoint y el encabezado Authorization
VS Code (GitHub Copilot).vscode/mcp.jsonUn servidor HTTP con la URL del endpoint, que lee el token desde una solicitud de contraseña en lugar de almacenarlo en el archivo
ChatGPT y CodexChatGPT → Plugins: busca Simplio3D, luego instala el plugin y conecta Simplio3DNada: el plugin incluye el conector. No se necesita token: inicia sesión en Simplio3D y aprueba el acceso

Prompts para probar primero

Indica el nombre del proyecto y pide pruebas: «¿qué regla lo oculta?» ofrece una respuesta más precisa que «¿por qué está oculto?».

Ejemplos de prompts para un conector MCP de Simplio3D
PreguntarLo que verifica el agenteLo que obtienes como resultado
“Audita mi configurador Oak Dining Table y enumera todo lo que no funciona.”Encuentra el proyecto y luego lo valida, incluidos los nombres de las piezas en el modelo 3DHallazgos por gravedad: objetivos de piezas faltantes, materiales eliminados, reglas que nunca pueden activarse y variantes sin precio
«¿Por qué el acabado Walnut está oculto cuando elijo la parte superior pequeña?»Los bloques de opciones y las reglas condicionales, y luego los evalúaLa regla que lo oculta y la condición que coincidió
«¿Todas las variantes de este configurador tienen precio?»Los bloques de precios y luego una fase de validaciónLas variantes sin precio por nombre, con el bloque de precios al que pertenece cada una
«¿Qué opciones se dirigen a piezas que ya no existen en el modelo?»Los objetivos que ha creado con respecto a la geometría realLos objetivos obsoletos, enumerados
«¿Cuánto costaría el roble en tamaño grande?»Los bloques de opciones y, después, un cálculo de precio en el servidorEl precio base, cada ajuste, los impuestos y el total en la moneda del proyecto
«Resume las solicitudes de presupuesto que recibimos esta semana.»Las solicitudes de presupuesto y cada configuraciónLos datos de contacto, lo que configuró cada cliente y el precio en ese momento

Límites que conviene conocer antes de depender de él

  • Los agentes leen datos guardados. El editor guarda automáticamente unos segundos después de cada cambio, por lo que es posible que una edición realizada hace unos instantes aún no sea visible. Guarda y vuelve a preguntar.
  • Los precios y la lógica del lado del servidor tienen salvedades. El cálculo de precios y la evaluación de reglas cubren los casos habituales, pero no todos los comportamientos del configurador publicado, como los precios por unidad de Number Input. Cada resultado indica lo que no evaluó, y la vista previa y la vista compartida publicada siguen siendo la referencia definitiva.
  • Límites de frecuencia. Cada conexión puede realizar 300 solicitudes cada cinco minutos. Un espacio de trabajo acepta 30 cambios de IA aplicados cada diez minutos, compartidos entre todos los agentes conectados y el asistente integrado.
  • Las respuestas extensas se recortan y se indica. Un resultado de más de aproximadamente 60 KB se resume y se marca como truncado, para que el agente no confunda una parte de una lista con su totalidad.
  • Lo que lee el agente se envía a tu proveedor de IA. Las solicitudes de presupuesto incluyen nombres y datos de contacto de clientes, así que concede el alcance de Presupuestos de forma deliberada.
  • Los tokens caducan después de 90 días. Rota uno de inmediato si se ha pegado en un chat, un ticket de soporte o una pantalla compartida. La rotación desactiva el token anterior al instante.

Una capa de herramientas detrás de cada interfaz de IA

El servidor MCP no es un producto independiente añadido aparte. El asistente de IA integrado de Simplio3D, el endpoint de herramientas autenticado de REST para tus propias automatizaciones y los clientes MCP externos utilizan el mismo registro de herramientas, con la misma autenticación, permisos y registro de auditoría. Una capacidad se comporta igual independientemente de dónde la invoques, y un alcance o rol que la bloquea en un lugar la bloquea en todas partes.

Así es también como MCP se diferencia de REST API y SDK. SDK es un cliente tipado para tu propio código, autenticado con una clave API, y esa clave nunca se acepta en el endpoint MCP. MCP está pensado para agentes de IA, autenticados mediante una conexión cuyo alcance se define por herramienta.

Preguntas sobre conectores MCP

Todos ellos: Starter, Pro y Enterprise, además de la prueba de Pro de 30 días con la que comienza cada cuenta. Los conectores MCP están incluidos en Starter desde septiembre de 2026. En Starter, un agente conectado sigue las mismas reglas del plan que el panel de control, por lo que no puede crear proyectos Modulares ni duplicar un proyecto.

¿Está creando primero el configurador?

Cómo un proyecto pasa de un modelo 3D a opciones, lógica condicional y precios antes de que un agente siquiera lo revise.

¿Quieres que el agente revise tus precios?

Los bloques de precios y el editor de fórmulas que un agente conectado consulta y utiliza para realizar cálculos.

¿Quieres que la IA también redacte el configurador?

Genera con planes de IA las opciones, reglas, precios y formularios a partir de una descripción de producto, dentro de Simplio3D.

¿Usas ChatGPT?

El plugin Simplio3D del directorio de Plugins de ChatGPT realiza esta conexión por ti, con un inicio de sesión guiado en lugar de un token.

Del blog

Guías, tutoriales y noticias del equipo de Simplio3D.

Crea, implementa y escala el comercio 3D.

Posee un configurador de productos 3D para impulsar ventas y generar propuestas directamente desde tu sitio web.

Artículos relacionados