Cursor에 Storelift MCP 서버 추가하기

이 가이드를 확인한 방법

Cursor 문서: cursor.com.

버전

이 가이드는 현재 운영 중인 서버를 설명합니다. npm의 storelift-mcp 1.1.1(2026-09-14), 그리고 호스팅 엔드포인트 https://storelift.net/mcp입니다. 둘 다 같은 도구 8개를 제공합니다: get_ai_visibility, get_charts, get_history, get_keywords, get_reviews, get_rivals, get_store_page, list_apps.

이 릴리스의 도구는 모두 읽기 도구이며, 계정의 어떤 것도 변경하지 않습니다. 프로토콜 버전은 로컬 서버(stdio)가 2024-11-05, 호스팅 엔드포인트(Streamable HTTP)가 2025-06-18입니다. 엔드포인트는 상태를 저장하지 않으며, 세션 ID도 서버가 보내는 스트림도 없습니다.

요구 사항

• 플랜. MCP 접근에는 Pro, Studio 또는 Enterprise 플랜이 필요합니다. API 키를 쓰든 로그인(OAuth)을 쓰든 같습니다.
• 키. Storelift → 설정 → API 키. 키는 sl_live_로 시작합니다. 이 릴리스의 키에는 스코프가 없습니다. 키 하나가 워크스페이스의 모든 앱을 읽습니다. 키는 클라이언트 설정에만 보관하세요.
• 실행 환경. 로컬 서버에는 Node.js 18 이상이 필요합니다(npx가 첫 실행 때 패키지를 내려받습니다). 호스팅 엔드포인트는 설치할 것이 없습니다.
• Cursor. 에디터와 Cursor CLI는 같은 mcp.json을 읽습니다. 프로젝트 하나에는 .cursor/mcp.json, 모든 프로젝트에는 ~/.cursor/mcp.json입니다.

설정 방법

API 키를 쓰는 로컬 서버입니다. .cursor/mcp.json에 다음을 추가하세요:

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

또는 로그인(OAuth)을 쓰는 호스팅 엔드포인트입니다. 로그인을 요구하는 서버라면 Cursor가 브라우저에서 로그인 화면을 엽니다.

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

Cursor는 기본적으로 MCP 도구를 쓰기 전에 승인을 요청합니다. 명령줄에서는 cursor-agent mcp list-tools storelift로 연결을 확인하고 도구와 인수 목록을 볼 수 있습니다.

첫 조회

이렇게 물어보세요: “내 Storelift 앱 목록을 보여 주고, 첫 번째 앱의 미국 키워드 순위를 알려 줘.” 어시스턴트는 먼저 list_apps를 호출하고, 이어서 내가 고른 앱에 대해 get_keywords를 호출합니다. list_apps 응답은 다음과 같습니다(Storelift 샘플 데이터, 2026-09-28. 내 계정에서는 내 앱이 반환됩니다):

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

get_keywords는 추적 중인 키워드마다 한 행을 반환합니다:

{
  "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에 숫자가 있으면 그 값이 순위입니다. null은 키워드를 측정했지만 앱이 결과에 없다는 뜻이고, measured: false는 측정하지 못했다는 뜻입니다. 이 셋은 구분해서 다뤄야 합니다. 측정되지 않은 날을 0으로 세면 틀린 답이 나옵니다.

연결이 작동합니다. 다음은 첫 작업 세 가지입니다. 어떤 키워드가 떨어졌는지, 그 키워드에서 누가 앞서 있는지, 오늘 측정이 없는 키워드는 어떻게 답해야 하는지를 기대되는 답과 함께 다룹니다.

접근 권한 제거

1. Cursor의 Customize에서 서버를 끄거나 제거하세요. mcp.json에서 storelift 항목을 삭제해도 됩니다. CLI에서는 cursor-agent mcp disable storelift로 서버가 로드되지 않게 할 수 있습니다.
2. Storelift → 설정 → API 키에서 키를 삭제하세요. 그 키로 보내는 다음 요청부터 거부됩니다(로컬 서버에서는 도구 오류, 호스팅 엔드포인트에서는 HTTP 401). 끝나기를 기다려야 하는 열린 세션은 없습니다.
3. 로그인(OAuth)으로 연결했다면 설정 → API → 연결된 앱에서 연결을 제거하세요. 그 연결의 토큰은 다음 요청에서 401을 받습니다.

문제 해결

다음 읽을거리