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.

Conexã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 salve uma chave de API em um arquivo de configuração do projeto nem em um 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`	Limite de requisições por chave de API (60/min, todos os planos)
`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

Crie um código QR para https://example.com

Mostre as estatísticas de leitura de qr_abc123

Crie um DPP de bateria com o GTIN 04012345678901 e os campos obrigatórios