Geliştiriciler · MCP

QuvtyQR'ı yapay zekâ asistanınıza bağlayın

QuvtyQR herkese açık bir Model Context Protocol (MCP) sunucusu çalıştırır. Asistanınıza tek bir URL ekleyin; yayındaki her QuvtyQR menüsünü okuyabilsin: yemekler, fiyatlar, alerjenler, besin değerleri ve diller.

Sunucu URL'si

https://quvtyqr.com/mcp

Salt-okunur
Giriş veya API anahtarı gerekmez
Streamable HTTP, durumsuz

Nedir?

MCP, yapay zekâ asistanlarının harici servislerdeki araçları çağırmasını sağlayan açık bir standarttır. QuvtyQR MCP sunucusu iki araç sunar. Kurulacak bir şey yok, hesap da gerekmez: asistanınız sunucu URL'sine istek gönderir ve yapılandırılmış veri alır.

Asistanınız bununla neler yapabilir?

Bir restoranın yayındaki menüsünü slug'ıyla okuyup size özetler.
Yemeklerle ilgili soruları yanıtlar: içindekiler, vegan veya vejetaryen seçenekler, kalori ve makrolar.
Fiyatları ve güncel kampanya indirimlerini menünün para biriminde kontrol eder.
Alerjenlere göre süzer; ör. glüten veya kuruyemiş içermeyen yemekleri bulur.
Menüyü işletmenin sunduğu başka bir dilde okur.
QuvtyQR'ın ne olduğunu ve Başlangıç ile Business planlarının farkını anlatır.

Bilmeniz gerekenler

Yalnızca yayındaki menüleri okur. Hiçbir şey oluşturamaz, düzenleyemez veya silemez. Sipariş, menü değişikliği ya da hesap erişimi yoktur.
Bazı veriler bilinçli olarak gizli kalır: işletme fiyatları veya alerjenleri gizlediyse sunucu da bunları göstermez. Yalnızca mekândaki QR kod okutularak açılabilen menülere erişilemez.
İstekler sınırlıdır (IP başına dakikada 60).
Kendi menünüzü yapay zekâ asistanından yönetmek ileride gelecek.

Araçlar

`get_menu`

Bir işletmenin herkese açık QR menüsünü döndürür: kategoriler, ürünler, fiyatlar (kampanya indirimleri uygulanmış), alerjen ve içerik etiketleri, besin değerleri, aktif kampanyalar ve adres, çalışma saatleri, menü bağlantısı gibi işletme bilgileri.

Parametreler

slug string: Zorunlu. İşletmenin slug'ı, yani menü adresindeki alt alan adı.
language string?: İsteğe bağlı. Menü dil kodu (ör. en, tr, de). Menü o dili sunmuyorsa varsayılan dili kullanılır.

`get_service_info`

QuvtyQR'ın ne olduğunu, planlarını (Başlangıç ve Business) ve sitenin makine-okunur kaynaklarının bağlantılarını döndürür.

Parametreler

Parametre yok.

Slug nasıl bulunur?

Her QuvtyQR menüsü https://<slug>.quvtyqr.com adresinde yayınlanır. Slug bu adresin ilk kısmıdır (https://cafe-luna.quvtyqr.com için cafe-luna). Asistanınıza doğrudan menü bağlantısını da verebilirsiniz.

Asistanınızı bağlayın

Uygulamanızı seçin. Tüm istemciler aynı sunucu URL'sini kullanır; kimlik doğrulama gerekmez.

claude.ai'yi veya Claude masaüstü uygulamasını açıp Ayarlar → Bağlayıcılar (Connectors) bölümüne gidin.
"Özel bağlayıcı ekle" (Add custom connector) seçeneğini seçin.
Adını QuvtyQR koyun, aşağıdaki sunucu URL'sini yapıştırıp ekleyin. Kimlik doğrulama alanlarını boş bırakın.
Sunucu URL'si
```
https://quvtyqr.com/mcp
```
Sohbette araçlar menüsünden QuvtyQR bağlayıcısını açın ve bir menü hakkında soru sorun.

