Skip to content

MCP-palvelin

MCP-palvelin

qr3.app MCP-palvelin tarjoaa uusimmat QR- ja DPP-työkalut Claudelle, Cursorille ja muille MCP-yhteensopiville asiakasohjelmille. Palvelin toimii HTTP-yhteydellä Bearer-autentikoinnilla.

Suojattu yhteys

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

Nykyinen etäpalvelin käyttää HTTP Bearer -todennusta:

Authorization: Bearer <API_KEY>

Käytä vain MCP-asiakasta, joka voi lähettää mukautetun HTTP-otsakkeen Authorization suojatusta tunnistetietovarastostaan. Älä koskaan tallenna API-avainta projektin asetustiedostoon tai tietovarastoon.

Claudin etäliittimet käyttävät OAuthia. qr3 tarjoaa tällä hetkellä vain Bearer-avainautentikoinnin, joten se ei ole suoraan yhteensopiva tämän liitinvirran kanssa ennen OAuth-tuen lisäämistä.

Discovery ilman API-avainta

Asiakkaan ei tarvitse ensin pyytää tunnistetietoja selvittääkseen, mitä tämä palvelin tarjoaa. Osoite https://mcp.qr3.app/mcp vastaa seuraaviin metodeihin ilman Authorization-otsikkoa:

MetodiPalauttaa
initializeProtokollaversio, capabilities, palvelimen nimi
tools/listkaikki työkalut syöteskeemoineen
resources/liststaattisten resurssien luettelo
resources/readyksittäisen resurssin sisältö
prompts/listprompt-luettelo
pingsaavutettavuus

Jokainen työtilaa koskettava metodi kulkee metodin tools/call kautta — ja se vaatii edelleen Bearer-avaimen. Ilman sitä palvelin vastaa HTTP 401, application/problem+json ja WWW-Authenticate: Bearer realm="qr3.app".

Terminal window
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":{}}'

Asiakkaille, jotka eivät tue MCP-protokollaa, sama luettelo on saatavilla tavallisena JSON-muotona osoitteessa https://mcp.qr3.app/resources ja yksittäinen resurssi osoitteessa https://mcp.qr3.app/resources/<uri-ohne-qr3://>.

Saatavilla olevat työkalut

Ydintyökalut

TyökaluKuvaus
create_qrLuo QR-koodi URL-osoitteelle
update_qrMuuta QR-koodin kohde-URL-osoitetta, tilaa, tunnisteita, muistiinpanoja tai vanhentumisaikaa
list_qrsListaa QR-koodit tilasuodattimella ja kohdistinpohjaisella sivutuksella
get_qr_statsHae QR-koodin aggregoidut skannaustilastot
create_batchLuo QR-koodeja URL-luettelosta (enintään 50)
create_dpp_qrLuo DPP-QR-koodi akulle, tekstiilille tai yleiselle tuotteelle
create_vcard_qrLuo staattinen vCard-QR-koodi
create_wifi_qrLuo staattinen WiFi-QR-koodi
validate_dppValidoi DPP-tiedot luomatta niitä
get_imageHae API:n tarjoama PNG-, SVG-, PDF- tai EPS-tiedoston URL-osoite
shorten_urlLuo dynaaminen URL-QR-koodi ja palauta sen lyhyt URL

DPP-resurssit

Palvelin tarjoaa myös staattisia resursseja DPP-sopimusta varten:

URISisältö
qr3://qr-typesCodes API:n kuusi tyyppiä: URL, vCard, WiFi, sähköposti, SMS ja sijainti
qr3://error-codesVirhetyypit ja ratkaisuohjeet
qr3://rate-limitsSopimuspohjaiset pyyntörajat
qr3://quickstartPikaopas
qr3://dpp-schemaAkkukeskeinen DPP-sopimus
qr3://gs1-test-vectorsGS1-selvitysesimerkit
qr3://dpp-content-negotiation-examplesResolverin vastausesimerkit

Esimerkkikehotteet

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