QRtracer MCP

Crie QR codes dinâmicos, atualize links de destino e leia análises de escaneamento a partir de fluxos de trabalho de IA. Endpoint remoto com seis ferramentas para criação, renderização, roteamento e análise de QR codes.

Servidor MCP hospedado

npx add-mcp 'https://qrtracer.io/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Crie, acompanhe e gerencie seu primeiro código QR

Comece no navegador e depois migre para a API ou MCP quando precisar de automação. Este guia cobre o caminho completo, desde a URL de destino até um código testado e pronto para impressão.

Códigos dinâmicos ilimitados

Durante seus primeiros 30 dias

Acesso de 30 dias

Teste de Analytics e QR Studio

Redirecionamentos permanecem ativos

Códigos impressos continuam funcionando

01 · Criar

Escolha entre estático ou dinâmico antes de imprimir

Insira o destino final no gerador. O QRtracer cria uma prévia primeiro e depois permite baixar um código estático ou continuar com o rastreamento.

Código QR estático

Codifica o próprio destino. Não exige conta e pode ser baixado imediatamente, mas seu destino não pode ser alterado e ele não coleta análises de escaneamento.

Código QR dinâmico

Codifica um redirecionamento do QRtracer, como /r/{id}. O padrão impresso permanece o mesmo enquanto você edita o destino e inspeciona os escaneamentos registrados.

  1. 1 Adicione um destino Use a URL completa da página, formulário, menu, perfil ou campanha que você quer que as pessoas abram.
  2. 2 Escolha o rastreamento Continue com um código dinâmico quando precisar de histórico de escaneamento ou edições futuras de destino.
  3. 3 Teste antes de imprimir Escaneie o arquivo baixado em mais de um celular e confirme se a página final carrega.

02 · Acompanhar

Saiba o que o plano gratuito mantém e o que ele desbloqueia

Novas contas podem criar códigos dinâmicos ilimitados e usar Analytics e QR Studio por 30 dias. Quando o teste terminar, criar novos códigos dinâmicos e usar essas áreas premium exigirá um plano pago. Os redirecionamentos existentes e o registro de escaneamentos continuam.

Seu redirecionamento impresso é separado do acesso ao painel

Chegar ao fim do acesso gratuito ao Analytics não desativa o redirecionamento QR impresso. Revise os limites atuais de recursos na página de preços antes de uma campanha.

Escaneamentos

Veja os totais de escaneamentos humanos dos códigos que você possui enquanto o acesso ao Analytics estiver ativo.

Contexto

Use os detalhamentos por data, cidade, dispositivo e navegador no painel do Analytics.

Histórico

O teste inclui 30 dias de acesso ao Analytics; planos pagos oferecem histórico completo.

03 · Gerenciar

Edite destinos e mantenha os arquivos de impressão organizados

Abra QR Codes para nomear um código, revisar seu destino, baixá-lo ou atualizar para onde ele aponta. Abra Analytics para comparar a atividade das campanhas.

Editar um destino

Selecione um código dinâmico de sua propriedade e substitua seu destino. O padrão QR impresso não muda.

Baixe o formato certo

PNG funciona para usos digitais e de impressão comuns. SVG é uma exportação paga para artes escaláveis e exige a conta proprietária.

Revise as análises

Filtre seu painel por data e código. A exportação em CSV está disponível quando seu plano a inclui.

04 · Campanha

Trate o código QR como parte de toda a jornada

Um escaneamento só é útil quando o texto impresso, a posição do código e a página de destino apoiam o mesmo objetivo. Defina essas peças antes da distribuição para que as análises respondam a uma pergunta clara.

  • Nomeie o código pela sua posição, como “cartaz da janela de setembro”, para que os relatórios fiquem compreensíveis.
  • Use um código dinâmico por posição quando precisar comparar cartazes, cardápios, embalagens ou placas de eventos.
  • Mantenha forte contraste e espaço livre ao redor do código e teste a prova física final na distância esperada.
  • Envie os escaneadores para uma página móvel focada e adicione parâmetros de campanha quando sua pilha de análises os usar.
  • Verifique o destino novamente antes de uma tiragem; atualize um código dinâmico depois se a página da campanha mudar.

05 · Automatizar

Crie um código rastreado com a API

O endpoint público de criação aceita um destino e um rótulo opcional. Solicitações anônimas retornam um link de reivindicação; mostre esse link à pessoa que deve ser dona do código. As chaves de API estão disponíveis no plano Programmable.

Criação anônima

curl -X POST https://qrtracer.io/api/v1/qr-codes \
  -H 'content-type: application/json' \
  -d '{"destination":"https://example.com/menu","label":"Front window"}'

Campos da resposta

{
  "id": "…",
  "redirect_url": "https://qrtracer.io/r/…",
  "png_url": "https://qrtracer.io/api/render/….png",
  "svg_url": "https://qrtracer.io/api/render/….svg",
  "claim_url": "https://qrtracer.io/claim/…",
  "expires_edit_at": "…"
}

A criação anônima é limitada a cinco solicitações e cinco destinos distintos por cliente em 24 horas. O link de reivindicação transfere o código para uma conta; o redirecionamento em si já está ativo.

Criar com uma chave de API

curl -X POST https://qrtracer.io/api/v1/qr-codes \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer qrt_live_…' \
  -d '{"destination":"https://example.com/menu","label":"Front window"}'

Baixar um PNG rastreado

curl -L 'https://qrtracer.io/api/render/{id}.png?size=1024' -o qr-code.png

06 · MCP

Deixe uma ferramenta de IA criar e gerenciar códigos

O QRtracer expõe um endpoint MCP em /mcp. Adicione esta configuração de servidor a um cliente compatível com MCP e inspecione as ferramentas disponíveis antes de chamá-las.

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

A ferramenta create_qr retorna o mesmo link de reivindicação que a API. Mantenha esse link no resultado visível ao usuário para que a pessoa possa assumir a propriedade. Os recursos de descoberta estão disponíveis em /.well-known/mcp.json e /llms.txt.

Pronto para criar o primeiro código?

Comece com um destino real, teste a jornada completa de escaneamento e mantenha o nome da campanha específico o suficiente para reconhecê-lo depois.

Abrir o gerador