MCP server za QR kodove: korištenje Same-QR u Claudeu, ChatGPT-u, Cursoru i Codexu

Šta je MCP server

MCP je skraćenica za Model Context Protocol, otvoreni standard za povezivanje AI asistenata s drugim uslugama. MCP server opisuje alate neke usluge, na primjer „napravi QR kod“ ili „pročitaj statistiku“. Asistent vidi te alate i poziva ih kad ih zadatak traži.

Šta nudi Same-QR MCP server

Server 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, da asistent zna šta je moguće.
• Nabrajanje, čitanje, pravljenje, mijenjanje i brisanje QR kodova te pregled njihove statistike.
• Pravljenje, čitanje, mijenjanje, objavljivanje, isključivanje i brisanje gostujućih stranica, uz spisak dizajna.
• Učitavanje jelovnika i cjenovnika iz fotografija ili PDF-a.
• Upravljanje oznakama i projektima klijenata te čitanje upita iz kontakt formulara.

Alati za čitanje označeni su kao takvi, alati za brisanje kao konačni. Ko želi promijeniti ciljeve, isključiti stranicu ili je izbrisati, mora pitati korisnika i poslati prethodno pročitano stanje. Preko API-ja i MCP-a od toga je moguće najviše 10 na sat.

Dva načina prijave

ChatGPT i Claude.ai dodaju server kao konektor. Prijava ide preko OAuth-a: prijaviš se u pregledniku na Same-QR i kvačicom određuješ smije li aplikacija samo čitati, također praviti i mijenjati tekstove ili dodatno mijenjati ciljeve i brisati.

Claude Code, Cursor i Codex povezuju se API ključem. Napraviš ga na kontrolnoj tabli pod Račun, „Pristup za CLI, skripte i agente“, izabereš „samo čitanje“, „čitanje + pisanje“ (pravljenje, mijenjanje naziva i tekstova) ili „potpuno“ (dodatno mijenjanje ciljeva, isključivanje, brisanje) i pohraniš ga kao varijablu okruženja SAMEQR_API_KEY. Ključ sa „samo čitanje“ ima lijep nusefekt: 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 unos 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"

Ko je instalirao komandnu liniju sameqr, te podatke u svakom trenutku dobije naredbom „sameqr mcp“. Svaku vezu prvo testiraj pitanjem za čitanje, na primjer „Koje QR kodove imam?“.

Sigurnost i prava

• Za asistente koji trebaju samo analizirati koristi ključ sa „samo čitanje“.
• Ključeve nikad ne upisuj u datoteke projekta, nego ih postavi kao varijablu okruženja.
• Prije promjena na odštampanim QR kodovima traži da ti se pokaže plan.
• Ključeve koji ti više ne trebaju opozovi na kontrolnoj tabli. Odmah postaju nevažeći.

Zaključak: Zašto Same-QR

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

Počni odmah: registruj se besplatno na sameqr.com, 20 dinamičnih QR kodova trajno je besplatno. API, CLI i MCP server dostupni su u svakom paketu, a dokumentacija je na sameqr.com/entwickler.

Često postavljana pitanja