MCP-szerver QR-kódokhoz: a Same-QR használata Claude-ban, ChatGPT-ben, Cursorban és Codexben

Mi az az MCP-szerver

Az MCP a Model Context Protocol rövidítése, egy nyílt szabvány az MI-asszisztensek és más szolgáltatások összekapcsolására. Az MCP-szerver leírja egy szolgáltatás eszközeit, például a „QR-kód létrehozása” vagy a „Statisztika olvasása” eszközt. Az asszisztens látja ezeket az eszközöket, és meghívja őket, ha egy feladathoz szükség van rájuk.

Mit biztosít a Same-QR MCP-szervere

A szerver a https://sameqr.com/api/mcp címen érhető el, és pontosan a REST API eszközeit kínálja, ugyanazokkal a nevekkel, ellenőrzésekkel és csomaghatárokkal:

• A fiók és a csomag lekérdezése, hogy az asszisztens tudja, mi lehetséges.
• QR-kódok listázása, olvasása, létrehozása, módosítása, törlése és statisztikájuk lekérdezése.
• Vendégoldalak létrehozása, olvasása, módosítása, közzététele, offline állapotba helyezése és törlése, valamint a dizájnok listája.
• Étlapok és árlisták beolvasása fényképekből vagy PDF-ből.
• Címkék és ügyfélprojektek kezelése, valamint a kapcsolati űrlapokból érkező megkeresések olvasása.

Az olvasó eszközök olvasóként vannak jelölve, a törlő eszközök véglegesként. Aki célokat akar módosítani, egy oldalt offline állapotba helyezni vagy törölni, annak meg kell kérdeznie a felhasználót, és el kell küldenie az előzőleg beolvasott állapotot. Az API-n és az MCP-n keresztül ezekből óránként legfeljebb 10 mehet.

A bejelentkezés kétféle módja

A ChatGPT és a Claude.ai csatlakozóként adja hozzá a szervert. A bejelentkezés OAuth-on keresztül zajlik: a böngészőben bejelentkezel a Same-QR-nál, és pipával határozod meg, hogy az alkalmazás csak olvashat, létrehozhat és szövegeket is módosíthat, vagy ezen felül célokat is módosíthat és törölhet.

A Claude Code, a Cursor és a Codex API-kulccsal csatlakozik. A kulcsot a vezérlőpulton a Fiók alatt, a „Hozzáférés CLI-hez, szkriptekhez és ügynökökhöz” szakaszban hozod létre, kiválasztod a „csak olvasás”, az „olvasás + írás” (létrehozás, nevek és szövegek módosítása) vagy a „teljes” (emellett célok módosítása, offline állapotba helyezés, törlés) szintet, és a SAMEQR_API_KEY környezeti változóként elmented. A „csak olvasás” kulcsnak van egy szép mellékhatása: az asszisztens ilyenkor az író eszközöket egyáltalán nem is látja.

A beállítás áttekintése

A Claude Code-hoz egyetlen parancs elég a terminálban:

claude mcp add --transport http sameqr https://sameqr.com/api/mcp --header "Authorization: Bearer $SAMEQR_API_KEY"

A Cursorhoz egy bejegyzés a ~/.cursor/mcp.json fájlban:

{ "mcpServers": { "sameqr": { "url": "https://sameqr.com/api/mcp", "headers": { "Authorization": "Bearer ${env:SAMEQR_API_KEY}" } } } }

A Codexhez egy szakasz a ~/.codex/config.toml fájlban:

[mcp_servers.sameqr]
url = "https://sameqr.com/api/mcp"
bearer_token_env_var = "SAMEQR_API_KEY"

Aki telepítette a sameqr parancssort, ezeket az adatokat bármikor megkapja a „sameqr mcp” paranccsal. Minden kapcsolatot először egy olvasó kérdéssel teszteld, például: „Milyen QR-kódjaim vannak?”.

Biztonság és jogosultságok

• Azoknál az asszisztenseknél, amelyeknek csak kiértékelniük kell, „csak olvasás” kulcsot használj.
• A kulcsot soha ne írd projektfájlokba, hanem környezeti változóként add meg.
• A kinyomtatott QR-kódok módosítása előtt kérd, hogy az asszisztens mutassa meg a tervet.
• A már nem szükséges kulcsokat vond vissza a vezérlőpulton. Ekkor azonnal érvénytelenné válnak.

Összegzés: miért a Same-QR

A Same-QR teljes MCP-szervert ad, nem néhány játékfunkciót: QR-kódok, statisztika, étlapok, vendégoldalak, címkék és projektek, a chat-asszisztenseknek és a kódoló ügynököknek egyaránt. Minden csomagban benne van, egyértelmű jogosultságokkal és ugyanazokkal az ellenőrzésekkel, mint a vezérlőpulton.

Kezdj bele most: regisztrálj ingyen a sameqr.com oldalon, 20 dinamikus QR-kód tartósan ingyenes. Az API, a CLI és az MCP-szerver minden csomagban benne van, a dokumentáció a sameqr.com/entwickler oldalon van.

Gyakran ismételt kérdések