QR kodlar için MCP sunucusu: Same-QR'ı Claude, ChatGPT, Cursor ve Codex ile kullan

MCP sunucusu nedir

MCP, yapay zeka asistanları ile diğer hizmetler arasındaki bağlantı için açık bir standart olan Model Context Protocol'ün kısaltmasıdır. Bir MCP sunucusu, bir hizmetin araçlarını tanımlar, örneğin “QR kod oluştur” ya da “İstatistik oku”. Asistan bu araçları görür ve bir görev gerektirdiğinde çağırır.

Same-QR MCP sunucusu neler sunar

Sunucu https://sameqr.com/api/mcp adresindedir ve REST API'nin araçlarının aynısını, aynı adlarla, aynı kontrollerle ve aynı tarife sınırlarıyla sunar:

• Hesabı ve tarifeyi sorgulama, böylece asistan nelerin mümkün olduğunu bilir.
• QR kodları listeleme, okuma, oluşturma, değiştirme, silme ve istatistiklerini alma.
• Misafir sayfalarını oluşturma, okuma, değiştirme, yayımlama, çevrimdışı alma ve silme, ayrıca tasarım listesi.
• Menüleri ve fiyat listelerini fotoğraflardan veya PDF'den okuma.
• Etiketleri ve müşteri projelerini yönetme ve iletişim formlarından gelen talepleri okuma.

Okuyan araçlar bu şekilde işaretlenir, silen araçlar geri alınamaz olarak. Hedefleri değiştirmek, bir sayfayı çevrimdışı almak veya silmek isteyen, kullanıcıya sormak ve önceden okuduğu durumu da göndermek zorundadır. API ve MCP üzerinden bunlardan saatte en fazla 10 yapılabilir.

İki tür giriş

ChatGPT ve Claude.ai sunucuyu bağlayıcı olarak ekler. Giriş OAuth ile yapılır: Tarayıcıda Same-QR'a giriş yaparsın ve bir kutuyla uygulamanın yalnızca okuyabileceğini, ayrıca oluşturup metinleri değiştirebileceğini ya da ek olarak hedefleri değiştirip silebileceğini belirlersin.

Claude Code, Cursor ve Codex bir API anahtarıyla bağlanır. Anahtarı panelde Hesap altında “CLI, betikler ve ajanlar için erişim” bölümünde oluşturursun, “yalnızca okuma”, “okuma + yazma” (oluşturma, ad ve metinleri değiştirme) veya “tam” (ek olarak hedefleri değiştirme, çevrimdışı alma, silme) seçeneğini belirlersin ve SAMEQR_API_KEY ortam değişkeni olarak kaydedersin. “Yalnızca okuma” anahtarının güzel bir yan etkisi var: Asistan yazan araçları hiç görmez.

Kuruluma genel bakış

Claude Code için terminalde tek bir komut yeterli:

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

Cursor için ~/.cursor/mcp.json dosyasında bir kayıt:

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

Codex için ~/.codex/config.toml dosyasında bir bölüm:

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

sameqr komut satırını kurmuş olan biri bu bilgileri istediği zaman “sameqr mcp” ile görebilir. Her bağlantıyı önce okuyan bir soruyla dene, örneğin “Hangi QR kodlarım var?”.

Güvenlik ve yetkiler

• Yalnızca değerlendirme yapacak asistanlar için “yalnızca okuma” anahtarı kullan.
• Anahtarı asla proje dosyalarına yazma, ortam değişkeni olarak ayarla.
• Basılı QR kodlarda değişiklik yapmadan önce planı göstermesini iste.
• Artık gerekmeyen anahtarları panelde iptal et. Bunlar hemen geçersiz olur.

Sonuç: Neden Same-QR

Same-QR bir avuç oyuncak işlev yerine eksiksiz bir MCP sunucusu sunar: QR kodlar, istatistik, menüler, misafir sayfaları, etiketler ve projeler, hem sohbet asistanları hem de kodlama ajanları için. Her tarifede dahildir, net yetkilerle ve panelde olduğu gibi aynı kontrollerle.

Hemen başla: sameqr.com adresinde ücretsiz kaydol, 20 dinamik QR kod kalıcı olarak ücretsizdir. API, CLI ve MCP sunucusu her tarifede vardır, dokümantasyon sameqr.com/entwickler adresindedir.

Sık sorulan sorular