Claude Code e códigos QR: configurar o Same-QR por MCP, passo a passo
O que é o Claude Code
O Claude Code é um agente de programação da Anthropic. Corre no terminal ou no ambiente de desenvolvimento, lê e edita ficheiros e executa comandos. Através do MCP, o Model Context Protocol, usa ainda ferramentas de outros serviços. Ligado ao Same-QR, consegue editar códigos QR, páginas para estabelecimentos, ementas, etiquetas e projetos de clientes na tua conta.
Passo 1: criar a chave de API
No painel do Same-QR, abre Conta e a secção “Acesso para CLI, scripts e agentes”. Cria uma chave. Se o Claude Code só deve analisar, escolhe “só leitura”, e o agente nem sequer vê as ferramentas de escrita. Para criar, escolhe “leitura + escrita”; se também deve alterar os destinos de códigos QR existentes, escolhe “total”. A chave começa por sqr_live_ e só é mostrada uma vez.
Passo 2: definir a chave como variável de ambiente
Guarda a chave no teu gestor de palavras-passe e disponibiliza-a como variável de ambiente SAMEQR_API_KEY, por exemplo ao iniciar a shell. Nos ficheiros do projeto, não tem lugar.
Passo 3: adicionar o servidor MCP
Basta um comando no terminal:
claude mcp add --transport http sameqr https://sameqr.com/api/mcp --header "Authorization: Bearer $SAMEQR_API_KEY"Quem instalou a linha de comandos sameqr também vê esta linha com “sameqr mcp”.
Passo 4: testar a ligação
Inicia o Claude Code e pergunta primeiro algo que não altere nada: “Que plano tenho no Same-QR e que códigos QR existem?” O servidor recomenda ao agente que comece por esta consulta à conta, para que conheça os limites do teu plano.
Passo 5: códigos QR para uma página de campanha
Uma tarefa típica quando surge uma nova landing page no projeto:
“Cria no Same-QR três códigos QR dinâmicos para a nova página /outono: cartaz, folheto e expositor de mesa. Acrescenta ao destino de cada um utm_source=qr e utm_medium com o respetivo suporte, dá a todos a etiqueta Campanha de outono e mostra-me primeiro a lista.”
Depois da tua confirmação, o Claude Code cria os códigos QR. Como cada material publicitário tem o seu próprio código QR, mais tarde vês no Same-QR e na análise web qual dos suportes foi usado e quantas vezes. Os ficheiros de impressão em SVG ou PDF descarregas no painel.
Permissões e controlo
- Antes de alterar códigos QR já impressos, pede sempre primeiro uma lista.
- Alterar destinos e apagar exigem uma confirmação com o estado lido, no máximo 10 por hora. Confirma apenas de forma consciente.
- Se a tarefa se deve tornar um fluxo repetível, pede ao Claude Code que escreva um script com a CLI sameqr.
- Revoga a chave quando o projeto terminar.
Conclusão: porquê o Same-QR
O Same-QR encaixa no Claude Code como uma ferramenta integrada: um comando para configurar, todas as funções do painel como ferramentas MCP, chaves de leitura que escondem as ferramentas de escrita e uma documentação que um agente compreende. Em todos os planos, também no gratuito.
Começa já: regista-te gratuitamente em sameqr.com, 20 códigos QR dinâmicos são grátis para sempre. API, CLI e servidor MCP existem em todos os planos, a documentação está em sameqr.com/entwickler.
Perguntas frequentes
Sim, como variável de ambiente SAMEQR_API_KEY, para a qual a entrada aponta. A chave em si não fica na configuração.
Sim. Consegue ler, alterar e publicar páginas de estabelecimentos e importar ementas a partir de fotografias. Os preços e os alergénios verificas tu antes de publicar.
O MCP é mais cómodo para tarefas em conversa. A CLI é melhor quando disso deve resultar um script que corra também sem agente.
Novos artigos diretamente na tua caixa de correio
Dicas sobre códigos QR dinâmicos, novidades, sem spam. Podes cancelar a qualquer momento.
Ao subscreveres, aceitas receber a newsletter. Podes retirar o consentimento a qualquer momento através da ligação de cancelamento incluída em cada e-mail.