Servidor MCP

El servidor MCP de qr3.app proporciona las herramientas actuales de QR y DPP para Claude, Cursor y otros clientes compatibles con MCP. El servidor se ejecuta a través de HTTP con autenticación Bearer.

Conexión segura

Endpoint: https://mcp.qr3.app/mcp

El servidor remoto actual utiliza autenticación HTTP Bearer:

Authorization: Bearer <API_KEY>

Usa únicamente un cliente MCP que pueda enviar una cabecera HTTP Authorization personalizada desde su almacén seguro de credenciales. Nunca incluyas una clave API en un archivo de configuración del proyecto ni en un repositorio.

Los conectores remotos de Claude usan OAuth. Actualmente qr3 solo ofrece autenticación mediante clave Bearer, por lo que no es compatible directamente con ese flujo de conector hasta que se añada soporte para OAuth.

Descubrimiento sin clave API

Un cliente no tiene que solicitar primero credenciales para averiguar qué ofrece este servidor. Los siguientes métodos son respondidos por https://mcp.qr3.app/mcp sin el encabezado Authorization:

Método	Devuelve
`initialize`	Versión del protocolo, capacidades, nombre del servidor
`tools/list`	todas las herramientas junto con su esquema de entrada
`resources/list`	el catálogo de recursos estáticos
`resources/read`	el contenido de un recurso individual
`prompts/list`	la lista de prompts
`ping`	disponibilidad

Cualquier método que afecte a un espacio de trabajo se ejecuta a través de tools/call, y este sigue requiriendo la clave Bearer. Sin ella, el servidor responde con HTTP 401, application/problem+json y WWW-Authenticate: Bearer realm="qr3.app".

curl -s https://mcp.qr3.app/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"resources/list","params":{}}'

Para los clientes que no admiten MCP, el mismo catálogo está disponible como JSON simple en https://mcp.qr3.app/resources, y un recurso individual en https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Herramientas disponibles

Herramientas principales

Herramienta	Descripción
`create_qr`	Crear un código QR para una URL
`update_qr`	Cambiar la URL de destino, el estado, las etiquetas, las notas o la expiración de un código QR
`list_qrs`	Listar códigos QR con filtro de estado y paginación por cursor
`get_qr_stats`	Obtener estadísticas de escaneo agregadas para un código QR
`create_batch`	Crear códigos QR a partir de una lista de URL (máx. 50)
`create_dpp_qr`	Crear un código QR DPP para una batería, un textil o un producto general
`create_vcard_qr`	Crear un código QR vCard estático
`create_wifi_qr`	Crear un código QR WiFi estático
`validate_dpp`	Validar datos DPP sin crearlos
`get_image`	Obtener una URL de recurso PNG, SVG, PDF o EPS proporcionada por la API
`shorten_url`	Crear un código QR de URL dinámico y devolver su URL corta

Recursos DPP

El servidor también proporciona recursos estáticos para el contrato DPP:

URI	Contenido
`qr3://qr-types`	Los seis tipos de Codes API: URL, vCard, WiFi, correo electrónico, SMS y ubicación
`qr3://error-codes`	Tipos de error e indicaciones de resolución
`qr3://rate-limits`	Rate-limits basados en el plan
`qr3://quickstart`	Guía de inicio rápido
`qr3://dpp-schema`	Contrato DPP centrado en baterías
`qr3://gs1-test-vectors`	Ejemplos de resolver GS1
`qr3://dpp-content-negotiation-examples`	Ejemplos de respuesta del resolver

Prompts de ejemplo

Erstelle einen QR-Code für https://example.com

Zeige mir die Scan-Statistiken für qr_abc123

Erstelle einen Batterie-DPP mit GTIN 04012345678901 und den Pflichtfeldern