Same-QR pro vývojáře: API, server MCP a CLI na první pohled

Tři přístupy, jeden účet

Same-QR pro vývojáře znamená: Všechno, co umí dashboard, existuje i jako REST API, jako server MCP pro AI asistenty a jako příkazový řádek. Všechny tři volají stejné funkce, se stejnými limity tarifů a stejnými kontrolami, a všechny tři jsou součástí každého tarifu.

Přístup

Klíče vytvoříš v dashboardu v části Účet, „Přístup pro CLI, skripty a agenty“: „jen čtení“, „čtení + zápis“ (zakládání, změna názvů a textů) nebo „plný přístup“ (navíc změna cílů, vypnutí, mazání), platnost 30, 90, 180 nebo 365 dní nebo záměrně neomezená, až 10 na účet. Klíč začíná sqr_live_, zobrazí se jen jednou a patří do proměnné prostředí SAMEQR_API_KEY.

REST API

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/konto
curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr

QR kódy, statistiky, hostované stránky, jídelní lístky z fotek, štítky, zákaznické projekty a dotazy. Chyby přicházejí jednotně jako objekt error s položkami status, code a message. Kompletní popis najdeš na /api/v1/openapi.json. Limity: 120 požadavků za minutu na klíč, za hodinu 60, 300, 1.000 nebo 5.000 podle tarifu.

Server MCP

Adresa https://sameqr.com/api/mcp. ChatGPT a Claude.ai ho přidají jako konektor a přihlásí se přes OAuth. Pro Claude Code:

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

Pro Cursor a Codex zobrazí „sameqr mcp“ záznamy pro ~/.cursor/mcp.json a ~/.codex/config.toml. S klíčem jen pro čtení vidí agent pouze nástroje pro čtení.

CLI

npm install -g sameqr
sameqr login
sameqr qr create --name "Speisekarte" --url https://example.com/karte
sameqr seite create --vorlage speisekarte --name "Gasthof zum Löwen"
sameqr karte import karte.jpg --seite menu/gasthof-zum-loewen
sameqr seite publish menu/gasthof-zum-loewen

Bez závislostí, od Node.js 18, s --json pro skripty a jednoznačnými návratovými hodnotami pro chyby. „sameqr --help“ zobrazí všechny příkazy.

Kde začít

• Zaregistruj se zdarma a potvrď e-mailovou adresu.
• Vytvoř klíč „jen čtení“ a vyzkoušej „sameqr whoami“.
• Přečti si návody na sameqr.com/entwickler.
• Pak si vyber cestu, která se hodí k tvému projektu.

Závěr: Proč Same-QR

Same-QR dává vývojářům do rukou celou službu, ne jen její část: API, server MCP a CLI se stejnými funkcemi jako dashboard, pečlivým zacházením s klíči a otevřeně zdokumentovanými limity. 20 dynamických QR kódů je trvale zdarma, na vyzkoušení to stačí.

Začni hned: Zaregistruj se zdarma na sameqr.com, 20 dynamických QR kódů je trvale zdarma. API, CLI i server MCP jsou součástí každého tarifu, dokumentace je na sameqr.com/entwickler.

Často kladené otázky