Claude Code ve QR kodlar: Same-QR'ı MCP ile adım adım kur

Claude Code nedir

Claude Code, Anthropic'in bir kodlama ajanıdır. Terminalde veya geliştirme ortamında çalışır, dosyaları okur ve düzenler, komutlar yürütür. Model Context Protocol olan MCP üzerinden ayrıca başka hizmetlerin araçlarını kullanır. Same-QR'a bağlandığında hesabındaki QR kodlarını, konuk sayfalarını, menüleri, etiketleri ve müşteri projelerini düzenleyebilir.

Adım 1: API anahtarı oluştur

Same-QR panelinde Hesap bölümünü ve “CLI, betikler ve ajanlar için erişim” kısmını aç. Bir anahtar oluştur. Claude Code yalnızca değerlendirme yapacaksa “salt okunur” seç, o zaman ajan yazan araçları hiç görmez. Oluşturmak için “okuma + yazma” seç, mevcut QR kodlarının hedeflerini de değiştirecekse “tam” seç. Anahtar sqr_live_ ile başlar ve yalnızca bir kez gösterilir.

Adım 2: Anahtarı ortam değişkeni olarak ayarla

Anahtarı parola yöneticine kaydet ve SAMEQR_API_KEY ortam değişkeni olarak, örneğin kabuğu başlatırken, kullanıma sun. Proje dosyalarında yeri yok.

Adım 3: MCP sunucusunu ekle

Terminalde tek bir komut yeterli:

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

sameqr komut satırını kuran kişi bu satırı “sameqr mcp” ile de görebilir.

Adım 4: Bağlantıyı dene

Claude Code'u başlat ve önce hiçbir şeyi değiştirmeyen bir şey sor: “Same-QR'da hangi tarifem var ve hangi QR kodları mevcut?” Sunucu, ajanın tarifenin sınırlarını bilmesi için bu hesap sorgusuyla başlamasını önerir.

Adım 5: Kampanya sayfası için QR kodlar

Projede yeni bir açılış sayfası oluşurken tipik bir görev:

“Yeni /herbst sayfası için Same-QR'da üç dinamik QR kodu oluştur: afiş, broşür ve masa standı. Her birinin hedefine utm_source=qr ve ilgili mecra ile utm_medium ekle, hepsine Herbstaktion etiketini ver ve önce listeyi bana göster.”

Onayından sonra Claude Code QR kodlarını oluşturur. Her reklam malzemesinin kendi QR kodu olduğu için, hangi mecranın kaç kez kullanıldığını daha sonra Same-QR'da ve web analizinde görürsün. SVG veya PDF baskı dosyalarını panelden alırsın.

Yetkiler ve denetim

• Basılı QR kodlarda değişiklik yapmadan önce her zaman önce bir liste iste.
• Hedefleri değiştirmek ve silmek, okunan durumla bir onay gerektirir, saatte en fazla 10. Yalnızca bilinçli onayla.
• Görevin tekrarlanabilir bir akışa dönüşmesini istiyorsan, Claude Code'a sameqr CLI ile bir betik yazdır.
• Proje bittiğinde anahtarı iptal et.

Sonuç: Neden Same-QR

Same-QR, Claude Code'a yerleşik bir araç gibi uyar: kurulum için tek komut, panelin tüm işlevleri MCP araçları olarak, yazan araçları gizleyen okuma anahtarları ve bir ajanın anlayacağı bir belge. Her tarifede, ücretsiz olanda da.

Hemen başla: sameqr.com'da ücretsiz kaydol, 20 dinamik QR kodu kalıcı olarak ücretsiz. API, CLI ve MCP sunucusu her tarifede var, belgeler sameqr.com/entwickler adresinde.

Sık sorulan sorular