Same-QR dla programistów: API, serwer MCP i CLI w skrócie

Trzy drogi, jedno konto

Same-QR dla programistów oznacza: wszystko, co potrafi panel, jest dostępne także jako REST API, jako serwer MCP dla asystentów AI i jako wiersz poleceń. Wszystkie trzy wywołują te same funkcje, z tymi samymi limitami planu i kontrolami, i wszystkie trzy są w każdym planie.

Dostęp

Klucze tworzysz w panelu w sekcji Konto, „Dostęp dla CLI, skryptów i agentów”: „tylko odczyt”, „odczyt + zapis” (tworzenie, zmiana nazw i tekstów) albo „pełny” (dodatkowo zmiana celów, wyłączanie, usuwanie), okres ważności 30, 90, 180 lub 365 dni albo świadomie bez limitu, do 10 na konto. Klucz zaczyna się od sqr_live_, jest wyświetlany tylko raz i należy go zapisać w zmiennej środowiskowej 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

Kody QR, statystyki, strony gościnne, menu ze zdjęć, etykiety, projekty klientów i zapytania. Błędy przychodzą jednolicie jako obiekt error z polami status, code i message. Pełny opis znajdziesz pod /api/v1/openapi.json. Limity: 120 zapytań na minutę na klucz, na godzinę 60, 300, 1.000 lub 5.000, zależnie od planu.

Serwer MCP

Adres https://sameqr.com/api/mcp. ChatGPT i Claude.ai dodają go jako konektor i logują się przez OAuth. Dla Claude Code:

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

Dla Cursor i Codex polecenie „sameqr mcp” pokazuje wpisy do ~/.cursor/mcp.json i ~/.codex/config.toml. Z kluczem tylko do odczytu agent widzi wyłącznie narzędzia odczytu.

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 zależności, od Node.js 18, z opcją --json dla skryptów i jednoznacznymi kodami zwrotnymi dla błędów. „sameqr --help” pokazuje wszystkie polecenia.

Od czego zacząć

• Zarejestruj się za darmo i potwierdź adres e-mail.
• Utwórz klucz „tylko odczyt” i wypróbuj „sameqr whoami”.
• Przeczytaj instrukcje na sameqr.com/entwickler.
• Potem wybierz drogę, która pasuje do twojego projektu.

Podsumowanie: dlaczego Same-QR

Same-QR daje programistom całą usługę, a nie tylko wycinek: API, serwer MCP i CLI z tymi samymi funkcjami co panel, starannym obchodzeniem się z kluczami i otwarcie opisanymi limitami. 20 dynamicznych kodów QR jest na stałe bezpłatne, do wypróbowania w zupełności wystarczy.

Zacznij od razu: zarejestruj się za darmo na sameqr.com, 20 dynamicznych kodów QR jest na stałe bezpłatne. API, CLI i serwer MCP są w każdym planie, dokumentacja jest na sameqr.com/entwickler.

Najczęściej zadawane pytania