QrVerloz MCP Server

Genera códigos QR al instante sin necesidad de cuenta — activos por 90 días, reclamables para siempre, con redirección de destino y análisis de escaneos.

GitHub

Prueba este MCPPatrocinado

Documentación

QrVerloz MCP Server

Códigos QR dinámicos: crea, redirige e inspecciona desde cualquier asistente de IA.
No se requiere cuenta para empezar.

¿Qué es QrVerloz?

QrVerloz es un servicio de códigos QR dinámicos. A diferencia de los códigos QR estáticos, los códigos de QrVerloz son redirigibles: imprimes una vez y cambias el destino en cualquier momento sin reimprimir. Realiza un seguimiento de cada escaneo con análisis en tiempo real, programa cambios automáticos de URL y gestiona todo desde tu asistente de IA mediante MCP.

URL del servidor MCP: https://qrverloz.com/api/mcp

No se requiere registro. Solicita una clave API una vez y empieza a crear códigos de inmediato.

Inicio rápido (30 segundos)

1 — Añade el servidor a tu cliente de IA

Consulta mcp-config-examples/ para ver configuraciones listas para copiar y pegar:

Cliente	Archivo de configuración
Claude Desktop (macOS / Linux)	claude-desktop.json
Claude Desktop (Windows)	claude-desktop-windows.json
Claude Code	claude-code.json
Cursor	cursor.json
VS Code con GitHub Copilot	vscode-copilot.json
Continue	continue.json
Cualquier otro cliente HTTP MCP	generic.md

Claude Desktop en Windows: usa claude-desktop-windows.json. El comando estándar npx falla en Windows cuando Node.js está instalado en C:\Program Files debido a un problema de rutas con espacios. La configuración de Windows usa cmd /c para solucionarlo.

VS Code: requiere VS Code 1.96 o posterior con la extensión GitHub Copilot. Coloca la configuración en .vscode/mcp.json en la raíz de tu espacio de trabajo.

2 — Obtén un token API gratuito

No se requiere correo electrónico ni contraseña. En tu asistente de IA, di:

Use the QrVerloz MCP tool to request an API key

El token se muestra solo una vez: guárdalo de inmediato.

Nota: Hay un límite de una solicitud de token por IP cada 24 horas para evitar abusos. Si la llamada falla, espera 24 horas o regístrate en qrverloz.com para obtener una cuenta permanente.

⚠️ Vida útil del código QR: Los códigos QR de invitado se eliminan permanentemente ~180 días después de emitir el token (token de 90 días + período de gracia de 90 días). Reclama tu cuenta en qrverloz.com/claim antes de que expire el token para conservar tus códigos de forma permanente.

3 — Añade el token a la configuración de tu cliente

Reemplaza YOUR_API_KEY en el archivo de configuración con tu token y reinicia tu cliente de IA:

Authorization: Bearer qrv_...

4 — Crea tu primer código QR

Use the QrVerloz MCP tool to create a QR code with the title "My first QR" pointing to https://example.com

Tu código QR está activo en https://qrverloz.com/r/{shortCode}. Imprímelo: puedes cambiar el destino en cualquier momento.

Referencia de herramientas

Herramienta	Autenticación	Descripción
`request_api_key`	Ninguna	Obtén un token API gratuito de 90 días. Sin registro.
`create_qr_code`	Opcional*	Crea un código QR dinámico que apunta a una URL.
`get_qr_code`	Requerida	Busca un código QR por ID o código corto.
`list_qr_codes`	Requerida	Lista todos tus códigos QR con URLs cortas y destinos.
`get_qr_scans`	Requerida	Obtén el número total de escaneos de un código QR.
`update_qr_target`	Requerida	Cambia a dónde redirige un código QR: sin necesidad de reimprimir.
`delete_qr_code`	Requerida	Elimina permanentemente un código QR y su historial de escaneos.
`get_account_info`	Requerida	Consulta tu plan, uso y capacidad restante de códigos QR.

*create_qr_code anónimo devuelve una URL de imagen CDN efímera (no almacenada, no redirigible). Los usuarios autenticados obtienen una URL corta permanente. Todas las respuestas de herramientas autenticadas se devuelven como tablas markdown preformateadas: muéstralas exactamente como se reciben.

`request_api_key`

Sin parámetros. Devuelve un token de 90 días. Las cuentas gratuitas obtienen hasta 5 códigos QR.

⚠️ Advertencia importante sobre la vida útil: El token expira después de 90 días. Los códigos QR se eliminan permanentemente aproximadamente 90 días después de la expiración del token (~180 días en total desde la creación). Para mantener tus códigos QR vivos de forma permanente, visita qrverloz.com/claim antes de que expire el token para vincular una dirección de correo electrónico.

Ejemplo de prompt:

Use the QrVerloz MCP tool to request an API key

`create_qr_code`

Parámetro	Tipo	Requerido	Descripción
`title`	string	Sí	Etiqueta legible (1–200 caracteres)
`target_url`	string (URL)	Sí	URL de destino: debe comenzar con `https://` o `http://`

