Claude Code i kody QR: konfiguracja Same-QR przez MCP, krok po kroku

Czym jest Claude Code

Claude Code to agent programistyczny od Anthropic. Działa w terminalu lub w środowisku programistycznym, czyta i edytuje pliki oraz wykonuje polecenia. Przez MCP, czyli Model Context Protocol, korzysta dodatkowo z narzędzi innych usług. Połączony z Same-QR może edytować w twoim koncie kody QR, strony gości, menu, etykiety i projekty klientów.

Krok 1: utwórz klucz API

Otwórz w panelu Same-QR sekcję Konto i fragment „Dostęp dla CLI, skryptów i agentów”. Utwórz klucz. Jeśli Claude Code ma tylko analizować, wybierz „tylko odczyt”, wtedy agent w ogóle nie widzi narzędzi zapisujących. Do tworzenia wybierz „odczyt + zapis”, a jeśli ma też zmieniać cele istniejących kodów QR, „pełny”. Klucz zaczyna się od sqr_live_ i jest pokazywany tylko raz.

Krok 2: ustaw klucz jako zmienną środowiskową

Zapisz klucz w menedżerze haseł i udostępnij go jako zmienną środowiskową SAMEQR_API_KEY, na przykład przy uruchomieniu powłoki. W plikach projektu nie ma dla niego miejsca.

Krok 3: dodaj serwer MCP

Wystarczy jedno polecenie w terminalu:

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

Kto zainstalował wiersz poleceń sameqr, zobaczy tę linię także po wpisaniu „sameqr mcp”.

Krok 4: przetestuj połączenie

Uruchom Claude Code i zapytaj najpierw o coś, co niczego nie zmienia: „Jaki mam plan w Same-QR i jakie kody QR istnieją?” Serwer zaleca agentowi, by zaczynał od tego zapytania o konto, żeby znał limity twojego planu.

Krok 5: kody QR dla strony kampanii

Typowe zadanie, gdy w projekcie powstaje nowa strona docelowa:

„Utwórz w Same-QR trzy dynamiczne kody QR dla nowej strony /herbst: plakat, ulotka i stojak na stół. Do celu dodaj za każdym razem utm_source=qr i utm_medium z nazwą nośnika, wszystkim nadaj etykietę Herbstaktion i najpierw pokaż mi listę.”

Po twoim potwierdzeniu Claude Code tworzy kody QR. Ponieważ każdy materiał reklamowy ma własny kod QR, później w Same-QR i w analityce internetowej zobaczysz, który nośnik był używany i jak często. Pliki do druku jako SVG lub PDF pobierzesz z panelu.

Uprawnienia i kontrola

• Przy zmianach w wydrukowanych kodach QR zawsze najpierw poproś o listę.
• Zmiana celów i usuwanie wymagają potwierdzenia z odczytanym stanem, najwyżej 10 na godzinę. Potwierdzaj tylko świadomie.
• Jeśli z zadania ma powstać powtarzalny proces, poproś Claude Code o skrypt z sameqr-CLI.
• Odwołaj klucz, gdy projekt zostanie zakończony.

Podsumowanie: dlaczego Same-QR

Same-QR pasuje do Claude Code jak wbudowane narzędzie: jedno polecenie do konfiguracji, wszystkie funkcje panelu jako narzędzia MCP, klucze tylko do odczytu, które ukrywają narzędzia zapisujące, i dokumentacja zrozumiała dla agenta. W każdym planie, także w bezpłatnym.

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