Server MCP

Is-Server MCP ta’ qr3.app jipprovdi l-għodod attwali tal-QR u tad-DPP għal Claude, Cursor u klijenti oħra kompatibbli mal-MCP. Is-server jaħdem fuq HTTP b’awtentikazzjoni Bearer.

Konnessjoni sigura

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

Is-server remot attwali juża awtentikazzjoni HTTP Bearer:

Authorization: Bearer <API_KEY>

Uża biss klijent MCP li jista’ jibgħat header HTTP Authorization personalizzat mill-ħażna sigura tal-kredenzjali tiegħu. Qatt ma ddaħħal ċavetta API f’fajl ta’ konfigurazzjoni tal-proġett jew f’repożitorju.

Il-Claude Remote Connectors jużaw OAuth. qr3 bħalissa joffri biss awtentikazzjoni b’ċavetta Bearer, għalhekk mhuwiex kompatibbli direttament ma’ dan il-fluss tal-connector sakemm jiżdied l-appoġġ għal OAuth.

Discovery mingħajr API-Key

Klijent m’għandux għalfejn l-ewwel jitlob kredenzjali tal-aċċess biex jiskopri x’joffri dan is-server. Il-metodi li ġejjin huma mwieġba minn https://mcp.qr3.app/mcp mingħajr l-header Authorization:

Metodu	Jirritorna
`initialize`	Verżjoni tal-protokoll, kapaċitajiet, isem tas-server
`tools/list`	l-għodod kollha flimkien mal-iskema tal-input
`resources/list`	il-katalgu tar-riżorsi statiċi
`resources/read`	il-kontenut ta’ riżorsa waħda
`prompts/list`	il-lista tal-prompts
`ping`	aċċessibbiltà

Kull metodu li jaffettwa Workspace jgħaddi minn tools/call — u dan jibqa’ jirrikjedi l-Bearer-Key. Mingħajru, is-server iwieġeb b’HTTP 401, application/problem+json u 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":{}}'

Għal klijenti li ma jitkellmux MCP, l-istess katalgu huwa disponibbli bħala JSON sempliċi taħt https://mcp.qr3.app/resources, u riżorsa waħda taħt https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Għodod Disponibbli

Għodod Ewlenin

Għodda	Deskrizzjoni
`create_qr`	Oħloq kodiċi QR għal URL
`update_qr`	Ibdel il-URL tad-destinazzjoni, l-istatus, it-tags, in-noti jew l-iskadenza ta’ kodiċi QR
`list_qrs`	Elenka l-kodiċijiet QR b’filtru tal-istatus u paġinazzjoni bil-cursor
`get_qr_stats`	Ikseb statistika aggregata tal-iskannjar għal kodiċi QR
`create_batch`	Oħloq kodiċijiet QR minn lista ta’ URLs (massimu 50)
`create_dpp_qr`	Oħloq kodiċi QR DPP għal batterija, tessut jew prodott ġenerali
`create_vcard_qr`	Oħloq kodiċi QR vCard statiku
`create_wifi_qr`	Oħloq kodiċi QR WiFi statiku
`validate_dpp`	Ivvalida d-data DPP mingħajr ma toħloqha
`get_image`	Ikseb URL għal fajl PNG, SVG, PDF jew EPS ipprovdut mill-API
`shorten_url`	Oħloq kodiċi QR URL dinamiku u rritorna l-URL qasir tiegħu

Riżorsi DPP

Is-server jipprovdi wkoll riżorsi statiċi għall-kuntratt DPP:

URI	Kontenut
`qr3://qr-types`	Is-sitt tipi tal-Codes API: URL, vCard, WiFi, email, SMS u lokazzjoni
`qr3://error-codes`	Tipi ta’ żbalji u pariri għas-soluzzjoni tagħhom
`qr3://rate-limits`	Limiti tar-rata bbażati fuq il-pjan
`qr3://quickstart`	Gwida ta’ bidu mgħaġġel
`qr3://dpp-schema`	Kuntratt DPP iċċentrat fuq il-batteriji
`qr3://gs1-test-vectors`	Eżempji ta’ GS1 Resolver
`qr3://dpp-content-negotiation-examples`	Eżempji ta’ tweġiba tar-Resolver

Eżempji ta’ Prompts

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