TheQRCode.io MCP Sever

Genera códigos QR para URLs, WiFi, contactos y texto. La clave API de pago añade códigos guardados y análisis.

Ver en theqrcode.ioPrueba este MCPPatrocinado

Documentación

Servidor MCP de Códigos QR para Claude, Cursor y Agentes de IA

Una URL. Sin instalación. Añade generación de códigos QR a cualquier cliente de IA compatible con MCP en menos de un minuto.

URL del servidor MCP

https://mcp.theqrcode.io/mcp HTTP/SSE

Remoto, sin instalación

Funciona sobre HTTP/SSE. Apunta tu cliente a una URL. Nada que ejecutar localmente, sin npm, sin Docker.

Funciona en contexto

Claude y Cursor llaman a la herramienta automáticamente cuando pides un código QR. Sin llamadas manuales a la API.

Gratis para generar

Sin clave de API, sin registro, 100 solicitudes/hora por IP. Añade una clave del Plan de desarrollador para guardar códigos permanentemente y desbloquear las herramientas de analítica.

Configuración

Elige tu cliente y pega la configuración.

Abre Configuración → Desarrollador → Editar configuración y añade el bloque mcpServers:

{
  "mcpServers": {
    "theqrcode": {
      "url": "https://mcp.theqrcode.io/mcp"
    }
  }
}

Abre Configuración de Cursor → MCP → Añadir nuevo servidor MCP y pega la URL, o edita ~/.cursor/mcp.json directamente:

{
  "mcpServers": {
    "theqrcode": {
      "url": "https://mcp.theqrcode.io/mcp"
    }
  }
}

Otros clientes MCP

Cualquier cliente que soporte la especificación MCP con transporte remoto HTTP/SSE funciona. Apúntalo a https://mcp.theqrcode.io/mcp.

Pruébalo

Una vez conectado, solo pregunta. Estas indicaciones activan la herramienta automáticamente.

›

Genera un código QR para https://mysite.com

›

Crea un código QR WiFi para mi red "HomeNetwork" con contraseña "secret123"

›

Crea un código QR para mi información de contacto: nombre John Doe, correo john@example.com

›

Genera un código QR azul oscuro para https://example.com, 512px

›

Crea un código QR con el texto "Mesa 12" para mi restaurante

Referencia de herramientas

Tres herramientas. Las tres se listan en cada cliente; las dos herramientas de cuenta se rechazan en el momento de la llamada sin una clave.

generate_qr_code

Genera una imagen de código QR y devuelve tanto una URL alojada como un PNG base64 para visualización en línea.

Gratis, sin clave. Tipos url, wifi, contact, text, a 100 solicitudes/hora por IP. Con una clave del Plan de desarrollador también acepta email, y cada código que crea se guarda en tu cuenta permanentemente en lugar de devolver un enlace de vista previa de 24 horas.

Parámetro	Tipo	Obligatorio	Descripción
type	enum		`url` · `wifi` · `contact` · `text`
content	string		Datos a codificar: URL, cadena WiFi, vCard o texto plano
size	integer	-	Tamaño de salida en píxeles (64-1024). Predeterminado: 256
darkColor	string	-	Color hexadecimal para módulos oscuros. Predeterminado: `#000000`
lightColor	string	-	Color hexadecimal para el fondo. Predeterminado: `#FFFFFF`

Formato de contenido WiFi

WIFI:T:WPA;S:MyNetwork;P:MyPassword;;

Esquema completo

{
  "name": "generate_qr_code",
  "description": "Generate a QR code image. Use this whenever a user asks to create, make, or generate a QR code for a URL, website, WiFi network, contact card, or text. Returns a hosted image URL (valid 24 hours) and a base64 PNG for inline display.",
  "parameters": {
    "type": {
      "type": "string",
      "enum": ["url", "wifi", "contact", "text"],
      "required": true
    },
    "content": {
      "type": "string",
      "required": true,
      "description": "Data to encode"
    },
    "size": {
      "type": "integer",
      "min": 64,
      "max": 1024,
      "default": 256
    },
    "darkColor": {
      "type": "string",
      "example": "#000000"
    },
    "lightColor": {
      "type": "string",
      "example": "#FFFFFF"
    }
  }
}

list_qr_codesPlan de desarrollador

Lista los códigos QR guardados en tu cuenta, para que puedas preguntar "¿qué códigos QR tengo para el restaurante?" y obtener una respuesta de tus datos reales.

Parámetro	Tipo	Descripción
page	integer	Número de página. Predeterminado: 1
limit	integer	Códigos por página (1-100). Predeterminado: 20
type	enum	Filtrar por tipo: url, wifi, contact, text, email

get_analyticsPlan de desarrollador

Analítica de escaneos para tus códigos — en toda la cuenta o para un código. Pregunta "¿cómo le fue al código de la tarjeta de mesa el mes pasado?" y el asistente lee tus datos reales de escaneo: escaneos totales y únicos, hora, ubicación aproximada, dispositivo y sistema operativo, y campaña. Qué significa cada métrica →

