Same-QR para programadores: API, servidor MCP e CLI num só olhar

Três acessos, uma conta

Same-QR para programadores significa isto: tudo o que o painel faz também existe como API REST, como servidor MCP para assistentes de IA e como linha de comandos. Os três chamam as mesmas funções, com os mesmos limites de plano e as mesmas verificações, e os três estão incluídos em todos os planos.

O acesso

As chaves crias no painel, em Conta, “Acesso para CLI, scripts e agentes“: “só leitura“, “leitura + escrita“ (criar, alterar nomes e textos) ou “total“ (além disso, alterar destinos, pôr offline, eliminar), com validade de 30, 90, 180 ou 365 dias ou, de propósito, sem limite, até 10 por conta. A chave começa por sqr_live_, é mostrada uma única vez e deve ficar na variável de ambiente SAMEQR_API_KEY.

A API REST

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/konto
curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr

Códigos QR, estatísticas, páginas de convidados, ementas a partir de fotos, etiquetas, projetos de clientes e pedidos. Os erros chegam sempre da mesma forma, como um objeto error com status, code e message. A descrição completa está em /api/v1/openapi.json. Limites: 120 pedidos por minuto por chave e, por hora, 60, 300, 1.000 ou 5.000, consoante o plano.

O servidor MCP

Endereço https://sameqr.com/api/mcp. O ChatGPT e o Claude.ai adicionam-no como conector e iniciam sessão por OAuth. Para o Claude Code:

claude mcp add --transport http sameqr https://sameqr.com/api/mcp --header "Authorization: Bearer $SAMEQR_API_KEY"

Para o Cursor e o Codex, “sameqr mcp“ mostra as entradas para ~/.cursor/mcp.json e ~/.codex/config.toml. Com uma chave de leitura, um agente só vê as ferramentas de leitura.

A CLI

npm install -g sameqr
sameqr login
sameqr qr create --name "Speisekarte" --url https://example.com/karte
sameqr seite create --vorlage speisekarte --name "Gasthof zum Löwen"
sameqr karte import karte.jpg --seite menu/gasthof-zum-loewen
sameqr seite publish menu/gasthof-zum-loewen

Sem dependências, a partir do Node.js 18, com --json para scripts e valores de retorno inequívocos para erros. “sameqr --help“ mostra todos os comandos.

Por onde começar

• Regista-te gratuitamente e confirma o endereço de e-mail.
• Cria uma chave “só leitura“ e experimenta “sameqr whoami“.
• Lê os guias em sameqr.com/entwickler.
• Depois escolhe o caminho que melhor se adapta ao teu projeto.

Conclusão: porquê o Same-QR

O Same-QR põe nas mãos dos programadores o serviço inteiro, e não só uma parte: API, servidor MCP e CLI com as mesmas funções do painel, um tratamento cuidadoso das chaves e limites documentados abertamente. 20 códigos QR dinâmicos são gratuitos para sempre, o que chega para experimentar.

Começa já: regista-te gratuitamente em sameqr.com, 20 códigos QR dinâmicos são gratuitos para sempre. API, CLI e servidor MCP existem em todos os planos, a documentação está em sameqr.com/entwickler.

Perguntas frequentes