Storelift MCP sunucusunu Claude Code'a ekle

Bu rehber nasıl doğrulandı

İstemcinin belgesi: code.claude.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.
• Claude Code. Güncel bir sürüm; aşağıdaki komutlar claude mcp add --help çıktısından ve Claude Code'un MCP belgesinden.

Kurulum

Yerel sunucu, API anahtarıyla (proje dizininde çalıştır; varsayılan kapsam yalnız bu proje):

claude mcp add storelift -e STORELIFT_API_KEY=sl_live_... -- npx -y storelift-mcp

Ya da kurulumsuz barındırılan uç, anahtar başlıkta:

claude mcp add --transport http storelift https://storelift.net/mcp --header "Authorization: Bearer sl_live_..."

Anahtar yerine giriş (OAuth) için ucu başlıksız ekle, sonra Claude Code içinde /mcp komutuyla giriş yap:

claude mcp add --transport http storelift https://storelift.net/mcp

Bağlantıyı claude mcp list ile kontrol et; satırda ✔ Connected görünmeli.

İ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. claude mcp remove storelift komutunu çalıştır. Giriş (OAuth) bağlantısında Claude Code sakladığı jetonları da siliyor; sunucuyu silmeden aynı işi /mcp → Clear authentication yapıyor.
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ı