Vizbl conector MCP
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.

Tu cliente de IA
Adjuntas un modelo y pides la importación
mcp.vizbl.com
Conector sin estado: aquí no se guarda nada
Vizbl Developer API
Cadena de conversión y tu catálogo 3D

Inicio rápido

Tres pasos, alrededor de un minuto.
  1. Añade la URL de abajo a tu cliente como conector personalizado.
  2. Aprueba la pantalla de consentimiento. El campo de la clave API es opcional: déjalo vacío para empezar.
  3. Conéctate con tu clave secreta, adjunta un archivo 3D o CAD y di «conviértelo a USDZ».
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.

  1. 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.

  2. 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.

  3. Añade una clave secreta para tu propia biblioteca

    Siete de las doce herramientas no necesitan cuenta de Vizbl. Para convertir modelos, alojar archivos e 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.

  4. 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.

HerramientaAccesoQué 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.
get_account
Ver cuenta
Solo lectura Empresa, saldo de tokens, suscripciones y límites del plan de la cuenta Vizbl conectada.
get_pricing
Ver precios actuales
Solo lectura Precio actual en tokens de cada acción facturable según los planes de la cuenta, y paquetes de recarga.
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 requiere una conexión con clave secreta.
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.
create_image_upload_url
Enlace para subir imagen
Escritura Da un enlace de un solo uso para subir una foto (jpeg, png, webp) para generación 3D, una alfombra o una estancia, y su id de subida.
list_models
Listar modelos de Vizbl
Solo lectura Lista los modelos 3D de tu espacio de Vizbl con búsqueda y filtros por producto y activación, página a página.
get_model
Ver modelo de Vizbl
Solo lectura Lee un modelo: nombre, URL del producto, colocación, tamaño, variantes, activaciones y estado de publicación.
update_model
Actualizar modelo de Vizbl
Escritura Cambia el nombre, la descripción, la URL del producto, la categoría, la colocación, la marca, las etiquetas o el tamaño real de un modelo y publica el cambio.
publish_model
Publicar modelo de Vizbl
Escritura Publica la versión guardada de un modelo para que los widgets y enlaces la muestren.
set_model_activation
Activar modelo
Escritura Activa o desactiva un modelo para un producto de Vizbl; las activaciones cuentan para el límite de tu plan.
get_model_links
Enlaces del modelo
Solo lectura Devuelve los enlaces listos de un modelo: AR en el móvil, App Clip de iOS, visor 3D incrustable, página para QR y página de escaparate.
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.
get_install_instructions
Obtener instrucciones de instalación
Solo lectura Devuelve los pasos de instalación y el código de inserción de un producto Vizbl en una plataforma de tienda (Shopify, WooCommerce, BigCommerce, Wix o un sitio propio).
list_tryon_types
Listar tipos de prueba
Solo lectura Lista los tipos de producto (zonas) que admite el widget de AI Try-On.
get_tryon_widget
Obtener widget de prueba
Escritura Devuelve el código de inserción de AI Try-On para un tipo de producto, reutilizando o creando la clave pública.
set_shopify_tryon
Configurar prueba en Shopify
Escritura Configura AI Try-On en la tienda Shopify vinculada: ajustes de la tienda y activación por producto.
list_rugs
Alfombras
Solo lectura Lista tus alfombras (cada una con sus tamaños) o los tamaños de una alfombra.
list_floorings
Suelos
Solo lectura Lista tus suelos o las variantes de un suelo.
create_rug_from_photo
Alfombra desde foto
Escritura Crea una alfombra 3D a partir de una foto cenital y su tamaño real, como alfombra nueva. Gratis.
add_rug_size
Añadir tamaño de alfombra
Escritura Añade otro tamaño a una alfombra existente a partir de una foto. Gratis.
update_rug
Editar alfombra
Escritura Renombra una alfombra o fija la página de producto común a todos sus tamaños.
list_rooms
Estancias
Solo lectura Lista las fotos de estancias en las que el Room Viewer muestra alfombras, suelos y cuadros.
add_room
Añadir estancia
Escritura Añade tu propia foto de estancia al Room Viewer (dentro del límite de tu plan).
list_shopify_products
Ver productos de Shopify
Solo lectura Productos y variantes de la tienda Shopify vinculada.
link_model_to_product
Mostrar modelo en Shopify
Escritura Muestra un modelo 3D en variantes de producto de Shopify, dentro del límite del plan.
list_shopify_posters
Ver pósteres de Shopify
Solo lectura Productos póster de Wall Art y la cuota de activación del plan.
set_poster_active
Activar widget de póster
Escritura Activa o desactiva el widget de Wall Art para un póster.
get_analytics
Ver analítica del widget
Solo lectura Vistas, lanzamientos AR, conversiones y solicitudes bloqueadas por día, modelo, dominio o dimensión.
get_usage
Ver consumo de tokens
Solo lectura Abonos y cargos de tokens por periodo, producto o motivo.
list_invoices
Ver facturas
Solo lectura Facturas con su estado y la página para pagarlas; enlace al PDF si se pide.
create_checkout_link
Crear enlace de pago
Escritura Devuelve una página de pago para una recarga o un cambio de plan. Nunca cobra: pagas tú en el navegador.
list_api_keys
Ver claves públicas
Solo lectura Claves públicas del widget (pk_…) por producto. Las claves secretas nunca se muestran.
create_public_key
Crear clave pública
Escritura Crea una clave pública del widget para un producto.
get_domains
Ver dominios permitidos
Solo lectura Dominios del sitio donde pueden funcionar los widgets.
set_domains
Reemplazar dominios
Destructiva Reemplaza la lista de dominios e indica qué se añadió y qué se quitó. Claude pregunta antes de hacerlo.
list_members
Ver equipo
Solo lectura Miembros, invitaciones pendientes y roles de la empresa.
invite_member
Invitar al equipo
Escritura Invita a una persona por email con un rol que no sea de administrador.
submit_request
Enviar solicitud a Vizbl
Escritura Pide al equipo de Vizbl importar un catálogo, crear modelos o ayuda.
remove_room
Eliminar estancia
Destructiva Elimina una foto de estancia subida. Claude pregunta antes de hacerlo.
unlink_model
Quitar modelo de Shopify
Destructiva Quita el modelo 3D de las variantes del producto. Claude pregunta antes de hacerlo.
revoke_invite
Revocar invitación
Destructiva Revoca una invitación pendiente. Claude pregunta antes de hacerlo.
revoke_key
Revocar clave pública
Destructiva Revoca una clave pública del widget. Claude pregunta antes de hacerlo.
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, 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 60 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, 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 la conversión 3D, el alojamiento de archivos y 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.