# Storelift MCP sunucusunu Cursor'a ekle

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

Storelift MCP sunucusunu Cursor'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ı. Cursor tarafında görülenler: cursor-agent 2025.09.17-25b418f · stdio, API anahtarı: bağlandı, 8 aracı listeledi. Cursor içinden bir araç çağrısı denenmedi; aşağıdaki adımlar istemcinin kendi belgesine göre yazıldı.

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

| 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. |
| Authorization başlığını yazmana rağmen barındırılan uç giriş istiyor | Cursor CLI 2025.09.17 bağlanırken yapılandırmadaki başlığı göndermedi; uç 401 döndü ve giriş istedi. | Yerel sunucuyu kullan (anahtar env'de) ya da giriş yap. |