Terminalinizde şu komutu çalıştırın:

Terminal

claude mcp add --transport http quvtyqr https://quvtyqr.com/mcp

claude mcp list ile ya da Claude Code içinde /mcp yazarak kontrol edin.

Projenizde .cursor/mcp.json dosyasını (tüm projeler için ~/.cursor/mcp.json) şu içerikle oluşturun:
.cursor/mcp.json
```
{
  "mcpServers": {
    "quvtyqr": {
      "url": "https://quvtyqr.com/mcp"
    }
  }
}
```
Cursor Ayarları → MCP bölümünde quvtyqr'ın etkin olduğundan emin olun.

Çalışma alanınızda .vscode/mcp.json dosyasını şu içerikle oluşturun:

.vscode/mcp.json

{
  "servers": {
    "quvtyqr": {
      "type": "http",
      "url": "https://quvtyqr.com/mcp"
    }
  }
}

Sunucuyu dosyanın içinden (veya "MCP: List Servers" komutuyla) başlatın, ardından Copilot Chat'in ajan modunda kullanın.

ChatGPT ayarlarında uygulamalar/bağlayıcılar için geliştirici modunu açın (desteklenen planlarda).
Yeni bir özel bağlayıcı oluşturup aşağıdaki sunucu URL'sini yapıştırın. Kimlik doğrulama olarak "yok"u seçin.
Sunucu URL'si
```
https://quvtyqr.com/mcp
```
Bir sohbette etkinleştirip menü hakkında soru sorun. ChatGPT'deki menü adları sık değişir; "connectors" veya "apps" başlıklarına bakın.

Streamable HTTP aktarımını destekleyen her MCP istemcisi bağlanabilir. Sunucu URL'sini girin:
Sunucu URL'si
```
https://quvtyqr.com/mcp
```

Pek çok istemci aşağıdaki gibi bir JSON yapılandırması kabul eder. Yalnızca yerel (stdio) sunucuları destekleyen istemciler mcp-remote gibi bir köprü kullanabilir.

mcp.json

{
  "mcpServers": {
    "quvtyqr": {
      "type": "http",
      "url": "https://quvtyqr.com/mcp"
    }
  }
}

stdio · mcp-remote

{
  "mcpServers": {
    "quvtyqr": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://quvtyqr.com/mcp"
      ]
    }
  }
}

Bu komutları deneyin

cafe-luna yerine gerçek bir QuvtyQR menüsünün slug'ını yazın.

QuvtyQR'daki cafe-luna menüsünde hangi vegan yemekler var?
cafe-luna menüsünü Türkçe göster ve en ucuz üç ana yemeği listele.
cafe-luna'daki hangi tatlılar glüten ve kuruyemiş içermiyor?
cafe-luna şu an açık mı, güncel kampanyaları neler?
cafe-luna'da 100 kaloriden az hangi içecekler var?

Ham JSON-RPC (geliştiriciler için)

Sunucu, HTTP POST üzerinden JSON-RPC 2.0 konuşur. Her istek bağımsızdır ve oturum kimliği gerekmez. Her yanıt tek bir JSON gövdesidir.

1. Başlat (initialize)

curl -s https://quvtyqr.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

2. Araçları listele

curl -s https://quvtyqr.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

3. get_menu çağır

curl -s https://quvtyqr.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_menu","arguments":{"slug":"cafe-luna","language":"en"}}}'

Desteklenen protokol sürümleri: 2025-06-18 (en güncel), 2025-03-26 ve 2024-11-05. Sunucu SSE akışı açmadığından GET istekleri 405 döner.

Kaynaklar

Menünüz yapay zekâ tarafından okunabilir

Menünüzü QuvtyQR'da yayınlayın; bu sunucuya bağlı asistanlar misafirlerinizin menünüzle ilgili sorularını yanıtlayabilsin.

Ücretsiz başla