Shobi Docs

Shobi MCP Server

Mağaza verilerine erişimi olan authenticated MCP endpoint.

Shobi MCP Server, hesabına bağlı mağaza/reklam verilerine erişen authenticated bir MCP endpoint'idir. Sadece kendi org'una ait verilere erişebilir.

Endpoint

https://api.shobi.ai/mcp

JSON-RPC 2.0 + SSE (server-sent events) protokolü.

Authentication

Her istekte Authorization: Bearer <SHOBI_API_TOKEN> header'ı zorunludur.

Token'ı Dashboard → Ayarlar → API Token sayfasından oluştur. Token'lar org bazlı ve revoke edilebilir.

curl https://api.shobi.ai/mcp \
  -H "Authorization: Bearer shobi_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Yetki kapsamı

Token oluştururken yetki kapsamı seçilir:

  • read — Tüm get_* tool'ları (sipariş, satış, ürün, vs.)
  • execute — Shopify aksiyon tool'ları (shopify_execute_*)
  • admin — Tüm tool'lar + API token yönetimi

Varsayılan: read. Üretim kullanımında okuma yetkisi yeterlidir — yazma yetkisi sadece otomasyon için.

Rate limits

Planİstek/dakikaİstek/gün
Free trial305.000
Standart120100.000
Pro6001.000.000
EnterpriseÖzelÖzel

Rate limit aşıldığında HTTP 429 dönülür. Retry-After header'ı saniye cinsinden bekleme süresini söyler.

Veri yalıtımı

Token sadece kendi org'undaki veriye erişir — başka bir Shobi müşterisinin verisini göremezsin. Tüm tool çağrıları denetim günlüğüne kaydedilir.