Restomenum MCP Sunucusu — Kurulum & Kullanım

Restomenum geliştirici portalının uzak MCP sunucusuna Claude Code / Claude'dan OAuth ile bağlanma ve 22 araçla plugin oluşturma, sürüm yönetimi, fiyatlandırma ve özel UI tanımlama rehberi.

# Restomenum MCP Sunucusu — Kurulum & Kullanım

Restomenum (restoran menü/işletme platformu) geliştirici portalının **uzak MCP sunucusu**.
Bağlandığında Claude, senin adına Restomenum plugin'i oluşturabilir, sürüm çıkarabilir,
fiyatlandırma ve özel arayüz (sayfa/form/buton) tanımlayabilir — hepsi doğal dille,
portala tıklamadan.

- **Uç (endpoint):** `https://restomenum-developer-portal.white-firefly-095a.workers.dev/mcp`
- **Taşıma:** Streamable HTTP (uzak sunucu, kurulum gerektirmez)
- **Kimlik doğrulama:** OAuth 2.1 + PKCE — tarayıcıda Restomenum developer portal
  hesabınla giriş yaparsın; şifren Claude'a hiç geçmez, yalnızca sana özel bir
  yetki token'ı alınır. Erişimi istediğin an portaldan iptal edebilirsin.
- **Resmi doküman:** https://dev.restomenum.com/docs/mcp

---

## Claude Code'a bağlama

```bash
claude mcp add --transport http restomenum \
  https://restomenum-developer-portal.white-firefly-095a.workers.dev/mcp
```

Sonra:

1. Claude Code'u **yeniden başlat** (MCP sunucuları oturum başında yüklenir; `claude -c` ile konuşmana devam edebilirsin)
2. `/mcp` yaz → listeden **restomenum**'u seç → **Authenticate**
3. Açılan tarayıcıda Restomenum developer portal hesabınla giriş yapıp yetkiyi onayla

## Claude (web / masaüstü) tarafında

Ayarlar → **Connectors / Integrations** → **Add custom** → yukarıdaki MCP URL'ini
yapıştır → **Connect** → tarayıcıda giriş yap ve onayla.

---

## Sunulan araçlar (22)

**Okuma**

| Araç | Ne yapar |
|------|----------|
| `list_plugins` | Kendi plugin'lerini listeler (durum, son sürüm, secret durumu) |
| `get_plugin` | Tek plugin'in detayları |
| `list_versions` | Bir plugin'in sürümleri |
| `get_manifest` | Sürüm manifest'i |
| `get_catalog` | Katalog görünümü |

**Yaşam döngüsü**

| Araç | Ne yapar |
|------|----------|
| `create_plugin` | Yeni plugin kaydı oluşturur |
| `generate_client_secret` | Client secret üretir |
| `create_version` | Yeni sürüm açar |
| `validate_version` | Sürümü doğrular |
| `submit_version` | Sürümü incelemeye gönderir |

**İzinler & fiyatlandırma**

| Araç | Ne yapar |
|------|----------|
| `set_scopes` | Erişim kapsamlarını ayarlar |
| `set_events` | Dinlenecek olayları ayarlar |
| `set_capabilities` | Plugin yeteneklerini ayarlar |
| `set_pricing` | Fiyatlandırmayı ayarlar |
| `set_trial` | Deneme süresini ayarlar |

**Özel arayüz (custom UI)**

| Araç | Ne yapar |
|------|----------|
| `set_pages` | Plugin sayfalarını tanımlar |
| `set_settings_page` | Ayarlar sayfası |
| `set_nav` | Navigasyon öğeleri |
| `set_buttons` | Butonlar |
| `set_forms` | Formlar |
| `set_hooks` | Hook'lar |
| `set_action_url` | Aksiyon URL'i |

---

## Örnek kullanımlar

Bağlandıktan sonra doğal dille söylemen yeterli:

> "Restomenum'daki plugin'lerimi listele." → `list_plugins`
> "Stok takibi için yeni bir plugin oluştur, accounting kategorisinde." → `create_plugin`
> "Maliyet Defteri'ne bir sürüm aç, doğrula ve incelemeye gönder." → `create_version` → `validate_version` → `submit_version`
> "Plugin'e aylık fiyat ve 14 günlük deneme ekle." → `set_pricing` + `set_trial`

## Güvenlik

- OAuth 2.1 + PKCE: şifre paylaşımı yok; istekler senin JWT'inle çalışır ve
  yalnızca **kendi** plugin'lerine erişir.
- Yetkiyi dilediğin an developer portal üzerinden iptal edebilirsin.
- `generate_client_secret` çıktısı bir secret'tır — repoya koyma, güvenli sakla.