QRX

QRX convierte un prompt de texto y un enlace en un código QR de marca, listo para imprimir, verificado para escanear, con un enlace corto alojado en qrx.to que puedes redirigir. MCP remoto, asignación diaria gratuita.

Servidor MCP alojado

npx add-mcp 'https://qrx.codes/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

QRX

Códigos QR artísticos que siempre se escanean.

QRX crea códigos QR de marca, listos para imprimir, para carteles, menús, empaques y señalización. Describe el aspecto que deseas y proporciona un enlace: QRX pinta el código en la obra de arte, verifica que se decodifique antes de entregarlo y lo dirige a un enlace corto alojado, https://qrx.to/<id> en qrx.codes, que puedes redirigir más tarde en el plan Starter. Este repositorio conecta QRX con Claude, Cursor, VS Code y otros clientes MCP (ChatGPT una vez que esté disponible el inicio de sesión) a través del servidor remoto en https://qrx.codes/mcp.

Install in VS Code Install in Cursor Licence: MIT

Lo que puedes hacer

  • Crear un código: "Crea un código QR para https://example.com/menu que parezca una calle de cafés en acuarela."
  • Verificarlo: la generación suele tardar menos de un minuto; el agente espera y devuelve la imagen y el enlace corto.
  • Encontrar códigos antiguos: lista los códigos de tu cuenta, del más reciente al más antiguo.
  • Redirigir un código: envía un código impreso existente a un nuevo enlace, sin reimprimir (plan Starter).
  • Revisar tu asignación: consulta cuántos códigos te quedan hoy.

Detalles de conexión

URL del servidorhttps://qrx.codes/mcp
TransporteHTTP transmisible (sin estado)
Autenticación (ahora)Clave API en un encabezado: Authorization: Bearer qrx_… (preferido), o X-API-Key: qrx_… para clientes que no pueden añadir el prefijo Bearer . Si se envían ambos, Authorization gana
Autenticación (próximamente)Inicio de sesión OAuth con tu cuenta QRX; los clientes que admitan MCP OAuth solo necesitarán la URL
Sin autenticacióntools/list y list_styles funcionan; todas las demás herramientas te piden conectar una cuenta
Documentaciónqrx.codes/developers/mcp (pública: URL del servidor, configuración del cliente, herramientas, límites, privacidad)

Obtener una clave API

  1. Inicia sesión en qrx.codes (gratis).

  2. Abre qrx.codes/developers/keys y crea una clave. Comienza con qrx_.

  3. Mantenla en secreto. Los ejemplos a continuación la leen de una variable de entorno llamada QRX_API_KEY siempre que el cliente lo permita:

    # macOS / Linux
    export QRX_API_KEY="qrx_live_…"
    
    # Windows PowerShell (current user, persistent)
    [Environment]::SetEnvironmentVariable("QRX_API_KEY", "qrx_live_…", "User")
    

Revoca una clave en cualquier momento desde la misma página.

Instalación

Claude Code

Opción A: complemento (servidor MCP más la habilidad QRX)

/plugin marketplace add qrxcodes/qrx-mcp
/plugin install qrx@qrx

Cuando habilitas el complemento, Claude Code solicita tu clave API de QRX y la guarda en el almacén de credenciales de tu sistema. El complemento también añade la habilidad qrx, que enseña a Claude a escribir buenos prompts de arte, esperar el código y prepararlo para imprimir.

Opción B: solo servidor MCP

claude mcp add --transport http qrx https://qrx.codes/mcp \
  --header "Authorization: Bearer $QRX_API_KEY" --scope user

O confirma esto en el .mcp.json de un proyecto para que todo el equipo lo tenga (cada persona configura su propio QRX_API_KEY):

{
  "mcpServers": {
    "qrx": {
      "type": "http",
      "url": "https://qrx.codes/mcp",
      "headers": { "Authorization": "Bearer ${QRX_API_KEY}" }
    }
  }
}

Cuando OAuth esté disponible: claude mcp add --transport http qrx https://qrx.codes/mcp, luego ejecuta /mcp e inicia sesión.

