Codex e Same-QR: configurar o MCP e delegar tarefas de códigos QR a um agente de programação
O que é o Codex
O Codex é um agente de programação da OpenAI. Trabalha num projeto, lê e escreve ficheiros, executa comandos e resolve tarefas que descreves em linguagem normal. Automatizar com o Codex não significa abdicar do controlo, mas delegar o trabalho de rotina e verificar o resultado.
Passo 1: criar a chave
No painel do Same-QR, em Conta, “Acesso para CLI, scripts e agentes”, cria uma chave. Disponibiliza-a como variável de ambiente SAMEQR_API_KEY.
Passo 2: entrada no config.toml
Acrescenta esta secção a ~/.codex/config.toml:
[mcp_servers.sameqr]
url = "https://sameqr.com/api/mcp"
bearer_token_env_var = "SAMEQR_API_KEY"O Codex lê a chave da variável de ambiente, no ficheiro está apenas o respetivo nome. Também aqui o comando “sameqr mcp” mostra a entrada certa.
Passo 3: testar
Pede ao Codex uma tarefa de leitura: “Mostra-me o meu plano do Same-QR e todos os códigos QR com o respetivo destino.” Só depois vêm as tarefas de escrita.
Tarefas adequadas
- A partir de uma lista de locais, criar um código QR para cada um e organizá-los com etiquetas.
- Depois de uma alteração na estrutura do site, verificar que códigos QR apontam para endereços antigos.
- Escrever um script que, uma vez por mês, guarda os números de scans com “sameqr qr list --json”.
- Para um novo cliente de restauração, importar a ementa a partir de uma fotografia e criá-la como rascunho.
As decisões com responsabilidade ficam contigo: preços numa ementa, alergénios, apagar códigos QR.
Verificar os resultados
- Ver no painel a lista dos códigos QR criados ou alterados.
- Ler alguns códigos QR por amostragem com o telemóvel.
- Ler as ementas importadas linha a linha antes de serem publicadas.
- Ler os scripts que o Codex escreveu antes de correrem com regularidade.
Conclusão: porquê o Same-QR
Com o Same-QR, o Codex ganha uma ferramenta completa para códigos QR e páginas de estabelecimentos: três linhas de configuração, as mesmas funções do painel e limites claros que travam um agente num ciclo. Em todos os planos e com uma documentação que também um agente consegue ler.
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
Apagar e alterar destinos só é possível com uma chave “total” e uma confirmação com o estado lido anteriormente. Com “só leitura” ou “leitura + escrita” não é de todo possível.
Sim. O Codex liga-se com uma chave do painel, que disponibilizas como variável de ambiente SAMEQR_API_KEY.
Tudo o que implique responsabilidade perante clientes ou convidados: preços, alergénios, apagar definitivamente códigos QR.
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.