QrVerloz MCP Server

Gere códigos QR instantaneamente sem conta — ativos por 90 dias, reivindicáveis para sempre, com redirecionamento de destino e análise de escaneamentos.

GitHub
3
Experimente este MCPPatrocinado

Documentação

Servidor MCP QrVerloz

Códigos QR dinâmicos — crie, redirecione e inspecione a partir de qualquer assistente de IA.
Nenhuma conta necessária para começar.

MCP Compatible License: MIT

O que é o QrVerloz?

O QrVerloz é um serviço de código QR dinâmico. Diferente dos códigos QR estáticos, os códigos QrVerloz são redirecionáveis — você imprime uma vez e altera o destino a qualquer momento sem reimprimir. Acompanhe cada leitura com análises em tempo real, agende trocas automáticas de URL e gerencie tudo pelo seu assistente de IA via MCP.

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

Não é necessário se cadastrar. Solicite uma chave de API uma única vez e comece a criar códigos imediatamente.

Início rápido (30 segundos)

1 — Adicione o servidor ao seu cliente de IA

Consulte mcp-config-examples/ para configurações prontas para copiar:

ClienteArquivo de configuração
Claude Desktop (macOS / Linux)claude-desktop.json
Claude Desktop (Windows)claude-desktop-windows.json
Claude Codeclaude-code.json
Cursorcursor.json
VS Code com GitHub Copilotvscode-copilot.json
Continuecontinue.json
Qualquer outro cliente HTTP MCPgeneric.md

Claude Desktop no Windows: use claude-desktop-windows.json. O comando padrão npx falha no Windows quando o Node.js está instalado em C:\Program Files devido a um problema de caminho com espaços. A configuração do Windows usa cmd /c para contornar isso.

VS Code: requer VS Code 1.96 ou posterior com a extensão GitHub Copilot. Coloque a configuração em .vscode/mcp.json na raiz do seu workspace.

2 — Obtenha um token de API gratuito

Nenhum e-mail ou senha necessários. No seu assistente de IA, diga:

Use the QrVerloz MCP tool to request an API key

O token é exibido apenas uma vez — salve-o imediatamente.

Observação: há um limite de uma solicitação de token por IP a cada 24 horas para evitar abuso. Se a chamada falhar, aguarde 24 horas ou cadastre-se em qrverloz.com para uma conta permanente.

⚠️ Vida útil do código QR: códigos QR de convidado são excluídos permanentemente ~180 dias após a emissão do token (token de 90 dias + período de carência de 90 dias). Reivindique sua conta em qrverloz.com/claim antes que o token expire para manter seus códigos permanentemente.

3 — Adicione o token à configuração do seu cliente

Substitua YOUR_API_KEY no arquivo de configuração pelo seu token e reinicie o cliente de IA:

Authorization: Bearer qrv_...

4 — Crie seu primeiro código QR

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

Seu código QR está ativo em https://qrverloz.com/r/{shortCode}. Imprima-o — você pode alterar o destino a qualquer momento.

Referência de ferramentas

FerramentaAutenticaçãoDescrição
request_api_keyNenhumaObtenha um token de API gratuito de 90 dias. Sem cadastro.
create_qr_codeOpcional*Crie um código QR dinâmico apontando para uma URL.
get_qr_codeNecessáriaConsulte um código QR por ID ou código curto.
list_qr_codesNecessáriaListe todos os seus códigos QR com URLs curtas e destinos.
get_qr_scansNecessáriaObtenha o total de leituras ao longo da vida de um código QR.
update_qr_targetNecessáriaAltere para onde um código QR redireciona — sem necessidade de reimpressão.
delete_qr_codeNecessáriaExclua permanentemente um código QR e seu histórico de leituras.
get_account_infoNecessáriaVerifique seu plano, uso e capacidade restante de códigos QR.

*O create_qr_code anônimo retorna uma URL de imagem CDN efêmera (não armazenada, não redirecionável). Usuários autenticados obtêm uma URL curta permanente. Todas as respostas de ferramentas autenticadas são retornadas como tabelas markdown pré-formatadas — exiba-as exatamente como recebidas.

request_api_key