Claude (claude.ai y Claude Desktop): conector personalizado

Claude Desktop usa la misma configuración de conector que claude.ai; no edites claude_desktop_config.json para un servidor remoto.

  1. Abre Personalizar → Conectores, selecciona + Añadir y luego Añadir conector personalizado. En Team y Enterprise, un propietario lo añade bajo Configuración de organización → Conectores primero.
  2. Nombre: QRX. URL: https://qrx.codes/mcp.
  3. Autenticación:
    • Ahora: elige la opción de credenciales fijas y, bajo Encabezados de solicitud, añade Authorization con el valor Bearer qrx_live_….
    • Cuando OAuth esté disponible: elige Iniciar sesión cuando sea necesario; Claude muestra un botón Conectar la primera vez que creas un código.
  4. Guarda y luego activa QRX en un chat desde el menú de conectores.

Los planes gratuitos de Claude pueden añadir un conector personalizado.

ChatGPT

Los servidores MCP personalizados de ChatGPT aceptan OAuth o sin autenticación, no claves API, por lo que QRX en ChatGPT necesita la versión con OAuth.

Cuando OAuth esté disponible:

  1. Abre chatgpt.com/plugins en la web, selecciona + y luego Añadir servidor MCP personalizado.
  2. Nombre: QRX. URL del servidor: https://qrx.codes/mcp.
  3. Autenticación: OAuth. Acepta la advertencia de riesgo y selecciona Crear como complemento.
  4. Solicita un código QR; ChatGPT te pedirá iniciar sesión en QRX la primera vez.

Los administradores del espacio de trabajo pueden restringir los servidores MCP personalizados en los planes Business y Enterprise.

Cursor

Usa el botón Instalar en Cursor de arriba, o añade esto a ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto):

{
  "mcpServers": {
    "qrx": {
      "url": "https://qrx.codes/mcp",
      "headers": { "Authorization": "Bearer ${env:QRX_API_KEY}" }
    }
  }
}

Cuando OAuth esté disponible: elimina el bloque headers; Cursor te pedirá iniciar sesión.

VS Code (GitHub Copilot)

Usa el botón Instalar en VS Code de arriba (solicita tu clave y la guarda de forma segura), o añade esto a .vscode/mcp.json:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "qrx-api-key",
      "description": "QRX API key (starts with qrx_)",
      "password": true
    }
  ],
  "servers": {
    "qrx": {
      "type": "http",
      "url": "https://qrx.codes/mcp",
      "headers": { "Authorization": "Bearer ${input:qrx-api-key}" }
    }
  }
}

Desde una terminal:

code --add-mcp '{"name":"qrx","type":"http","url":"https://qrx.codes/mcp","headers":{"Authorization":"Bearer ${input:qrx-api-key}"},"inputs":[{"type":"promptString","id":"qrx-api-key","description":"QRX API key","password":true}]}'

Cuando OAuth esté disponible: {"type": "http", "url": "https://qrx.codes/mcp"} es suficiente.

Windsurf / Devin Desktop

Edita mcp_config.json (macOS/Linux ~/.config/devin/mcp_config.json, Windows %APPDATA%\devin\mcp_config.json; instalaciones antiguas de Windsurf usan ~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "qrx": {
      "serverUrl": "https://qrx.codes/mcp",
      "headers": { "Authorization": "Bearer ${env:QRX_API_KEY}" }
    }
  }
}

Ten en cuenta que la clave es serverUrl, no url.

Cline

Abre Servidores MCP → Configurar servidores MCP y añade a cline_mcp_settings.json:

{
  "mcpServers": {
    "qrx": {
      "type": "streamableHttp",
      "url": "https://qrx.codes/mcp",
      "headers": { "Authorization": "Bearer qrx_live_…" },
      "disabled": false,
      "autoApprove": ["list_styles", "get_qr_code", "list_qr_codes", "get_account", "get_profile"]
    }
  }
}

Cuando OAuth esté disponible: elimina headers y usa Autorizar OAuth en el servidor.

