Cursor com MCP: configurar o Same-QR no editor e gerir códigos QR

O Cursor e o MCP em resumo

O Cursor é um editor de código com assistente de IA integrado, que conhece o teu projeto e executa tarefas em vários ficheiros. Através do MCP, usa ainda ferramentas de outros serviços. Para quem desenvolve sites e para agências, isto significa que o site e os códigos QR que apontam para as suas páginas podem ser mantidos na mesma ferramenta.

Passo 1: criar a chave

No painel do Same-QR, em Conta, na secção “Acesso para CLI, scripts e agentes”, crias uma chave: “só leitura” para análises, “leitura + escrita” para criar, ou “total” se também for para alterar destinos. Disponibiliza-a como variável de ambiente SAMEQR_API_KEY antes de iniciares o Cursor.

Passo 2: entrada no mcp.json

Abre o ficheiro ~/.cursor/mcp.json ou cria-o, e regista o Same-QR:

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

A entrada apenas aponta para a variável de ambiente, a chave em si não fica no ficheiro. Se já existirem outros servidores aí, acrescenta o sameqr dentro de mcpServers. O comando “sameqr mcp” também te mostra a entrada.

Passo 3: testar

Reinicia o Cursor e pergunta ao assistente: “Que códigos QR tenho no Same-QR?” Se a lista aparecer, a ligação está feita.

Passo 4: relançamento do site de um cliente

Num relançamento, os endereços mudam. Os redirecionamentos do site tens debaixo de olho, mas os códigos QR impressos esquecem-se facilmente. Com o Cursor, isso passa a fazer parte do mesmo trabalho:

• Pede ao assistente que liste todos os códigos QR do cliente com o respetivo destino atual.
• Pede-lhe que compare a lista com a correspondência entre endereços antigos e novos no projeto.
• Pede um plano: que código QR deve apontar para que novo endereço.
• Verifica o plano, confirma e só então manda fazer a alteração.
• Depois da alteração, lê alguns códigos QR com o telemóvel.

Se o site estiver ligado ao Same-QR, o que é possível nos planos pagos, depois de um relançamento o Same-QR sugere também, por si, o novo endereço. Só se altera depois da tua confirmação.

Segurança

• Para análises, usa uma chave “só leitura”, assim o assistente não vê ferramentas de escrita.
• Nunca escrevas a chave diretamente no mcp.json nem em ficheiros do projeto.
• Pede que as alterações a códigos QR impressos sejam mostradas primeiro como plano.
• Revoga a chave quando o projeto terminar.

Conclusão: porquê o Same-QR

O Same-QR leva os teus códigos QR para o editor, com uma única entrada no mcp.json. Tens todas as funções, permissões claras e a certeza de que, num relançamento, nenhum código QR impresso leva a lado nenhum. Em todos os planos.

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