Parámetro	Tipo	Descripción
qrCodeId	string	ID de un código. Omítelo para totales de toda la cuenta
timeRange	enum	1h · 1d · 7d · 30d (predeterminado) · 90d · 1y

Añade un encabezado Authorization a la misma configuración. Sin él, la sesión es anónima y solo funciona generate_qr_code. Las claves vienen con el Plan de desarrollador.

{
  "mcpServers": {
    "theqrcode": {
      "url": "https://mcp.theqrcode.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Respuesta

imageUrl

URL de PNG alojado. En el nivel gratuito es una vista previa y deja de servirse después de 24 horas

image (base64)

PNG en línea para clientes que renderizan imágenes directamente

El código QR no caduca — el enlace de vista previa gratuito sí. El patrón codificado es permanente, por lo que una imagen descargada funciona para siempre. Es el alojamiento de esa imagen en el nivel gratuito lo que es temporal: descárgala, o conecta una clave de desarrollador y el código se almacena en tu cuenta y permanece activo. Cómo funciona la permanencia →

También disponible

API REST

HTTP directo, sin necesidad de cliente MCP. Funciona desde cualquier lenguaje.

Ver documentación

Especificación OpenAPI

Importa en Postman, Insomnia, o genera un cliente tipado.

openapi.json

Manifiesto de plugin de IA

Formato de plugin OpenAI para integraciones de llamada a funciones.

Ver manifiesto

Preguntas frecuentes

Códigos QR, MCP, y lo que cada asistente puede hacer realmente.

¿Qué es un servidor MCP de códigos QR?

MCP (Protocolo de Contexto de Modelo) es un estándar abierto que permite a un asistente de IA llamar a herramientas externas. Un servidor MCP de códigos QR es un endpoint de herramienta que un asistente puede llamar para crear un código QR, de modo que preguntas en lenguaje natural en lugar de salir del chat para usar un sitio web. El nuestro es un servidor HTTP remoto en https://mcp.theqrcode.io/mcp — añades una URL a la configuración de tu cliente y no hay nada que instalar.

¿Puede Claude generar códigos QR?

Sí. Claude no puede dibujar un código QR escaneable por sí solo — la codificación es precisa y la generación de imágenes no lo es — pero con un servidor MCP conectado llama a un generador real y devuelve un código real. Añade la URL de nuestro servidor a la configuración de Claude Desktop y pide "haz un código QR para mi WiFi".

¿Puede ChatGPT generar códigos QR?

A través de nuestra API REST sin clave y el manifiesto de plugin OpenAI, sí — consulta la guía de agentes de IA en https://theqrcode.io/ai-agents para el esquema de llamada a funciones. El soporte MCP de ChatGPT depende del producto y plan que uses; la ruta REST funciona en todas partes.

¿Puede Cursor generar códigos QR?

Sí. Añade la URL del servidor a ~/.cursor/mcp.json, reinicia Cursor y pregunta. La herramienta se activa automáticamente cuando tu solicitud necesita un código QR.

¿Requiere instalación local?

No. Sin npm, sin Docker, sin Python. Es un servidor HTTP transmisible remoto; tu cliente solo guarda una URL. El código fuente es público en https://github.com/awilliams-2020/theqrcode-mcp si prefieres ejecutarlo tú mismo.

¿Qué herramientas expone el servidor MCP?

Tres. generate_qr_code crea un código QR y es gratuito sin clave, para tipos url, wifi, contact y text. list_qr_codes devuelve los códigos guardados en tu cuenta. get_analytics devuelve analítica de escaneos — escaneos totales y únicos, hora, ubicación aproximada, dispositivo y sistema operativo — ya sea en toda la cuenta o para un código. Las dos últimas requieren una clave de API del Plan de desarrollador.

¿Cómo se ve el código QR devuelto?

Recibes dos cosas: una URL de PNG alojado en la que puedes hacer clic o pegar, y un PNG base64 que clientes como Claude Desktop renderizan en línea en la conversación. En el nivel gratuito, el enlace alojado es una vista previa de 24 horas, así que descarga la imagen. El código QR en sí nunca caduca — conecta una clave de desarrollador y el código se guarda en tu cuenta permanentemente.

¿Cómo funciona la autenticación?

Añade un encabezado Authorization: Bearer <your API key> a la configuración del servidor en tu cliente MCP. Sin él, la sesión es anónima y solo funciona generate_qr_code, a 100 solicitudes/hora por IP. Las claves vienen con el Plan de desarrollador a $19/mes.

¿Está en el registro oficial de MCP?

Sí, como io.theqrcode/qr-code-generator. El código fuente es público en https://github.com/awilliams-2020/theqrcode-mcp.

¿Listo para conectar?

Añade la URL del servidor a la configuración de tu cliente MCP y empieza a generar códigos QR desde cualquier conversación.

https://mcp.theqrcode.io/mcp