Servidor MCP para asistentes de IA
Permite que Claude, ChatGPT y otros asistentes creen KuikCodes diseñados, cambien el destino de códigos impresos y lean el número de escaneos, a través del servidor MCP de KuikCode.
El servidor MCP de KuikCode permite que un asistente de IA trabaje en tu espacio de trabajo como lo haría un compañero de equipo: "haz un código QR para nuestro menú de primavera con los colores de nuestra marca", "apunta el código del lobby a la página nueva", "¿cuántos escaneos tuvieron los códigos de la feria la semana pasada?". Habla el Model Context Protocol, así que cualquier asistente que admita conectores MCP puede usarlo.
| Endpoint | https://mcp.kuikcode.com/mcp |
| Transporte | Streamable HTTP |
| Inicio de sesión | OAuth desde el asistente (Claude, ChatGPT), o una clave de API de KuikCode como token bearer (Claude Code, Cursor y otras herramientas para desarrolladores) |
| Plan | Business |
Conéctalo desde Claude o ChatGPT
- En el asistente, agrega un conector personalizado con el endpoint de arriba (en Claude, desde los conectores de su configuración, con la opción para agregar un conector personalizado; en ChatGPT, desde los conectores de su configuración).
- El asistente te lleva a KuikCode. Inicia sesión si te lo pide, elige el espacio de trabajo que puede usar, revisa la lista de herramientas y haz clic en Permitir. Solo los propietarios y administradores del espacio de trabajo pueden conectar un asistente, y el espacio de trabajo tiene que estar en el plan Business.
- De vuelta en el asistente, pide algo. La primera solicitud suele tardar unos segundos mientras se genera el diseño.
Cada conexión aparece en Configuración, Integraciones, Conector MCP, con quién la conectó y cuándo se usó por última vez. Desconectar termina el acceso del asistente en su siguiente solicitud; los códigos que creó se conservan.
Conéctalo con una clave de API
Las herramientas para desarrolladores que aceptan un token bearer pueden saltarse la pantalla de consentimiento. Crea una clave de lectura y escritura en Configuración, Desarrolladores y configura el servidor con Authorization: Bearer kc_live_.... Para Claude Code:
claude mcp add --transport http kuikcode https://mcp.kuikcode.com/mcp \
--header "Authorization: Bearer kc_live_..."Se aplican el presupuesto y el alcance de la propia clave. Una clave de solo lectura puede listar y leer, pero no crear.
Qué puedes pedir
El asistente trabaja con pedidos en lenguaje normal. Estos son algunos que corresponden a lo que puede hacer el servidor, con lo que pasa después:
| Tú dices | Qué pasa |
|---|---|
| "Haz un código QR para https://example.com/menu con los colores del sitio" | Propone un nombre, lee los colores de marca del sitio y te envía un link que muestra nueve opciones diseñadas, de la A a la I. No se guarda nada hasta que eliges una. |
| "Muéstrame otro conjunto" | Nueve opciones nuevas con los mismos colores, en un link nuevo. |
| "La B, pero usa #456566 y #f59e0b" | La opción B con tus dos colores y la misma composición, y la ves antes de guardar. |
| "La A, pero cuadrada" | El mismo diseño con forma y marco cuadrados. |
| "Marco con degradado dorado, ESCANEA arriba, TOCA LA PANTALLA abajo, puntos redondeados" | El marco, el texto, los puntos y los ojos se pueden ajustar en cualquier diseño o código guardado; ves el resultado antes de que se guarde. |
| "Muéstrame las plantillas" | Pregunta si te refieres a tus propias plantillas guardadas o a los diseños de KuikCode, y luego te envía un link a una página con la imagen y el nombre de cada una. |
| "Usa la plantilla Campaña de otoño" | Primero muestra la plantilla aplicada a tu link y guarda cuando dices que sí. Agrega colores o ajustes para modificarla. |
| "Blanco y negro, sin diseño, llámalo Póster del lobby" | Una vista previa del código simple, y lo guarda cuando dices que sí. |
| "Pon nuestro logo en el centro" (con una imagen o una URL) | Coloca el logo en el centro y vuelve a generar el diseño. |
| "En SVG, por favor" después de guardar | Un link de descarga del archivo para imprimir. PNG, SVG o JPG, hasta 4096 px. |
| "Verde, rombos en el marco, ojos más redondeados, borde doble" en un código guardado | Una vista previa del código con el nuevo estilo; solo se guarda cuando dices que sí. |
| "Guarda este estilo como plantilla" | El diseño se convierte en una plantilla del espacio de trabajo para códigos futuros. |
| "Muestra mis códigos de la carpeta Primavera" | Nombres, destinos, escaneos y un link a la miniatura de cada código. |
| "Apunta el código del lobby a https://example.com/winter" | Cambia el destino del código impreso; el diseño nunca cambia. |
| "Los iPhone a la App Store, Android a Play y todos los demás al sitio" | Lo convierte en reglas inteligentes, te las lee como frases y guarda cuando confirmas. |
| "¿Cuántos escaneos tuvieron los códigos de la feria la semana pasada?" | Totales, códigos principales, países y dispositivos para esa carpeta y ese periodo. |
| "Aquí tienes un CSV, un código por fila, con los colores de nuestra marca" | Primero, una vista previa: filas entendidas, problemas por línea e impacto en la cuota. El lote se crea solo después de que confirmas. |
| "Crea una foto de un latte sobre una barra de madera" | KuikCode genera la imagen, la guarda en tu Biblioteca y el asistente la muestra. Cada una cuenta para las imágenes generadas con IA mensuales del plan. Tus propias fotos y las imágenes que genera el propio asistente no se le pueden pasar a KuikCode desde el chat; esta es la forma de agregar una imagen nueva. |
| "Haz una KuikPage para nuestro menú de primavera" | Sugiere plantillas con links de vista previa, confirma el nombre y la dirección your-name.kuik.page, crea un borrador y envía una vista previa después de cada ronda de cambios. Solo publica cuando dices que sí. Consulta Crear una KuikPage con un asistente de IA. |
| "Publica este sitio" (después de que el asistente creó uno) | Comprime los archivos en un ZIP con index.html en la raíz, confirma el nombre y la dirección your-name.kuik.page, publica, envía el link en vivo y ofrece un KuikCode que lo abre. |
| "Actualiza el sitio del menú con estos cambios" | Vuelve a publicar el mismo sitio: la dirección se mantiene, así que los códigos impresos muestran la nueva versión. |
| "No lo guardes" o "deshaz eso" | Antes de elegir, no existe nada; después de guardar, elimina un código creado en el último día con cero escaneos. Todo lo demás se archiva desde el panel. |
Antes de guardar un código nuevo, el asistente pregunta una vez si quieres agregar una carpeta, etiquetas o parámetros de campaña UTM, o guardar el diseño como plantilla. Nada se guarda sin que lo veas. Para un código diseñado, el asistente envía un link a una página con nueve opciones, marcadas de la A a la I; para una plantilla, un código simple o cualquier ajuste, envía una sola vista previa. Tú respondes, y solo entonces se crea el código.
Qué puede hacer el asistente
| Herramienta | Qué hace |
|---|---|
workspace_context | Plan, límites y uso, para que el asistente pueda explicar un límite con números |
list_codes, get_code, render_code, download_code | Lista códigos con nombre, destino y miniatura, lee uno, muestra su diseño y obtiene un link de descarga del archivo para imprimir (PNG, SVG o JPG) |
list_folders, create_folder, list_templates, list_pages, get_page | Carpetas (listar y crear), plantillas con un link a una página de galería y KuikPages |
scan_summary, scan_timeseries | Escaneos totales, visitantes únicos y el último escaneo, comparados con el periodo anterior; número de escaneos por hora, día o semana. Se muestran como una tarjeta con gráfica en los asistentes que admiten vistas interactivas (Claude, ChatGPT), con una vista de tabla a un toque; en los demás, el asistente responde en texto |
preview_designs | Nueve variantes diseñadas con los colores de un sitio web, antes de crear nada; o una variante con tus colores, tu forma y tus ajustes |
create_code | Un código dinámico nuevo. Primero, el asistente confirma contigo el nombre y el origen del diseño. Por defecto se diseña con los colores del sitio de destino: la primera llamada devuelve cuatro variantes para elegir y no guarda nada, y la segunda llamada, con tu elección, crea el código. Una plantilla, el Brand Kit o negro sobre blanco simple se guardan de inmediato cuando los pides por su nombre. Un logo desde una URL o desde el chat va en el centro |
update_destination | Apunta un código impreso a un lugar nuevo. El diseño nunca cambia |
set_smart_rules | Dirige los escaneos según el dispositivo, el país, el idioma del dispositivo, la hora local, la fecha, el día de la semana, el número de escaneos o la ubicación. El asistente te lee las reglas como frases antes de guardar |
move_code | Guarda un código en una carpeta |
update_code | Cambia el nombre o las etiquetas, pone o quita un código de acceso, y configura o quita un webhook de escaneos |
set_logo | Coloca o quita el logo del centro y vuelve a generar el diseño |
restyle_code | Cambia en un código guardado los colores, la forma redonda o cuadrada, el color o el degradado del marco, el texto del marco, el motivo repetido, el tipo de punto, la forma de los ojos, el borde o el contorno. Primero muestra una vista previa y guarda cuando dices que sí |
save_as_template | Guarda el diseño de un código como plantilla del espacio de trabajo |
discard_code | Deshace un código que acaba de crear: solo códigos con menos de un día y cero escaneos; todo lo demás se archiva desde el panel |
create_codes_bulk | Un lote desde un CSV o desde filas. La primera llamada es una vista previa (filas entendidas, problemas por línea, impacto en la cuota); el lote se crea solo después de que confirmas |
list_page_templates, create_page, get_page_content, describe_blocks, edit_page, publish_page | Crea una KuikPage desde una plantilla: crea el borrador, lo lee, cambia bloques, páginas, menú y tema con operaciones de edición, y publica. Cada cambio viene con un link de vista previa; consulta Crear una KuikPage con un asistente de IA |
import_image, search_photos | Agrega una imagen a la Biblioteca desde un link (o un archivo, desde herramientas como Claude Code) o desde fotos de stock gratuitas, para usarla en una KuikPage |
generate_image | Una imagen a partir de una descripción, guardada en tu Biblioteca como JPEG (cuadrada, horizontal, vertical, ancha o alta), con un link público que puedes usar como logo de un código o en cualquier lugar de KuikCode que acepte una imagen. Se mide por mes según el plan |
list_sites, publish_site, prepare_site_upload | Lista los sitios alojados; publica un sitio estático como ZIP (index.html en la raíz, solo archivos estáticos, sin PHP ni otro código de servidor) en your-name.kuik.page, o vuelve a publicar uno en el mismo lugar. Los ZIP de más de unos 3 MB pasan por prepare_site_upload, que necesita un asistente capaz de ejecutar comandos de shell, como Claude Code. Consulta Sitios alojados |
El asistente no puede archivar códigos ni eliminar ningún código que pueda estar impreso, cambiar la facturación, administrar miembros, ni despublicar o eliminar KuikPages. Todo lo que hace cuenta para el plan del espacio de trabajo exactamente igual que una acción en el panel, y aparece en los mismos lugares.
Límites y rechazos
Las llamadas a herramientas comparten los límites de frecuencia de la API del espacio de trabajo. Las creaciones y generaciones de códigos diseñados tienen un tope de doce por minuto por conexión. Cuando una solicitud superaría un límite del plan, el asistente recibe los números y un link a Plan y facturación en lugar de un error, para que pueda decirte qué hacer. Business es el plan más alto que puedes contratar por tu cuenta; para límites más altos, contacta a KuikCode sobre Enterprise.
Privacidad
El servidor no guarda datos propios. Cada conexión OAuth funciona con una clave de API oculta, limitada al único espacio de trabajo que autorizaste; al desconectarla, se elimina su acceso. Las URL de destino, las claves y los tokens nunca aparecen en los registros del servidor.
Píxeles de retargeting
Activa tu Meta Pixel y tu etiqueta de Google Ads en cada escaneo, para que quienes escanearon tu material impreso vean tus anuncios después.
App de KuikCode para Canva
Agrega KuikCodes diseñados y editables a un diseño de Canva desde un panel dentro de Canva, guardados en tu espacio de trabajo como cualquier otro código.