Cuando le pides a tu asistente de IA que cree un código QR, devuelve una tabla formateada como esta:

Ejemplo de salida (autenticado):

Campo	Valor
Título	Summer Sale
ID	clxyz1234abcdef567890
Código corto	ab3k9x
URL corta	https://qrverloz.com/r/ab3k9x
Destino	https://example.com/sale
Estado	Activo
Creado	11 de abril de 2026
Enlace del código QR	Descargar imagen QR

Ejemplo de salida (token de invitado):

Se añade una fila Token expira como recordatorio para reclamar la cuenta antes de que expire el token.

Ejemplos de prompts:

Create a QR code titled "Summer Sale" pointing to https://example.com/sale

Use the QrVerloz MCP tool to create a QR code titled "Summer Sale" pointing to https://example.com/sale

¿Necesitas códigos QR para WiFi, vCard, SMS, teléfono o WhatsApp? Están disponibles en el panel de QrVerloz, solo que no a través del servidor MCP. Regístrate con una cuenta gratuita para acceder a ellos.

`get_qr_code`

Parámetro	Tipo	Requerido	Descripción
`qr_code_id`	string	Uno de	UUID interno de `create_qr_code` o `list_qr_codes`
`short_code`	string	Uno de	Código corto de la URL de redirección (p. ej. `abc123`)

Tu asistente de IA devuelve una tabla formateada como esta:

Ejemplo de salida:

Campo	Valor
Título	Summer Sale
ID	clxyz1234abcdef567890
Código corto	ab3k9x
URL corta	https://qrverloz.com/r/ab3k9x
Destino	https://example.com/sale
Estado	Activo
Creado	11 de abril de 2026
Enlace del código QR	Descargar imagen QR

Usuarios invitados: aparece una fila Token expira después de Enlace del código QR que muestra cuándo se eliminarán el token (y los códigos).

Ejemplo de prompt:

Use the QrVerloz MCP tool to get details for QR code with short code abc123

`list_qr_codes`

Parámetro	Tipo	Requerido	Descripción
`page`	integer	No	Número de página (predeterminado: 1)
`limit`	integer	No	Elementos por página, máx. 20 (predeterminado: 20)

Tu asistente de IA devuelve una línea de resumen seguida de una tabla formateada por cada código QR:

Ejemplo de salida:

Mostrando 2 de 2 código(s) QR (página 1)

Campo	Valor
Título	Summer Sale
ID	clxyz1234abcdef567890
Código corto	ab3k9x
URL corta	https://qrverloz.com/r/ab3k9x
Destino	https://example.com/sale
Estado	Activo
Creado	11 de abril de 2026
Enlace del código QR	Descargar imagen QR

Campo	Valor
Título	Conference Badge
ID	clxyz9876zyxwvu54321
Código corto	tz7m2p
URL corta	https://qrverloz.com/r/tz7m2p
Destino	https://example.com/conference
Estado	Activo
Creado	13 de abril de 2026
Enlace del código QR	Descargar imagen QR

Usuarios invitados: cada tarjeta incluye una fila Token expira después de Enlace del código QR.

Ejemplo de prompt:

Use the QrVerloz MCP tool to list all my QR codes

`get_qr_scans`

Parámetro	Tipo	Requerido	Descripción
`qr_code_id`	string	Sí	UUID interno del código QR

Tu asistente de IA devuelve la misma tabla que get_qr_code con una fila adicional Escaneos totales. Los usuarios invitados también ven una fila Token expira (entre Enlace del código QR y Escaneos totales).

Ejemplo de salida:

Campo	Valor
Título	Summer Sale
ID	clxyz1234abcdef567890
Código corto	ab3k9x
URL corta	https://qrverloz.com/r/ab3k9x
Destino	https://example.com/sale
Estado	Activo
Creado	11 de abril de 2026
Enlace del código QR	Descargar imagen QR
Escaneos totales	147

Ejemplo de prompt:

Use the QrVerloz MCP tool to get the scan count for QR code clxyz...

`update_qr_target`

Parámetro	Tipo	Requerido	Descripción
`qr_code_id`	string	Uno de	UUID interno
`short_code`	string	Uno de	Código corto de la URL de redirección
`target_url`	string (URL)	Sí	Nueva URL de destino: debe comenzar con `https://` o `http://`

Nota: Solo los códigos QR de tipo URL se pueden actualizar mediante MCP. Para códigos QR de WiFi, vCard, SMS, teléfono, WhatsApp, PDF y audio, gestiona esos desde el panel de QrVerloz.

Ejemplo de prompt:

Use the QrVerloz MCP tool to update QR code abc123 to point to https://example.com/new-page

`delete_qr_code`

Parámetro	Tipo	Requerido	Descripción
`qr_code_id`	string	Uno de	UUID interno
`short_code`	string	Uno de	Código corto de la URL de redirección
`confirm_title`	string	Sí	Título exacto del código QR: debe coincidir carácter por carácter para evitar eliminaciones accidentales

