# Storelift MCP sunucusunu Claude Code'a ekle

URL: https://storelift.net/tr/rehber/storelift-mcp-claude-code/
Language: tr
Updated: 2026-10-11

Storelift MCP sunucusunu Claude Code'a bağlamanın adımları; sürüm, gereksinim ve hata cevapları sunucunun kendisinden ölçüldü.

## Bu rehber nasıl doğrulandı

NOTE: Nasıl doğrulandı (2026-10-11). Sunucu tarafı storelift-mcp 1.1.1 ile ölçüldü: el sıkışma, araç listesi, okuma çağrıları, hata cevapları ve erişimin kaldırılması. Claude Code tarafında görülenler: 2.1.296 · stdio, API anahtarı: bağlandı, 8 aracı listeledi, kaldırma komutuyla temiz söküldü; 2.1.296 · Streamable HTTP, başlıkta API anahtarı: bağlandı, 8 aracı listeledi. Claude Code içinden bir araç çağrısı denenmedi; aşağıdaki adımlar istemcinin kendi belgesine göre yazıldı.

İ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ü

| Gördüğün | Nedeni | Ne yapmalı |
| --- | --- | --- |
| “No API key was sent…” | Yerel sunucu anahtarsız başladı. Araçlar listelenir ama her çağrı bu hatayı verir. | STORELIFT_API_KEY değişkenini sunucunun yapılandırmasına ekle ve istemciyi yeniden başlat. |
| “This API key is not valid…” | Anahtar yanlış yazılmış ya da silinmiş. Barındırılan uç HTTP 401 döner. | Ayarlar → API anahtarları'nda yeni bir anahtar oluştur ve yapılandırmadakini değiştir. |
| “The Public API is available on the Pro and Studio plans…” | Hesabın planı MCP erişimini açmıyor (HTTP 403). Bu sürümde erişim Pro, Studio veya Enterprise planında. | Planı storelift.net/pricing'den yükselt; anahtar silinmez, plan açılınca aynı anahtar çalışır. |
| “fetch failed…” | Yerel sunucu Storelift'e ulaşamadı: ağ, vekil sunucu ya da güvenlik duvarı. | Bu makineden https://storelift.net adresine çıkışı kontrol et; STORELIFT_API değişkenini yalnız kendi uç adresin varsa ayarla. |
| claude mcp list içinde ✘ Failed to connect | Sunucu başlamadı (Node.js yok ya da eski) ya da uç zamanında cevap vermedi. | node --version ile bak; yavaş açılışta başlangıç süresini artır, ör. MCP_TIMEOUT=10000 claude. |