Server MCP pentru coduri QR: folosește Same-QR în Claude, ChatGPT, Cursor și Codex

Ce este un server MCP

MCP înseamnă Model Context Protocol, un standard deschis pentru legătura dintre asistenții AI și alte servicii. Un server MCP descrie instrumentele unui serviciu, de exemplu „Creează cod QR” sau „Citește statistica”. Asistentul vede aceste instrumente și le apelează atunci când o sarcină are nevoie de ele.

Ce oferă serverul MCP Same-QR

Serverul se află la https://sameqr.com/api/mcp și oferă exact instrumentele API-ului REST, cu aceleași nume, aceleași verificări și aceleași limite de tarif:

• Interogarea contului și a tarifului, ca asistentul să știe ce este posibil.
• Listarea, citirea, crearea, modificarea și ștergerea codurilor QR și preluarea statisticii lor.
• Crearea, citirea, modificarea, publicarea, scoaterea offline și ștergerea paginilor pentru oaspeți, plus lista designurilor.
• Citirea meniurilor și a listelor de prețuri din fotografii sau PDF.
• Administrarea etichetelor și a proiectelor clienților și citirea cererilor din formularele de contact.

Instrumentele de citire sunt marcate ca atare, iar cele de ștergere ca definitive. Cine vrea să schimbe destinații, să scoată o pagină offline sau să o șteargă trebuie să-l întrebe pe utilizator și să trimită starea citită în prealabil. Prin API și MCP se pot face cel mult 10 pe oră.

Două feluri de autentificare

ChatGPT și Claude.ai adaugă serverul ca Connector. Autentificarea se face prin OAuth: te autentifici în browser la Same-QR și stabilești printr-o bifă dacă aplicația are voie doar să citească, să și creeze și să modifice texte sau, în plus, să schimbe destinații și să șteargă.

Claude Code, Cursor și Codex se conectează cu o cheie API. O creezi în panou, la Cont, „Acces pentru CLI, scripturi și agenți”, alegi „doar citire”, „citire + scriere” (creare, modificarea numelor și a textelor) sau „complet” (în plus schimbarea destinațiilor, scoaterea offline, ștergerea) și o salvezi ca variabilă de mediu SAMEQR_API_KEY. O cheie cu „doar citire” are un efect secundar plăcut: asistentul nici nu vede atunci instrumentele de scriere.

Configurarea pe scurt

Pentru Claude Code este de ajuns o comandă în terminal:

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

Pentru Cursor, o intrare în ~/.cursor/mcp.json:

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

Pentru Codex, o secțiune în ~/.codex/config.toml:

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

Cine a instalat linia de comandă sameqr primește aceste date oricând cu „sameqr mcp”. Testează fiecare conexiune mai întâi cu o întrebare de citire, de exemplu „Ce coduri QR am?”.

Securitate și drepturi

• Pentru asistenții care trebuie doar să analizeze, folosește o cheie cu „doar citire”.
• Nu scrie niciodată cheia în fișierele proiectului, ci setează-o ca variabilă de mediu.
• Înainte de modificări la coduri QR tipărite, cere să ți se arate planul.
• Revocă în panou cheile de care nu mai ai nevoie. Ele devin imediat nevalide.

Concluzie: de ce Same-QR

Same-QR oferă un server MCP complet, nu o mână de funcții-jucărie: coduri QR, statistică, meniuri, pagini pentru oaspeți, etichete și proiecte, deopotrivă pentru asistenți de chat și pentru agenți de programare. Este inclus în orice tarif, cu drepturi clare și cu aceleași verificări ca în panou.

Începe chiar acum: înregistrează-te gratuit pe sameqr.com, 20 de coduri QR dinamice sunt gratuite pentru totdeauna. API-ul, CLI și serverul MCP există în orice tarif, iar documentația se află la sameqr.com/entwickler.

Întrebări frecvente