Servidor MCP

O servidor MCP do qr3.app disponibiliza as ferramentas atuais de QR e DPP para o Claude, Cursor e outros clientes compatíveis com MCP. O servidor é executado via HTTP com autenticação Bearer.

Ligação segura

Endpoint: https://mcp.qr3.app/mcp

O servidor remoto atual utiliza autenticação HTTP Bearer:

Authorization: Bearer <API_KEY>

Utilize apenas um cliente MCP que consiga enviar um cabeçalho HTTP Authorization personalizado a partir do seu armazenamento seguro de credenciais. Nunca grave uma chave de API num ficheiro de configuração do projeto ou num repositório.

Os Remote Connectors do Claude utilizam OAuth. Atualmente, o qr3 oferece apenas autenticação por chave Bearer e, por isso, não é diretamente compatível com esse fluxo de conector até ser adicionado suporte para OAuth.

Discovery sem API-Key

Um cliente não precisa primeiro solicitar credenciais para descobrir o que este servidor oferece. O https://mcp.qr3.app/mcp responde aos seguintes métodos sem o cabeçalho Authorization:

Método	Retorna
`initialize`	Versão do protocolo, capacidades, nome do servidor
`tools/list`	todas as ferramentas e o seu esquema de entrada
`resources/list`	o catálogo de recursos estáticos
`resources/read`	o conteúdo de um único recurso
`prompts/list`	a lista de prompts
`ping`	acessibilidade

Qualquer método que toque em um workspace passa por tools/call — e este continua a exigir a chave Bearer. Sem ela, o servidor responde com HTTP 401, application/problem+json e WWW-Authenticate: Bearer realm="qr3.app".

curl -s https://mcp.qr3.app/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"resources/list","params":{}}'

Para clientes que não suportam MCP, o mesmo catálogo está disponível como um JSON simples em https://mcp.qr3.app/resources, e um recurso individual em https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Ferramentas Disponíveis

Ferramentas Principais

Ferramenta	Descrição
`create_qr`	Criar um código QR para uma URL
`update_qr`	Alterar a URL de destino, o status, as tags, as notas ou a expiração de um código QR
`list_qrs`	Listar códigos QR com filtro de status e paginação por cursor
`get_qr_stats`	Obter estatísticas agregadas de leitura de um código QR
`create_batch`	Criar códigos QR a partir de uma lista de URLs (máximo de 50)
`create_dpp_qr`	Criar um código QR DPP para uma bateria, um têxtil ou um produto geral
`create_vcard_qr`	Criar um código QR vCard estático
`create_wifi_qr`	Criar um código QR WiFi estático
`validate_dpp`	Validar dados DPP sem criá-los
`get_image`	Obter uma URL de recurso PNG, SVG, PDF ou EPS fornecida pela API
`shorten_url`	Criar um código QR de URL dinâmico e retornar sua URL curta

Recursos DPP

O servidor também disponibiliza recursos estáticos para o contrato DPP:

URI	Conteúdo
`qr3://qr-types`	Os seis tipos da Codes API: URL, vCard, WiFi, e-mail, SMS e localização
`qr3://error-codes`	Tipos de erro e orientações de resolução
`qr3://rate-limits`	Limites de taxa baseados no plano
`qr3://quickstart`	Guia de início rápido
`qr3://dpp-schema`	Contrato DPP focado em baterias
`qr3://gs1-test-vectors`	Exemplos de resolver GS1
`qr3://dpp-content-negotiation-examples`	Exemplos de resposta do resolver

Prompts de Exemplo

Erstelle einen QR-Code für https://example.com

Zeige mir die Scan-Statistiken für qr_abc123

Erstelle einen Batterie-DPP mit GTIN 04012345678901 und den Pflichtfeldern