Model Context Protocol

Lleva tu catálogo 3D a la conversación.

El conector de Vizbl permite que Claude convierta archivos 3D y CAD, importe modelos a tu cuenta, siga la cadena de conversión y genere los enlaces AR, los códigos QR y los botones de ficha de producto que los ponen delante de tus clientes, todo sin salir del chat. Adjunta un archivo, describe lo que necesitas y Claude se encarga del resto.

Conectar el servidor Ver las herramientas

Tu cliente de IA
Adjuntas un modelo y pides la importación

OAuth 2.0 · tu aprobación, tus permisos

mcp.vizbl.com
Conector sin estado: aquí no se guarda nada

Clave API opcional · tu cuenta

Vizbl Developer API
Cadena de conversión y tu catálogo 3D

Inicio rápido

Tres pasos, alrededor de un minuto.

Añade la URL de abajo a tu cliente como conector personalizado.
Aprueba la pantalla de consentimiento. El campo de la clave API es opcional: déjalo vacío para empezar.
Adjunta un archivo 3D o CAD y di «conviértelo a USDZ». Añade una clave más tarde para importar a tu propia biblioteca.

https://mcp.vizbl.com/mcp

Ya está. Todo lo que sigue es material de referencia: vuelve cuando lo necesites.

Conéctate en cuatro pasos

Vizbl es un servidor MCP remoto: no hay que instalar ni ejecutar nada en local. Puede conectarse cualquier cliente MCP compatible con servidores remotos y OAuth.

Añade el servidor a tu cliente

En Claude, añade un conector personalizado con esta URL:
```
https://mcp.vizbl.com/mcp
```
En Claude Code, añádelo desde la terminal:
```
claude mcp add --transport http vizbl https://mcp.vizbl.com/mcp
```
Transporte: Streamable HTTP. El registro del cliente es dinámico: no necesitas dar de alta ninguna aplicación en Vizbl.
Autoriza la conexión

Tu cliente abre la pantalla de consentimiento de Vizbl. Revisa el acceso solicitado y aprueba. El campo de la clave API es opcional: déjalo vacío para conectarte sin cuenta de Vizbl.
Añade una clave secreta para tu propia biblioteca

Nueve de las doce herramientas no necesitan cuenta de Vizbl. Para importar, subir y eliminar modelos, crea en tu cuenta de Vizbl una clave de la Developer API de tipo secreta –empieza por sk_live_ y se muestra una sola vez, al crearla– y pégala en la pantalla de consentimiento. La clave queda sellada dentro de los tokens cifrados que se emiten a ese cliente y nunca se almacena en nuestros servidores. Puedes volver a conectarte en cualquier momento para añadirla o cambiarla.
Empieza a trabajar

Adjunta un archivo 3D o CAD y pide a Claude que lo convierta o –con una clave– que lo importe a tu biblioteca. Los tokens de acceso duran 60 minutos y se renuevan de forma silenciosa hasta 90 días; después basta con volver a aprobar una vez.

Herramientas

Las operaciones de lectura y escritura son herramientas independientes. Las de solo lectura se ejecutan sin preguntar cada vez; la destructiva siempre pide tu confirmación.

Herramienta	Acceso	Qué hace
`get_guide` Obtener guía de Vizbl	Solo lectura	Devuelve la guía oficial de Vizbl sobre un tema: primeros pasos, instalación, dominios, tokens, tipos de prueba virtual, dimensiones de impresión, generación 3D, el conversor, escenas y resolución de problemas. Claude la consulta antes de explicar cómo funciona Vizbl.
`estimate_costs` Estimar coste en tokens	Solo lectura	Convierte el tráfico y el tamaño del catálogo en un consumo mensual estimado de tokens, siempre como un rango con las suposiciones explícitas. Solo tokens: los precios de Vizbl se muestran en la página de pago.
`convert_3d_model` Convertir modelo 3D	Escritura	Convierte y optimiza un archivo 3D o CAD adjunto a la conversación a GLB, USDZ o FBX. Admite 14 formatos de origen y devuelve el identificador de la tarea de conversión.
`get_job_status` Consultar estado de la tarea	Solo lectura	Devuelve el estado actual de una operación larga –una conversión o una importación– con su fase, avisos, error y, al terminar, su resultado. Puede esperar un tiempo acotado en lugar de sondear.
`create_public_upload_url` Publicar un archivo	Escritura	Aloja un modelo o una imagen local en el almacén de subidas de Vizbl y devuelve una URL https pública. Necesario allí donde una herramienta pide una URL —la conversión, o la imagen de un botón de Wall Art— y funciona sin cuenta de Vizbl.
`create_upload_url` Crear URL de subida	Escritura	Crea una sesión de subida firmada para que subas un archivo de modelo desde tu propio dispositivo. Devuelve el destino de la subida y el identificador que usa la herramienta de importación.
`upload_model` Subir modelo 3D	Escritura	Publica un modelo 3D en Vizbl a partir de un archivo adjunto a la conversación o de un identificador de subida. Admite modelos con varias variantes y, de forma opcional, nombre, descripción, etiquetas, categoría y mecánica de colocación. Devuelve el identificador de la tarea de importación.
`get_ar_link` Obtener enlace AR	Solo lectura	Construye, a partir del Object ID, el enlace público que abre un objeto publicado en AR desde el móvil.
`get_qr` Obtener código QR	Solo lectura	Genera un código QR del enlace AR en SVG y PNG, para impresión, embalaje y fichas de producto. Se genera en nuestros servidores; el enlace nunca se envía a un servicio QR de terceros.
`get_widget_snippet` Obtener fragmento del widget	Solo lectura	Construye el HTML del botón AR para la ficha de producto: el script de arranque con su llamada de inicio y el botón con los identificadores del objeto. Cubre las variantes App Clip, AR nativa y visor 3D.
`generate_wallart_buttons` Generar botones de Wall Art	Solo lectura	Genera un lote de botones de prueba de Wall Art a partir de una lista de productos y valida las dimensiones físicas de impresión, señalando los valores que parecen ser la resolución de la imagen.
`delete_model` Eliminar modelo de Vizbl	Destructiva	Elimina un objeto existente de Vizbl por su Object ID público. Claude siempre pide confirmación antes de ejecutarla.