Sem parâmetros. Retorna um token de 90 dias. Contas gratuitas obtêm até 5 códigos QR.

⚠️ Aviso importante de vida útil: o token expira após 90 dias. Os códigos QR são excluídos permanentemente aproximadamente 90 dias após a expiração do token (~180 dias no total desde a criação). Para manter seus códigos QR vivos permanentemente, visite qrverloz.com/claim antes que o token expire para vincular um endereço de e-mail.

Exemplo de prompt:

Use the QrVerloz MCP tool to request an API key

create_qr_code

ParâmetroTipoObrigatórioDescrição
titlestringSimRótulo legível por humanos (1–200 caracteres)
target_urlstring (URL)SimURL de destino — deve começar com https:// ou http://

Quando você pede ao seu assistente de IA para criar um código QR, ele retorna uma tabela formatada assim:

Exemplo de saída (autenticado):

CampoValor
TítuloSummer Sale
IDclxyz1234abcdef567890
Código curtoab3k9x
URL curtahttps://qrverloz.com/r/ab3k9x
Destinohttps://example.com/sale
StatusAtivo
Criado em11 de abril de 2026
Link do código QRBaixar imagem do QR

Exemplo de saída (token de convidado):

Uma linha Token expira em é adicionada como lembrete para reivindicar a conta antes que o token expire.

Exemplos 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

Precisa de códigos QR para WiFi, vCard, SMS, telefone ou WhatsApp? Eles estão disponíveis no painel QrVerloz — apenas não pelo servidor MCP. Cadastre-se para uma conta gratuita para acessá-los.

get_qr_code

ParâmetroTipoObrigatórioDescrição
qr_code_idstringUm deUUID interno de create_qr_code ou list_qr_codes
short_codestringUm deCódigo curto da URL de redirecionamento (ex.: abc123)

Seu assistente de IA retorna uma tabela formatada assim:

Exemplo de saída:

CampoValor
TítuloSummer Sale
IDclxyz1234abcdef567890
Código curtoab3k9x
URL curtahttps://qrverloz.com/r/ab3k9x
Destinohttps://example.com/sale
StatusAtivo
Criado em11 de abril de 2026
Link do código QRBaixar imagem do QR

Usuários convidados: uma linha Token expira em aparece após o Link do código QR mostrando quando o token (e os códigos) serão excluídos.

Exemplo de prompt:

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

list_qr_codes

ParâmetroTipoObrigatórioDescrição
pageinteiroNãoNúmero da página (padrão: 1)
limitinteiroNãoItens por página, máx. 20 (padrão: 20)

Seu assistente de IA retorna uma linha de resumo seguida por uma tabela formatada para cada código QR:

Exemplo de saída:

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

CampoValor
TítuloSummer Sale
IDclxyz1234abcdef567890
Código curtoab3k9x
URL curtahttps://qrverloz.com/r/ab3k9x
Destinohttps://example.com/sale
StatusAtivo
Criado em11 de abril de 2026
Link do código QRBaixar imagem do QR
CampoValor
TítuloConference Badge
IDclxyz9876zyxwvu54321
Código curtotz7m2p
URL curtahttps://qrverloz.com/r/tz7m2p
Destinohttps://example.com/conference
StatusAtivo
Criado em13 de abril de 2026
Link do código QRBaixar imagem do QR

Usuários convidados: cada cartão inclui uma linha Token expira em após o Link do código QR.

Exemplo de prompt:

Use the QrVerloz MCP tool to list all my QR codes

get_qr_scans

ParâmetroTipoObrigatórioDescrição
qr_code_idstringSimUUID interno do código QR

Seu assistente de IA retorna a mesma tabela que get_qr_code com uma linha adicional Total de leituras no final. Usuários convidados também veem uma linha Token expira em (entre o Link do código QR e o Total de leituras).

Exemplo de saída:

CampoValor
TítuloSummer Sale
IDclxyz1234abcdef567890
Código curtoab3k9x
URL curtahttps://qrverloz.com/r/ab3k9x
Destinohttps://example.com/sale
StatusAtivo
Criado em11 de abril de 2026
Link do código QRBaixar imagem do QR
Total de leituras147

