Servidor MCP para códigos QR: usar o Same-QR no Claude, ChatGPT, Cursor e Codex

O que é um servidor MCP

MCP significa Model Context Protocol, um padrão aberto para a ligação entre assistentes de IA e outros serviços. Um servidor MCP descreve as ferramentas de um serviço, por exemplo «criar código QR» ou «ler estatísticas». O assistente vê essas ferramentas e chama-as quando uma tarefa as exige.

O que o servidor MCP do Same-QR disponibiliza

O servidor está em https://sameqr.com/api/mcp e oferece exatamente as ferramentas da API REST, com os mesmos nomes, verificações e limites de plano:

• Consultar a conta e o plano, para que o assistente saiba o que é possível.
• Listar, ler, criar, alterar e apagar códigos QR e consultar as suas estatísticas.
• Criar, ler, alterar, publicar, pôr offline e apagar páginas de convidados, além da lista de designs.
• Importar ementas e listas de preços a partir de fotos ou PDF.
• Gerir etiquetas e projetos de clientes e ler pedidos de formulários de contacto.

As ferramentas de leitura estão identificadas como tal, as de apagar como definitivas. Quem quer alterar destinos, pôr uma página offline ou apagá-la tem de perguntar ao utilizador e enviar o estado lido anteriormente. Através de API e MCP, são possíveis no máximo 10 por hora.

Duas formas de iniciar sessão

O ChatGPT e o Claude.ai adicionam o servidor como conector. O início de sessão faz-se por OAuth: inicias sessão no Same-QR no navegador e defines, marcando opções, se a app pode apenas ler, também criar e alterar textos, ou ainda alterar destinos e apagar.

O Claude Code, o Cursor e o Codex ligam-se com uma chave de API. Crias a chave no painel, em Conta, «Acesso para CLI, scripts e agentes», escolhes «só leitura», «leitura + escrita» (criar, alterar nomes e textos) ou «total» (também alterar destinos, pôr offline, apagar) e guardas a chave como variável de ambiente SAMEQR_API_KEY. Uma chave de «só leitura» tem um bom efeito secundário: o assistente nem sequer vê as ferramentas de escrita.

Configuração em resumo

Para o Claude Code basta um comando no terminal:

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

Para o Cursor, uma entrada em ~/.cursor/mcp.json:

{ "mcpServers": { "sameqr": { "url": "https://sameqr.com/api/mcp", "headers": { "Authorization": "Bearer ${env:SAMEQR_API_KEY}" } } } }

Para o Codex, uma secção em ~/.codex/config.toml:

[mcp_servers.sameqr]
url = "https://sameqr.com/api/mcp"
bearer_token_env_var = "SAMEQR_API_KEY"

Quem tiver instalada a linha de comandos sameqr vê estas indicações a qualquer momento com «sameqr mcp». Testa cada ligação primeiro com uma pergunta de leitura, por exemplo «Que códigos QR tenho?».

Segurança e permissões

• Para assistentes que só devem analisar, usa uma chave de «só leitura».
• Nunca escrevas chaves em ficheiros do projeto, define-as como variável de ambiente.
• Antes de alterações a códigos QR já impressos, pede que te mostrem o plano.
• Revoga no painel as chaves de que já não precisas. Ficam logo inválidas.

Conclusão: porquê o Same-QR

O Same-QR oferece um servidor MCP completo, em vez de um punhado de funções de brinquedo: códigos QR, estatísticas, ementas, páginas de convidados, etiquetas e projetos, tanto para assistentes de chat como para agentes de programação. Está incluído em todos os planos, com permissões claras e as mesmas verificações do painel.

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, e a documentação está em sameqr.com/entwickler.

Perguntas frequentes