Storelift를 Claude에 커스텀 커넥터로 연결하기

이 가이드를 확인한 방법

Claude 문서: support.claude.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_로 시작합니다. 이 릴리스의 키에는 스코프가 없습니다. 키 하나가 워크스페이스의 모든 앱을 읽습니다. 키는 클라이언트 설정에만 보관하세요.
• Claude. 커스텀 커넥터는 Claude의 Free, Pro, Max, Team, Enterprise 플랜에서 쓸 수 있습니다. Free는 커스텀 커넥터가 하나로 제한되고, Team에서는 소유자(Owner)만 추가할 수 있습니다. Claude에 추가한 커넥터는 Claude Desktop에서도 쓸 수 있습니다.

설정 방법

1. Claude에서 Customize → Connectors를 열고 + Add를 누른 다음 Add custom connector를 선택하세요. Team과 Enterprise에서는 소유자가 Organization settings → Connectors → Add → Custom → Web으로 들어갑니다.
2. 이름에 Storelift, URL에 https://storelift.net/mcp를 입력하고 저장하세요.
3. Connect를 누르세요. Claude가 Storelift 페이지로 보내 주며, 이 페이지에는 접근을 요청하는 앱과 돌아갈 주소가 표시됩니다. 필요하면 로그인한 뒤 허용하세요.
4. 새 채팅을 열고 도구 메뉴에서 Storelift가 켜져 있는지 확인하세요. list_apps를 비롯한 도구들이 목록에 나옵니다.

Claude에서는 고정 헤더(API 키)로 커넥터를 추가할 수도 있습니다. 다만 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. Claude에서 Customize → Connectors를 열고 Storelift 옆의 Remove를 선택하세요(Team과 Enterprise에서는 소유자가 Organization settings에서 제거합니다).
2. Storelift → 설정 → API 키에서 키를 삭제하세요. 그 키로 보내는 다음 요청부터 거부됩니다(로컬 서버에서는 도구 오류, 호스팅 엔드포인트에서는 HTTP 401). 끝나기를 기다려야 하는 열린 세션은 없습니다.
3. 로그인(OAuth)으로 연결했다면 설정 → API → 연결된 앱에서 연결을 제거하세요. 그 연결의 토큰은 다음 요청에서 401을 받습니다.

문제 해결

다음 읽을거리