Serwer MCP dla kodów QR: Same-QR w Claude, ChatGPT, Cursorze i Codexie

Czym jest serwer MCP

MCP to skrót od Model Context Protocol, otwartego standardu połączenia między asystentami AI a innymi usługami. Serwer MCP opisuje narzędzia usługi, na przykład „utwórz kod QR“ albo „odczytaj statystyki“. Asystent widzi te narzędzia i wywołuje je, gdy potrzebuje ich do zadania.

Co udostępnia serwer MCP Same-QR

Serwer znajduje się pod adresem https://sameqr.com/api/mcp i oferuje dokładnie te narzędzia co API REST, z tymi samymi nazwami, kontrolami i limitami planów:

• Sprawdzanie konta i planu, aby asystent wiedział, co jest możliwe.
• Wyświetlanie, odczyt, tworzenie, zmienianie i usuwanie kodów QR oraz pobieranie ich statystyk.
• Tworzenie, odczyt, zmienianie, publikowanie, wyłączanie i usuwanie stron gościnnych, a do tego lista wzorów.
• Wczytywanie kart dań i cenników ze zdjęć lub z pliku PDF.
• Zarządzanie etykietami i projektami klientów oraz odczyt zapytań z formularzy kontaktowych.

Narzędzia tylko do odczytu są jako takie oznaczone, narzędzia usuwające jako ostateczne. Kto chce zmienić cele, wyłączyć stronę lub ją usunąć, musi zapytać użytkownika i przesłać wcześniej odczytany stan. Przez API i MCP można wykonać takich operacji najwyżej 10 na godzinę.

Dwa sposoby logowania

ChatGPT i Claude.ai dodają serwer jako konektor. Logowanie odbywa się przez OAuth: logujesz się w przeglądarce w Same-QR i za pomocą pól wyboru określasz, czy aplikacja może tylko czytać, także tworzyć i zmieniać teksty, czy dodatkowo zmieniać cele i usuwać.

Claude Code, Cursor i Codex łączą się za pomocą klucza API. Tworzysz go w panelu w sekcji Konto, „Dostęp dla CLI, skryptów i agentów“, wybierasz „tylko odczyt“, „odczyt + zapis“ (tworzenie, zmiana nazw i tekstów) albo „pełny“ (dodatkowo zmiana celów, wyłączanie, usuwanie) i zapisujesz go jako zmienną środowiskową SAMEQR_API_KEY. Klucz z opcją „tylko odczyt“ ma miły efekt uboczny: asystent w ogóle nie widzi wtedy narzędzi zapisujących.

Konfiguracja w skrócie

Dla Claude Code wystarczy jedno polecenie w terminalu:

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

Dla Cursora wpis w ~/.cursor/mcp.json:

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

Dla Codexa sekcja w ~/.codex/config.toml:

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

Kto zainstalował wiersz poleceń sameqr, zobaczy te dane w każdej chwili po wpisaniu „sameqr mcp“. Każde połączenie przetestuj najpierw pytaniem tylko do odczytu, na przykład „Jakie mam kody QR?“.

Bezpieczeństwo i uprawnienia

• Dla asystentów, które mają tylko analizować, używaj klucza z opcją „tylko odczyt“.
• Nigdy nie zapisuj klucza w plikach projektu, tylko ustaw go jako zmienną środowiskową.
• Przed zmianami w wydrukowanych kodach QR każ sobie pokazać plan.
• Niepotrzebne już klucze unieważnij w panelu. Przestają wtedy działać natychmiast.

Podsumowanie: dlaczego Same-QR

Same-QR oferuje pełny serwer MCP zamiast garstki zabawkowych funkcji: kody QR, statystyki, karty dań, strony gościnne, etykiety i projekty, jednakowo dla asystentów czatu i agentów programistycznych. Jest w każdym planie, z jasnymi uprawnieniami i tymi samymi kontrolami co w panelu.

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

Najczęściej zadawane pytania