Zed

Añade a settings.json:

{
  "context_servers": {
    "qrx": {
      "url": "https://qrx.codes/mcp",
      "headers": { "Authorization": "Bearer qrx_live_…" }
    }
  }
}

Cuando OAuth esté disponible: omite headers; Zed ejecuta el flujo de inicio de sesión MCP cuando no se establece el encabezado Authorization.

Goose

Ejecuta goose configure → Añadir extensión → Extensión remota (HTTP transmisible), ingresa https://qrx.codes/mcp y añade el encabezado Authorization: Bearer qrx_live_…. O edita config.yaml (macOS/Linux ~/.config/goose/config.yaml, Windows %APPDATA%\Block\goose\config\config.yaml):

extensions:
  qrx:
    name: qrx
    type: streamable_http
    enabled: true
    uri: https://qrx.codes/mcp
    headers:
      Authorization: "Bearer qrx_live_…"
    timeout: 300
OpenAI Codex CLI

Añade a ~/.codex/config.toml:

[mcp_servers.qrx]
url = "https://qrx.codes/mcp"
bearer_token_env_var = "QRX_API_KEY"

Cuando OAuth esté disponible: codex mcp add qrx --url https://qrx.codes/mcp, luego codex mcp login qrx.

Gemini CLI
gemini mcp add --transport http --header "Authorization: Bearer $QRX_API_KEY" qrx https://qrx.codes/mcp

O en ~/.gemini/settings.json (nota httpUrl, que selecciona HTTP transmisible):

{
  "mcpServers": {
    "qrx": {
      "httpUrl": "https://qrx.codes/mcp",
      "headers": { "Authorization": "Bearer $QRX_API_KEY" }
    }
  }
}
Habilidades de agente (cualquier agente compatible)

La carpeta skills/qrx sigue el estándar Habilidades de agente, por lo que la misma habilidad funciona en Codex, Gemini CLI, GitHub Copilot, Cursor, Goose y otros. Instálala con el instalador multiplataforma:

npx skills add qrxcodes/qrx-mcp

La habilidad espera que el servidor MCP de QRX esté conectado (consulta tu cliente arriba), o un QRX_API_KEY para la API REST.

Extensión Gemini CLI
gemini extensions install https://github.com/qrxcodes/qrx-mcp

La extensión solicita tu clave API de QRX y la guarda en el llavero de tu sistema.

Cualquier otro cliente MCP

Apunta un cliente HTTP transmisible a https://qrx.codes/mcp y envía Authorization: Bearer qrx_… (o X-API-Key: qrx_…). Los clientes que solo hablan stdio pueden usar un puente como mcp-remote:

{
  "mcpServers": {
    "qrx": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://qrx.codes/mcp", "--header", "Authorization:Bearer ${QRX_API_KEY}"],
      "env": { "QRX_API_KEY": "qrx_live_…" }
    }
  }
}

Herramientas

HerramientaQué haceSolo lecturaNecesita cuenta
generate_qr_codeInicia un nuevo código QR artístico desde un prompt y un enlace (o detalles de Wi-Fi en Starter). Devuelve el id del código de inmediato.NoSí
get_qr_codeObtiene el estado, la imagen y el enlace corto de un código. Espera hasta wait segundos (0 a 25, predeterminado 25) por un código que aún se está pintando.SíSí
list_qr_codesLista tus códigos, del más reciente al más antiguo, una página a la vez (limit 1 a 100, predeterminado 20; pasa nextCursor como cursor).SíSí
change_qr_code_destinationApunta un código de enlace existente a una nueva URL absoluta http o https (plan Starter). El código impreso sigue funcionando. Marcado como destructivo, porque reemplaza el destino anterior.NoSí
get_accountMuestra tu plan, cuántos códigos quedan hoy, cuándo se restablece el contador y qué puede hacer la cuenta.SíSí
get_profileMuestra qué cuenta QRX está conectada.SíSí
list_stylesLista los estilos que puedes pasar a generate_qr_code.SíNo