Las herramientas visibles dependen de los permisos que concediste al autorizar: una conexión aprobada solo para lectura no mostrará las de importación ni de eliminación. Las herramientas de referencia –guías, estimaciones de coste, conversión, enlaces y fragmentos– no tocan datos de la cuenta y están siempre disponibles.

Ejemplos de instrucciones

Peticiones en lenguaje natural: Claude elige las herramientas. Funcionan tal cual.

Importa este chair.glb en Vizbl, llámalo “Silla de roble”, etiquétalo como mobiliario y dame el enlace cuando esté listo.

Claude llama a upload_model con el archivo adjunto, después a get_job_status hasta que el modelo se convierte y responde con la URL pública del objeto.

¿Qué ha pasado con la importación de Vizbl que empecé antes?

Claude llama a get_job_status con el identificador de la tarea e informa de la fase actual o del error si la importación falló.

Aquí tienes tres archivos de modelo de la colección de verano: impórtalos todos en Vizbl como objetos de pared y resume los resultados.

Claude llama a upload_model una vez por archivo con un criterio de nombres común y devuelve una tabla con los identificadores y sus estados.

Este es un archivo STEP de nuestro equipo de CAD: conviértelo en un GLB ligero para la ficha de producto.

Claude llama a convert_3d_model, lo sigue con get_job_status y ofrece importar el resultado en Vizbl.

Tenemos 400 alfombras y unas 60.000 visitas al mes: ¿cuántos tokens de Vizbl deberíamos presupuestar?

Claude llama a estimate_costs y responde con un rango, las suposiciones en las que se basa y un paquete recomendado, en tokens y nunca en moneda.

Dame el botón AR y un código QR del objeto a1b2c3d4 para la ficha de producto y el embalaje.

Claude llama a get_widget_snippet y a get_qr, y te recuerda que añadas el dominio de tu tienda a la lista permitida en Vizbl.

Elimina el objeto de Vizbl con tinuuid a1b2c3d4: lo subimos dos veces.

Claude te pide confirmación y después llama a delete_model con ese tinuuid.

Qué esperar

Límites prácticos del conector alojado.

Archivos y formatos

Formatos de importación: glb, gltf, obj, usdz, fbx
El conversor acepta: dae, fbx, glb, gltf, iges, igs, obj, ply, step, stp, stl, usd, usdc, usdz
Tamaño máximo de archivo: 200 MB por variante
Origen: Archivos adjuntos a la conversación o subidos desde tu equipo
Multivariante: Compatible; la primera variante es la principal

Tiempos y sesiones

Espera por llamada: hasta 90 segundos
Token de acceso: 60 minutos
Token de actualización: 90 días
Estado del servidor: Sin estado: no se guardan sesiones

Requisitos previos

No necesitas nada para empezar: las herramientas de referencia –guías, estimaciones de coste, conversión, enlaces y fragmentos– no necesitan ningún espacio de trabajo de Vizbl. Una cuenta de Vizbl con acceso a la Developer API y una clave secreta añade las herramientas de importación, subida y borrado; las importaciones consumen la cuota de conversión habitual de tu cuenta. El conector no crea cuentas, no modifica la facturación y no genera imágenes, vídeo ni audio con modelos de IA.

Cómo se tratan tus datos

La versión breve; el texto completo está en la política de privacidad.

Tu clave de API

Se cifra dentro de los tokens de OAuth que guarda tu cliente. El servidor no conserva ninguna copia ni mantiene una base de datos de conexiones.

Tus archivos de modelos

Se descargan en memoria, se envían a la Vizbl Developer API con tu cuenta y después se descartan. Quedan alojados en tu cuenta de Vizbl, igual que si los hubieras subido desde la aplicación.

Tu conversación

Al servidor solo llegan los argumentos de la llamada a una herramienta. Nunca solicitamos el historial del chat, la memoria ni archivos ajenos a una importación.

Soporte

Dudas, informes de errores y avisos de seguridad.

Contacto

Escríbenos a [email protected]. Si informas de una importación fallida, incluye el identificador de la tarea: es la forma más rápida de que rastreemos qué ocurrió.

Estado de servicio de este endpoint: https://mcp.vizbl.com/health

También de Vizbl

La misma Developer API está disponible de forma directa y a través del SDK @vizbl/node, que incluye un servidor MCP local para clientes de escritorio. Consulta vizbl.com.