QRX: códigos QR artísticos que sempre escaneiam

QRX transforma uma descrição curta de imagem (o prompt) e um link de destino em um código QR artístico. Cada código é verificado para decodificar antes de ser retornado, e ele codifica um link curto hospedado, https://qrx.to/<id> em qrx.codes, que redireciona os escaneamentos para o destino. Trate o resultado como um ativo de design: um PNG que o usuário pode inserir em layouts impressos ou digitais.

Quando Usar

Use quando o usuário quiser um código QR que também seja uma imagem: alinhado à marca, decorativo ou chamativo o suficiente para garantir um escaneamento. Pedidos típicos: um código de menu de cafeteria em estilo aquarela, um código de crachá de conferência nas cores do evento, um código de pôster que se mistura à arte, um código de embalagem de produto, um código de convite de casamento.

Não use quando:

• um código QR simples e sem estilo for suficiente e puder ser feito localmente (ofereça QRX apenas se o usuário quiser algo projetado);
• o usuário quiser alterar a arte de um código existente (crie um novo código em vez disso);
• a solicitação for para um logotipo, marca registrada ou personagem que o usuário não possui (veja "O que não fazer").

Ferramentas (servidor QRX MCP)

O servidor precisa que o usuário faça login no QRX (ou uma chave de API) antes de se conectar. Se as ferramentas estiverem faltando, ele não está conectado: peça ao usuário para fazer login nas configurações do MCP ou conector do cliente, ou use a API REST em vez disso (veja references/rest-api.md).

Como criar um código

1. Obtenha o destino. Deve ser uma URL absoluta começando com https:// ou http:// (adicione https:// se o usuário forneceu um domínio simples e confirme o link exato se for ambíguo). As ferramentas MCP criam apenas códigos de link; para um código Wi-Fi, envie o usuário para https://qrx.codes e nunca peça a senha de Wi-Fi.
2. Escreva o prompt (veja "Escrevendo um bom prompt"). Se o usuário nomeou um visual, chame list_styles e escolha o ID de estilo mais próximo; caso contrário, deixe style de fora.
3. Chame generate_qr_code uma vez. Guarde o id retornado; ele nunca muda. A pintura geralmente leva menos de um minuto.
4. Consulte com get_qr_code usando esse id até que status seja succeeded ou failed. Cada chamada espera até 25 segundos, então duas ou três chamadas são normais.
   • Nunca chame generate_qr_code novamente enquanto um código ainda estiver processando: cada geração conta contra a cota do usuário.
5. Mostre o resultado: a imagem (imageUrl, um PNG), o link curto que o código codifica (shortUrl, https://qrx.to/<id> em qrx.codes), o destino e a página do código (pageUrl). Diga ao usuário para testar o escaneamento com um telefone antes de imprimir.
6. Em failed: leia error.message, simplifique o prompt (menos elementos, mais contraste) e ofereça uma nova tentativa. Pergunte antes de fazer mais de uma tentativa extra.

Para várias variações, diga quantas serão feitas e que cada uma conta contra a cota, depois inicie-as e consulte cada id.

Escrevendo um bom prompt

O prompt descreve apenas a imagem. QRX cuida do padrão do código QR em si.

• Comece com um assunto e cenário claros: "um farol em um penhasco ao pôr do sol", "uma tigela de ramen com vapor subindo", "um galho de eucalipto com frutos".
• Adicione um estilo ou meio: aquarela, gravura em linóleo, 3D isométrico, pôster art déco, xilogravura japonesa, papercraft, arte de linha neon.
• Nomeie a paleta, especialmente as cores da marca: "em azul marinho profundo, coral e creme"; descreva as cores em palavras, pois os códigos hexadecimais não são seguidos de forma confiável.

…