Storelift MCP sunucusunu Cursor'a ekle

Bu rehber nasıl doğrulandı

İstemcinin belgesi: cursor.com.

Sürüm

Bu rehber yayındaki sunucuyu anlatıyor: npm'de storelift-mcp 1.1.1 (2026-09-14) ve barındırılan uç https://storelift.net/mcp, ikisi de aynı 8 araçla: get_ai_visibility, get_charts, get_history, get_keywords, get_reviews, get_rivals, get_store_page, list_apps.

Bu sürümün araçlarının hepsi okuma aracı; hesabında hiçbir şeyi değiştirmez. Yerel sunucu stdio üzerinden 2024-11-05, barındırılan uç Streamable HTTP üzerinden 2025-06-18 protokol sürümüyle cevap veriyor; uç durumsuz, oturum kimliği ve sunucudan akış (SSE) kullanmıyor.

Gereksinim

• Plan. MCP erişimi Pro, Studio veya Enterprise planında açık; bu hem API anahtarı hem giriş (OAuth) için geçerli.
• Anahtar. Storelift → Ayarlar → API anahtarları. Anahtar sl_live_ ile başlıyor. Bu sürümün anahtarları kapsam taşımıyor: bir anahtar çalışma alanındaki bütün uygulamaları okur. Anahtarı yalnız istemcinin yapılandırmasında tut.
• Çalışma ortamı. Yerel sunucu için Node.js 18 veya üstü (npx paketi ilk çalıştırmada indirir). Barındırılan uç kurulum istemiyor.
• Cursor. Editör ve Cursor CLI aynı mcp.json dosyasını okuyor: projede .cursor/mcp.json, her proje için ~/.cursor/mcp.json.

Kurulum

Yerel sunucu, API anahtarıyla — .cursor/mcp.json dosyasına ekle:

{
  "mcpServers": {
    "storelift": {
      "command": "npx",
      "args": [
        "-y",
        "storelift-mcp"
      ],
      "env": {
        "STORELIFT_API_KEY": "sl_live_..."
      }
    }
  }
}

Ya da barındırılan uç, giriş (OAuth) ile: Cursor giriş isteyen sunucuda tarayıcıda giriş açıyor.

{
  "mcpServers": {
    "storelift": {
      "url": "https://storelift.net/mcp"
    }
  }
}

Cursor araçları kullanmadan önce varsayılan olarak onay ister. Bağlantıyı komut satırından cursor-agent mcp list-tools storelift ile kontrol edebilirsin; araçlar argümanlarıyla listelenir.

İlk okuma

Şunu sor: “Storelift'teki uygulamalarımı listele, sonra ilkinin ABD'deki kelime sıralarını göster.” Asistan önce list_apps çağırır, sonra seçtiğin uygulama için get_keywords. list_apps cevabı şu biçimde (Storelift örnek veri seti, 2026-09-28; kendi hesabın kendi uygulamalarını döndürür):

{
  "apps": [
    {
      "id": "sbx-lumen",
      "name": "Lumen — Sleep Sounds",
      "countries": [
        "us",
        "gb",
        "de"
      ],
      "keywords": [
        "sleep sounds",
        "white noise",
        "rain sounds"
      ]
    }
  ]
}

get_keywords her izlenen kelime için bir satır döndürür:

{
  "country": "us",
  "platform": "ios",
  "keywords": [
    {
      "term": "sleep sounds",
      "measured": true,
      "rank": null,
      "demand": 73,
      "searchDepth": 200
    },
    {
      "term": "white noise",
      "measured": true,
      "rank": 57,
      "demand": 37,
      "searchDepth": 200
    }
  ]
}

rank sayıysa sıra odur; null ise kelime ölçüldü ama uygulama sonuçlarda yok; measured: false ise o kelime ölçülemedi. Üçü ayrı hâl: ölçülemeyen bir günü sıfır saymak yanlış cevap üretir.

Bağlantı çalışıyor. Sıradaki adım ilk üç görev: hangi kelimelerde düştün, o kelimelerde kim önünde, bir kelimenin bugünkü ölçümü yoksa ne söylenir; her biri beklenen cevabıyla.

Erişimi kaldırma

1. Cursor'da sunucuyu Customize altında kapat ya da kaldır, veya storelift girdisini mcp.json'dan sil. CLI'dan cursor-agent mcp disable storelift yüklenmesini durdurur.
2. Storelift → Ayarlar → API anahtarları'nda anahtarı sil. Silinen anahtarla gelen bir sonraki istek reddedilir (yerel sunucuda araç hatası, barındırılan uçta HTTP 401); açık bir oturumun kapanmasını beklemek gerekmiyor.
3. Giriş (OAuth) ile bağlandıysan bağlantıyı Ayarlar → API → Bağlı uygulamalar'dan kaldır; o bağlantının jetonu bir sonraki istekte 401 alır.

Hata çözümü

Devamı