Ejemplo de prompt:

Use the QrVerloz MCP tool to delete the QR code titled "Old Campaign"

`get_account_info`

Sin parámetros. Devuelve tu plan actual, indicadores de funciones, uso de códigos QR y capacidad restante. Útil para que los agentes de IA verifiquen antes de intentar crear códigos.

Ejemplo de prompt:

Use the QrVerloz MCP tool to show my account info

Autenticación

Modo	Cabecera	Límites
Anónimo	(ninguna)	Hasta 30 imágenes efímeras/día: no almacenadas, no redirigibles
Token Bearer	`Authorization: Bearer qrv_...`	Hasta 5 códigos almacenados (plan Gratuito) · 60 solicitudes/min en todas las herramientas

Obtén un token al instante: no se requiere correo electrónico.
Para reclamar una cuenta permanente: qrverloz.com/claim

API REST

También hay disponible una API REST completa para integraciones HTTP directas.

Documentación interactiva: qrverloz.com/docs/api ↗
Especificación OpenAPI: openapi.yaml

Ejemplos

Hay scripts listos para ejecutar en:

examples/js/ — Node.js 18+ (sin dependencias, usa fetch nativo)
examples/python/ — Python 3.8+ (requiere requests)

Solución de problemas

El asistente de IA no reconoce el nombre de la herramienta

No escribas nombres de herramientas como llamadas de función (p. ej. request_api_key()). Usa lenguaje natural en su lugar:

"Usa la herramienta MCP de QrVerloz para solicitar una clave API"

Claude Desktop: `'C:\Program' is not recognized` (Windows)

Este es un error de Windows por rutas con espacios. Node.js instalado en C:\Program Files hace que cmd.exe falle cuando la ruta no está entre comillas.

Solución: usa claude-desktop-windows.json que utiliza cmd /c para evitar el problema.

El servidor MCP no se conecta

Claude Desktop:

Revisa el icono de martillo (🔨) en la barra de entrada del chat: lista los servidores conectados. Si QrVerloz no aparece, el servidor no pudo conectarse.
Abre los registros mediante Help → Open Logs Folder y busca errores del servidor qrveloz.
Asegúrate de que Node.js 18+ esté instalado (node --version) y que npx esté disponible (npx --version).
Prueba la conexión manualmente: npx -y mcp-remote https://qrverloz.com/api/mcp

VS Code con GitHub Copilot:

Abre la Paleta de comandos (Ctrl+Shift+P) y ejecuta MCP: List Servers: QrVerloz debería aparecer con estado running.
Si muestra un error, verifica que VS Code sea 1.96+ y que la extensión de Copilot esté activa.
Asegúrate de que .vscode/mcp.json esté guardado y el espacio de trabajo esté abierto.

Cursor / Continue / otros clientes HTTP:

Verifica que la URL sea exactamente https://qrverloz.com/api/mcp: sin barra final.
Confirma que el valor de la cabecera Authorization comience con Bearer (nota el espacio).
Prueba el endpoint directamente: curl -X POST https://qrverloz.com/api/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

El token se mostró pero no lo guardé

Los tokens de invitado no se pueden recuperar una vez que se descarta la respuesta. Opciones:

Espera 24 horas y llama a request_api_key de nuevo desde la misma IP
Regístrate en qrverloz.com para obtener una cuenta permanente con gestión de tokens en el panel de Configuración

Límite de velocidad alcanzado en `request_api_key`

Se emite un token de invitado por IP cada 24 horas para evitar abusos. Si alcanzas el límite, espera 24 horas o crea una cuenta gratuita en qrverloz.com.

Precios

Consulta qrverloz.com/#pricing para obtener detalles y límites actuales del plan.

Licencia

MIT — consulta LICENSE.

QrVerloz MCP Server

Documentación

QrVerloz MCP Server

¿Qué es QrVerloz?

Inicio rápido (30 segundos)

1 — Añade el servidor a tu cliente de IA

2 — Obtén un token API gratuito

3 — Añade el token a la configuración de tu cliente

4 — Crea tu primer código QR

Referencia de herramientas

request_api_key

create_qr_code

get_qr_code

list_qr_codes

get_qr_scans

update_qr_target

delete_qr_code

get_account_info

Autenticación

API REST

Ejemplos

Solución de problemas

El asistente de IA no reconoce el nombre de la herramienta

Claude Desktop: 'C:\Program' is not recognized (Windows)

El servidor MCP no se conecta

El token se mostró pero no lo guardé

Límite de velocidad alcanzado en request_api_key

Precios

Licencia

`request_api_key`

`create_qr_code`

`get_qr_code`

`list_qr_codes`

`get_qr_scans`

`update_qr_target`

`delete_qr_code`

`get_account_info`

Claude Desktop: `'C:\Program' is not recognized` (Windows)

Límite de velocidad alcanzado en `request_api_key`