En clientes que muestran vistas interactivas (aplicaciones MCP), como Claude, el código también aparece en una tarjeta que se completa cuando está listo.

Ejemplos de prompts

  1. "Crea un código QR para https://example.com/menu que parezca una calle de cafés en acuarela."
  2. "Diseña un código QR para nuestra página RSVP de boda, https://example.com/rsvp, como hojas de eucalipto y lámina dorada sobre papel crema."
  3. "Necesito un código QR para un cartel de concierto que abra https://example.com/tickets. Ciudad synthwave neón de noche."
  4. "Muéstrame los estilos que tiene QRX, luego crea un código para https://example.com en el que mejor se adapte a una panadería."
  5. "Lista mis códigos QR de esta semana y dame los enlaces cortos."
  6. "El código del volante que imprimimos el mes pasado ahora debería abrir https://example.com/spring-sale en su lugar."
  7. "¿Cuántos códigos QR puedo crear todavía hoy?"
  8. "Crea tres variaciones de un código QR para https://example.com/shop con una ola japonesa de bloque de madera, y dime qué escaneos están verificados."

Cómo funciona la generación

  • generate_qr_code devuelve en unos segundos con un id y status: processing. La obra de arte suele tardar menos de un minuto en una GPU.
  • get_qr_code luego espera hasta 25 segundos por llamada (wait, 0–25). Los agentes lo llaman de nuevo hasta que el estado sea succeeded (o failed). En clientes de aplicaciones MCP, la tarjeta se completa con la imagen cuando está lista.
  • Un código terminado incluye la URL de la imagen, el enlace corto que codifica (shortUrl: https://qrx.to/<id> en qrx.codes) y el destino al que redirige. Cada código se decodifica antes de marcarse como succeeded. El id de un código y su enlace corto nunca cambian.
  • Cada código que inicias cuenta contra tu plan, incluso si no conservas el resultado.

Planes y límites

PlanCódigosRedirigir enlacesCódigos Wi-Fi
Gratis42 al díaNoNo
Starter, US$20 al mesSin límite diarioSíSí

La API, el servidor MCP y el sitio web comparten una sola asignación. Cada clave también tiene límite de velocidad (30 solicitudes por minuto y 6 códigos nuevos por cada 10 segundos). Si alcanzas un límite, la herramienta devuelve un error; get_account muestra lo que queda y cuándo se restablece el contador diario. Planes: https://qrx.codes/upgrade. Límites: qrx.codes/developers.

Qué contiene este repositorio

RutaPara
.claude-plugin/plugin.json, .claude-plugin/marketplace.json, .mcp.jsonComplemento de Claude Code y su mercado (/plugin marketplace add qrxcodes/qrx-mcp)
skills/qrx/La habilidad qrx (estándar de habilidades de agente): prompts, espera del código, verificaciones de impresión
gemini-extension.json, GEMINI.mdExtensión Gemini CLI
server.jsonLa entrada para el Registro MCP oficial
glama.jsonReclamación de mantenedor de Glama
llms-install.mdConfiguración paso a paso escrita para agentes de IA (Cline y otros)

Ninguno de estos archivos ejecuta código en tu máquina. Solo apuntan tu cliente a https://qrx.codes/mcp.

Datos y uso de red

Los clientes envían solicitudes solo a https://qrx.codes/mcp (y, cuando la habilidad recurre a la API REST, a https://qrx.codes/v1). Cada solicitud incluye tu clave de API, así como el mensaje, el enlace de destino y el estilo que hayas solicitado. El imageUrl de un código terminado está en https://qrx.codes/media/, que redirige a la CDN de imágenes de QRX.

Privacidad, términos y soporte

QRX almacena los mensajes, enlaces e imágenes que creas para que aparezcan en tu cuenta. No lee tu historial de chat; solo ve los argumentos que el cliente envía a sus herramientas.

Licencia

Los archivos de configuración, la habilidad y la documentación de este repositorio se publican bajo la licencia MIT. El servicio QRX en sí es un producto alojado, regido por los términos de QRX.