Exemplo de prompt:

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

update_qr_target

ParâmetroTipoObrigatórioDescrição
qr_code_idstringUm deUUID interno
short_codestringUm deCódigo curto da URL de redirecionamento
target_urlstring (URL)SimNova URL de destino — deve começar com https:// ou http://

Observação: apenas códigos QR do tipo URL podem ser atualizados via MCP. Para códigos QR de WiFi, vCard, SMS, telefone, WhatsApp, PDF e áudio, gerencie-os pelo painel QrVerloz.

Exemplo de prompt:

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

delete_qr_code

ParâmetroTipoObrigatórioDescrição
qr_code_idstringUm deUUID interno
short_codestringUm deCódigo curto da URL de redirecionamento
confirm_titlestringSimTítulo exato do código QR — deve corresponder caractere por caractere para evitar exclusões acidentais

Exemplo de prompt:

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

get_account_info

Sem parâmetros. Retorna seu plano atual, flags de recursos, uso de códigos QR e capacidade restante. Útil para agentes de IA verificarem antes de tentar criar códigos.

Exemplo de prompt:

Use the QrVerloz MCP tool to show my account info

Autenticação

ModoCabeçalhoLimites
Anônimo(nenhum)Até 30 imagens efêmeras/dia — não armazenadas, não redirecionáveis
Token BearerAuthorization: Bearer qrv_...Até 5 códigos armazenados (plano Gratuito) · 60 req/min em todas as ferramentas

Obtenha um token instantaneamente — nenhum e-mail necessário.
Para reivindicar uma conta permanente: qrverloz.com/claim

API REST

Uma API REST completa também está disponível para integrações HTTP diretas.

Exemplos

Scripts prontos para execução estão em:

Solução de problemas

O assistente de IA não reconhece o nome da ferramenta

Não digite nomes de ferramentas como chamadas de função (ex.: request_api_key()). Use linguagem natural:

"Use a ferramenta MCP do QrVerloz para solicitar uma chave de API"

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

Este é um erro de caminho com espaços no Windows. O Node.js instalado em C:\Program Files faz cmd.exe falhar quando o caminho não está entre aspas.

Correção: use claude-desktop-windows.json que usa cmd /c para evitar o problema.

O servidor MCP não está conectando

Claude Desktop:

  1. Verifique o ícone de martelo (🔨) na barra de entrada do chat — ele lista os servidores conectados. Se o QrVerloz estiver ausente, o servidor falhou ao conectar.
  2. Abra os logs via Help → Open Logs Folder e procure por erros do servidor qrveloz.
  3. Certifique-se de que o Node.js 18+ está instalado (node --version) e npx está disponível (npx --version).
  4. Teste a conexão manualmente: npx -y mcp-remote https://qrverloz.com/api/mcp

VS Code com GitHub Copilot:

  1. Abra a Paleta de Comandos (Ctrl+Shift+P) e execute MCP: List Servers — o QrVerloz deve aparecer com status running.
  2. Se mostrar um erro, verifique se o VS Code é 1.96+ e a extensão do Copilot está ativa.
  3. Certifique-se de que .vscode/mcp.json está salvo e o workspace está aberto.

Cursor / Continue / outros clientes HTTP:

  1. Verifique se a URL é exatamente https://qrverloz.com/api/mcp — sem barra final.
  2. Confirme que o valor do cabeçalho Authorization começa com Bearer (observe o espaço).
  3. Teste o endpoint diretamente: 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"}}}'

O token foi exibido, mas não o salvei

Tokens de convidado não podem ser recuperados depois que a resposta é descartada. Opções:

  • Aguarde 24 horas e chame request_api_key novamente do mesmo IP
  • Cadastre-se em qrverloz.com para uma conta permanente com gerenciamento de token no painel de Configurações

Limite de taxa atingido em request_api_key

Um token de convidado é emitido por IP a cada 24 horas para evitar abuso. Se você atingir o limite, aguarde 24 horas ou crie uma conta gratuita em qrverloz.com.

Preços

Consulte qrverloz.com/#pricing para detalhes e limites atuais do plano.

Licença

MIT — consulte LICENSE.