Same-QR voor ontwikkelaars: API, MCP-server en CLI in één overzicht

Drie toegangen, één account

Same-QR voor ontwikkelaars betekent: alles wat het dashboard kan, is er ook als REST-API, als MCP-server voor AI-assistenten en als opdrachtregel. Alle drie roepen dezelfde functies aan, met dezelfde abonnementsgrenzen en controles, en alle drie zitten in elk abonnement.

De toegang

Sleutels maak je in het dashboard aan onder Account, „Toegang voor CLI, scripts en agents“: „alleen lezen“, „lezen + schrijven“ (aanmaken, namen en teksten wijzigen) of „volledig“ (daarnaast bestemmingen wijzigen, offline halen, verwijderen), met een looptijd van 30, 90, 180 of 365 dagen of bewust onbeperkt, tot 10 per account. De sleutel begint met sqr_live_, wordt één keer getoond en hoort in de omgevingsvariabele SAMEQR_API_KEY.

De 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-codes, statistieken, gastpagina's, menukaarten uit foto's, labels, klantprojecten en aanvragen. Fouten komen op een vaste manier terug als object error met status, code en message. De volledige beschrijving staat op /api/v1/openapi.json. Grenzen: 120 aanvragen per minuut per sleutel, per uur 60, 300, 1.000 of 5.000, afhankelijk van het abonnement.

De MCP-server

Adres https://sameqr.com/api/mcp. ChatGPT en Claude.ai voegen hem toe als connector en melden zich aan via OAuth. Voor Claude Code:

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

Voor Cursor en Codex toont „sameqr mcp“ de vermeldingen voor ~/.cursor/mcp.json en ~/.codex/config.toml. Met een leessleutel ziet een agent alleen de lezende hulpmiddelen.

De 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

Zonder afhankelijkheden, vanaf Node.js 18, met --json voor scripts en duidelijke retourwaarden bij fouten. „sameqr --help“ toont alle opdrachten.

Waar je begint

• Registreer gratis en bevestig je e-mailadres.
• Maak een sleutel „alleen lezen“ aan en probeer „sameqr whoami“ uit.
• Lees de handleidingen op sameqr.com/entwickler.
• Kies daarna de weg die bij jouw project past.

Conclusie: waarom Same-QR

Same-QR geeft ontwikkelaars de hele dienst in handen, niet slechts een deel: API, MCP-server en CLI met dezelfde functies als het dashboard, zorgvuldige omgang met sleutels en openlijk gedocumenteerde grenzen. 20 dynamische QR-codes zijn blijvend gratis, om uit te proberen is dat genoeg.

Begin meteen: registreer je gratis op sameqr.com, 20 dynamische QR-codes zijn blijvend gratis. API, CLI en MCP-server zijn er in elk abonnement, de documentatie staat op sameqr.com/entwickler.

Veelgestelde vragen