MCP poslužitelj za QR kodove: korištenje Same-QR-a u Claudeu, ChatGPT-u, Cursoru i Codexu

Što je MCP poslužitelj

MCP je kratica za Model Context Protocol, otvoreni standard za povezivanje AI asistenata s drugim uslugama. MCP poslužitelj opisuje alate neke usluge, primjerice „Izradi QR kod“ ili „Pročitaj statistiku“. Asistent vidi te alate i poziva ih kad ih zadatak zahtijeva.

Što nudi MCP poslužitelj Same-QR-a

Poslužitelj se nalazi na https://sameqr.com/api/mcp i nudi upravo alate REST API-ja, s istim nazivima, provjerama i ograničenjima paketa:

• Upit o računu i paketu, kako bi asistent znao što je moguće.
• Popis, čitanje, izrada, mijenjanje i brisanje QR kodova te dohvat njihove statistike.
• Izrada, čitanje, mijenjanje, objava, isključivanje i brisanje gostujućih stranica, uz popis dizajna.
• Učitavanje jelovnika i cjenika iz fotografija ili PDF-a.
• Upravljanje oznakama i projektima klijenata te čitanje upita iz kontakt-obrazaca.

Alati koji samo čitaju označeni su kao takvi, a alati za brisanje kao konačni. Tko želi promijeniti odredišta, isključiti stranicu ili je obrisati, mora pitati korisnika i poslati prethodno pročitano stanje. Preko API-ja i MCP-a takvih je promjena najviše 10 na sat.

Dva načina prijave

ChatGPT i Claude.ai dodaju poslužitelj kao konektor. Prijava ide preko OAutha: prijaviš se u pregledniku na Same-QR i kvačicom određuješ smije li aplikacija samo čitati, također izrađivati i mijenjati tekstove ili dodatno mijenjati odredišta i brisati.

Claude Code, Cursor i Codex povezuju se API ključem. Izradiš ga na nadzornoj ploči pod Račun, „Pristup za CLI, skripte i agente“, odabereš „samo čitanje“, „čitanje + pisanje“ (izrada, mijenjanje naziva i tekstova) ili „potpuno“ (dodatno mijenjanje odredišta, isključivanje, brisanje) i pohraniš ga kao varijablu okruženja SAMEQR_API_KEY. Ključ s „samo čitanje“ ima lijepu nuspojavu: asistent tada uopće ne vidi alate za pisanje.

Postavljanje ukratko

Za Claude Code dovoljna je jedna naredba u terminalu:

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

Za Cursor jedan zapis u ~/.cursor/mcp.json:

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

Za Codex jedan odjeljak u ~/.codex/config.toml:

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

Tko je instalirao naredbeni redak sameqr, te podatke u svakom trenutku dobiva naredbom „sameqr mcp“. Svaku vezu prvo testiraj pitanjem koje samo čita, primjerice „Koje QR kodove imam?“.

Sigurnost i prava

• Za asistente koji trebaju samo analizirati koristi ključ s „samo čitanje“.
• Ključ nikad ne upisuj u datoteke projekta, nego ga postavi kao varijablu okruženja.
• Prije promjena na otisnutim QR kodovima neka ti asistent prikaže plan.
• Ključeve koji ti više ne trebaju opozovi na nadzornoj ploči. Tada odmah prestaju vrijediti.

Zaključak: zašto Same-QR

Same-QR nudi potpun MCP poslužitelj umjesto šačice igračkastih funkcija: QR kodove, statistiku, jelovnike, gostujuće stranice, oznake i projekte, jednako za chat asistente i agente za programiranje. Uključen je u svaki paket, s jasnim pravima i istim provjerama kao na nadzornoj ploči.

Kreni odmah: registriraj se besplatno na sameqr.com, 20 dinamičnih QR kodova trajno je besplatno. API, CLI i MCP poslužitelj dostupni su u svakom paketu, a dokumentacija je na sameqr.com/entwickler.

Često postavljana pitanja