MCP сървър

MCP сървърът на qr3.app предоставя актуалните QR и DPP инструменти за Claude, Cursor и други MCP-съвместими клиенти. Сървърът работи през HTTP с Bearer автентикация.

Сигурна връзка

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

Текущият отдалечен сървър използва HTTP Bearer автентикация:

Authorization: Bearer <API_KEY>

Използвайте само MCP клиент, който може да изпраща персонализиран HTTP заглавен ред Authorization от защитеното си хранилище за идентификационни данни. Никога не записвайте API ключ в конфигурационен файл на проект или в хранилище.

Claude Remote Connectors използват OAuth. Понастоящем qr3 предлага само Bearer-key автентикация, затова не е пряко съвместим с този поток на конектора, докато не бъде добавена OAuth поддръжка.

Discovery без API ключ

Клиентът не трябва първо да изисква данни за достъп, за да разбере какво предлага този сървър. Следните методи се поддържат от https://mcp.qr3.app/mcp без Authorization заглавка:

Метод	Връща
`initialize`	Версия на протокола, възможности (capabilities), име на сървъра
`tools/list`	всички инструменти заедно с входната схема
`resources/list`	каталога на статичните ресурси
`resources/read`	съдържанието на единичен ресурс
`prompts/list`	списъка с подкани (prompts)
`ping`	достъпност

Всеки метод, който засяга даден Workspace, преминава през tools/call — и той продължава да изисква Bearer ключа. Без него сървърът отговаря с HTTP 401, application/problem+json и 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":{}}'

За клиенти, които не поддържат MCP, същият каталог е наличен като обикновен JSON на https://mcp.qr3.app/resources, а отделен ресурс — на https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Налични инструменти

Основни инструменти

Инструмент	Описание
`create_qr`	Създаване на QR код за URL адрес
`update_qr`	Промяна на целевия URL адрес, статуса, таговете, бележките или срока на валидност на QR код
`list_qrs`	Списък на QR кодове с филтър по статус и пагинация с курсор
`get_qr_stats`	Получаване на обобщена статистика за сканиране на QR код
`create_batch`	Създаване на QR кодове от списък с URL адреси (макс. 50)
`create_dpp_qr`	Създаване на DPP QR код за батерия, текстил или общ продукт
`create_vcard_qr`	Създаване на статичен vCard QR код
`create_wifi_qr`	Създаване на статичен WiFi QR код
`validate_dpp`	Проверка на DPP данни без създаване
`get_image`	Получаване на предоставен от API URL за PNG, SVG, PDF или EPS файл
`shorten_url`	Създаване на динамичен URL QR код и връщане на краткия му URL адрес

DPP ресурси

Сървърът също така предоставя статични ресурси (Resources) за DPP договора:

URI	Съдържание
`qr3://qr-types`	Шестте типа на Codes API: URL, vCard, WiFi, имейл, SMS и местоположение
`qr3://error-codes`	Типове грешки и указания за разрешаване
`qr3://rate-limits`	Лимити на заявките (rate limits) според плана
`qr3://quickstart`	Ръководство за бърз старт
`qr3://dpp-schema`	Ориентиран към батерии DPP договор
`qr3://gs1-test-vectors`	Примери за GS1 Resolver
`qr3://dpp-content-negotiation-examples`	Примери за отговори от Resolver-а

Примерни промптове

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