MCP Sunucu — Kullanıcı Kılavuzu

Nedir Bu?

MCP sunucusu (Model Context Protocol) masamenu.tr için, AI asistanlarını (Claude, ChatGPT, Cursor, VS Code Copilot ve diğerleri) restoranınızın verilerine bağlamanızı sağlar. AI, menü, lokasyonlar, siparişler, görseller gibi verilere erişebilir ve bunları sizin adınıza yönetebilir.

Hızlı Başlangıç

1. API Anahtarı Alın

API anahtarı, restoranınızın yönetim panelinde oluşturulur.

Adım adım:

1. admin.masamenu.tr adresinden Yönetim Paneli'ne giriş yapın
2. Yan menüden ⚙️ Ayarlar → 🔑 Erişim'i açın
3. Sayfada 🤖 MCP API Anahtarları bölümünü bulun
4. «Yeni anahtar oluştur» butonuna tıklayın
5. Anahtar adı girin (örneğin, «Claude Desktop», «Cursor», «Benim GPT») — bu, anahtarları birbirinden ayırt etmenize yardımcı olur
6. Anahtarı hemen kopyalayın — sadece bir kez gösterilir!

💡 Aynı sayfada Sunucu URL'si (https://api.masamenu.tr/mcp) de görüntülenir ve tek tıklamayla kopyalanabilir.

Anahtar Yönetimi

• Hesap başına 10 anahtar oluşturabilirsiniz
• Her anahtar herhangi bir zamanda iptal edilebilir — anahtarın yanındaki «İptal Et» butonu
• İptal edildikten sonra anahtar hemen çalışmayı durdurur
• Anahtar kaybolursa — iptal edin ve yenisini oluşturun

2. AI Asistanını Bağlayın

Claude Desktop / Claude Code

claude_desktop_config.json yapılandırma dosyası:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.masamenu.tr/mcp",
      "headers": {
        "Authorization": "Bearer SİZİN_API_ANAHTARINIZ"
      }
    }
  }
}

Cursor

Cursor ayarlarında → MCP Servers → Add, veya .cursor/mcp.json dosyası:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.masamenu.tr/mcp",
      "headers": {
        "Authorization": "Bearer SİZİN_API_ANAHTARINIZ"
      }
    }
  }
}

VS Code (GitHub Copilot)

Projedeki .vscode/mcp.json:

{
  "servers": {
    "meni": {
      "type": "http",
      "url": "https://api.masamenu.tr/mcp",
      "headers": {
        "Authorization": "Bearer SİZİN_API_ANAHTARINIZ"
      }
    }
  }
}

Diğer AI Araçları

Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Continue, ChatGPT ve diğerleri için ayrıntılı adım adım talimatlar:

👉 AI Araçlarını MCP'ye Bağlama

AI Asistanı Ne Yapabilir?

Restoran Sahipleri İçin (normal kullanıcılar)

Kullanıcı Profilleri

Lokasyonlarla Çalışma

Menü ile Çalışma

Siparişler

Domainler

CDN (yayınlanmış veriler)

Görseller

S3'e Düşük Seviyeli Erişim

Cognito

İstatistik

Kimlik Doğrulama

Sunucu üç tür yetkilendirme yöntemi destekler:

1. API Anahtarı (AI asistanları için önerilir)

Authorization: Bearer sizin_64_karakterli_anahtarınız

Anahtar, yönetim panelinde oluşturulur. Hesabınıza bağlıdır — AI sadece sizin verilerinizi görür.

2. Cognito JWT Token

Programatik entegrasyon için giriş yaparak token alabilirsiniz:

# Token al
curl -X POST https://api.masamenu.tr/mcp/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "sizin@email.com", "password": "sizin_şifreniz"}'

# Yanıt idToken içerir — bunu kullanın:
Authorization: Bearer eyJraWQ...

Token 1 saat geçerlidir, ardından tekrar giriş yapılması gerekir.

3. Admin API Anahtarı (sadece yöneticiler için)

Authorization: Bearer admin_key

Yönetici anahtarı, tüm kullanıcıların tüm verilerine tam erişim sağlar.

Güvenlik

• Her API anahtarı belirli bir hesaba bağlıdır
• Normal kullanıcılar sadece kendi verilerini görür
• Anahtar, yönetim panelinde herhangi bir zamanda iptal edilebilir
• Hesap başına maksimum 10 anahtar
• Tüm istekler HTTPS üzerinden yapılır
• [ADMIN] etiketi olan komutlar normal kullanıcılara kapalıdır

Kullanım Örnekleri

AI'dan bir yemeğin fiyatını güncellemesini istemek

«Menümdeki «Haçapuri» pozisyonunun fiyatını güncelle — 12 lari yerine 15 lari yap»

AI, my_locations → get_location_menu → update_menu_item komutlarını çağırır.

Menüye yeni bir pozisyon eklemek

«Tatlılar kategorisine 8 lari fiyatla yeni bir yemek «Çurçhela» ekle»

AI, my_locations → get_location_menu → create_menu_item komutlarını çağırır.

Yeni bir kategori oluşturmak

«Gürcüce ve İngilizce çevirileriyle «İçecekler» kategorisi oluştur»

AI, create_menu_category komutunu nameTranslations ile çağırır.

Bir yemeği kategoriler arasında taşımak

««Limonata»yı «Soğuk İçecekler»den «Alkolsüz»e taşı»

AI, move_menu_item komutunu kaynak ve hedef kategoriyi belirterek çağırır.

Bugünkü siparişleri görmek

«Bugünkü siparişlerimi göster»

AI, my_orders komutunu çağırır ve tarihe göre filtreler.

Yayınlanmış menüyü kontrol etmek

«Ziyaretçiler için menüm Rusça dilinde nasıl görünüyor?»

AI, resolve_domain → get_cdn_menu komutlarını ru diliyle çağırır.

Restoranın domainini değiştirmek

«my-restaurant domaini müsait mi kontrol et, eğer öyleyse ayarla»

AI, check_domain_availability → set_location_domain komutlarını çağırır.

Yemek fotoğrafı yüklemek

«X yemeği için fotoğraf yükleme bağlantısı ver»

AI, get_image_upload_url komutunu çağırır ve yükleme için presigned URL döner.

API Uç Noktaları

Anahtar Yönetimi

Anahtarları Görüntüleme

Yönetim panelinde → Ayarlar → Erişim → MCP API Anahtarları. Veya API üzerinden:

curl https://api.masamenu.tr/mcp/api/keys \
  -H "Authorization: Bearer COGNITO_JWT_TOKEN"

Anahtar Oluşturma

curl -X POST https://api.masamenu.tr/mcp/api/keys \
  -H "Authorization: Bearer COGNITO_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Claude Desktop"}'

Yanıt key alanını içerir — bu sizin anahtarınızdır. Kaydedin!

Anahtar İptali

curl -X DELETE https://api.masamenu.tr/mcp/api/keys/mk_abc123 \
  -H "Authorization: Bearer COGNITO_JWT_TOKEN"

⚠️ Anahtar oluşturma ve iptal etme, Cognito JWT token gerektirir (API anahtarı değil). Yönetim panelini kullanın — daha kolaydır.

Sorun Giderme