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

URL: https://storelift.net/ko/guide/storelift-mcp-claude/
Language: ko
Updated: 2026-10-13

Storelift MCP 서버를 Claude에 연결하는 단계입니다. 버전, 요구 사항, 오류 응답은 서버에서 직접 측정했습니다.

## 이 가이드를 확인한 방법

NOTE: 확인한 방법(2026-10-11). 서버 쪽은 storelift-mcp 1.1.1에서 핸드셰이크, 도구 목록, 읽기 호출, 오류 응답, 접근 권한 제거를 측정했습니다. Claude에서 확인한 것: claude.ai custom connector · Streamable HTTP, 로그인: 연결됨, 도구 8개 나열. Claude 안에서의 도구 호출은 아직 시도하지 않았으며, 아래 단계는 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을 받습니다.

## 문제 해결

| 증상 | 원인 | 해결 방법 |
| --- | --- | --- |
| “This API key is not valid…” | 키를 잘못 입력했거나 키가 삭제됐습니다. 호스팅 엔드포인트는 HTTP 401로 응답합니다. | 설정 → API 키에서 새 키를 만들고, 클라이언트 설정에 넣어 둔 키를 새 키로 바꾸세요. |
| “The Public API is available on the Pro and Studio plans…” | 계정의 플랜으로는 MCP 접근이 열리지 않습니다(HTTP 403). 이 릴리스에서는 Pro, Studio 또는 Enterprise 플랜에서 접근할 수 있습니다. | storelift.net/pricing에서 업그레이드하세요. 키는 그대로 유지되며, 플랜이 허용하면 다시 작동합니다. |
| Add custom connector가 표시되지 않음 | Claude의 Free 플랜은 커스텀 커넥터가 하나로 제한되고, Team에서는 소유자만 커넥터를 추가할 수 있습니다. | 다른 커스텀 커넥터를 제거하거나, 소유자에게 Storelift를 추가해 달라고 요청하세요. |