> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Aftersell MCP로 AI 클라이언트 연결하기

> Aftersell MCP 서버(Model Context Protocol)를 사용해 Claude Desktop 같은 AI 클라이언트를 스토어의 Aftersell 분석에 연결하세요.

MCP(Model Context Protocol)는 AI 클라이언트가 외부 도구에서 데이터를 읽을 수 있도록 하는 개방형 표준이에요. Aftersell은 AI 클라이언트에 스토어의 Aftersell 분석에 대한 읽기 전용 액세스를 제공하는 MCP 서버를 호스팅해요.

셀프 서비스 연결 페이지에서 Claude Desktop 같은 AI 클라이언트를 스토어의 Aftersell 분석에 연결할 수 있어요. 연결되면 스토어의 업셀 성과, 퍼널 결과 등에 대해 자연어로 직접 AI 클라이언트에게 질문할 수 있어요.

연결은 읽기 전용이에요: AI 클라이언트는 Aftersell 분석 데이터를 읽을 수 있지만 주문을 하거나 설정을 변경할 수 없어요. 개인 식별이 가능한 고객 필드는 차단돼요.

<div id="what-you-can-ask">
  ## 물어볼 수 있는 것
</div>

연결되면 AI 클라이언트에게 다음과 같은 질문을 할 수 있어요:

* 지난주 내 업셀이 추가로 얼마의 수익을 냈나요?
* 구매 후 성과에서 비슷한 스토어와 비교하면 어느 정도인가요?
* 이번 주 내 퍼널의 성과는 어떤가요?
* 오퍼 응답을 분석해 주세요 - 몇 개가 수락, 거절 또는 시간 초과됐나요?
* 왜 내 구매 후 오퍼가 더 많은 쇼핑객에게 표시되지 않나요?
* 지난달 어떤 업셀 상품이 가장 많은 수익을 냈나요?
* 활성 퍼널 중 어떤 것이 전환에서 저조한가요?
* 이번 달 내 스토어의 일별 주문 수와 평균 주문 금액은 얼마인가요?
* 기본 오퍼 단계와 두 번째 오퍼, 다운셀을 비교해 주세요 - 어떤 것이 가장 잘 전환되나요?
* 최근 내 업셀 전환율이 상승 추세인가요, 하락 추세인가요?
* 지난 2주간 매일 몇 명이 내 구매 후 오퍼를 봤나요?
* 방문자당 수익이 비슷한 스토어와 비교하면 어떤가요?
* 주문 #1234를 추적해 주세요 - 쇼핑객이 오퍼를 봤나요?

<div id="connecting-your-ai-client">
  ## AI 클라이언트 연결하기
</div>

연결 페이지는 **Choose your AI client**로 시작하며, **Claude Desktop**, **Claude Code**, **Codex App**, **Codex CLI** 중에서 선택할 수 있어요. 아래 단계는 선택에 따라 바뀌어요: Claude Desktop과 Codex App은 클라이언트 자체 설정에 붙여넣을 커넥터 URL을 제공하고, Claude Code와 Codex CLI는 대신 복사할 단일 터미널 명령어를 제공해요.

아래 안내는 Claude Desktop 기준이에요.

1. 연결 페이지에서 **Claude Desktop**을 선택하세요. 1회용 연결 코드가 자동으로 발급되어 3단계 **Enter the connect code** 아래에 표시돼요 - 코드를 받기 위해 아무것도 클릭할 필요가 없어요. 코드는 생성 후 **6시간**이 지나면 만료돼요; **Regenerate**를 클릭하면 새 코드를 받을 수 있고, 현재 표시된 코드가 없으면 대신 **Generate**가 나타나요.
2. 2단계 **Add the connector to Claude Desktop**에서 **Remote MCP server URL**을 복사하세요. 코드 생성 여부와 관계없이 표시돼요.
3. Claude Desktop에서 **Settings**를 열고 **Connectors**로 이동하세요.
4. **Add custom connector**를 선택하고 URL을 붙여넣으세요.
5. **Connect**를 클릭하세요. Claude가 연결 코드를 요청해요.
6. 1단계의 연결 코드를 입력하세요.
7. Claude와 Aftersell 관리자 양쪽에 확인 번호가 나타나요. 관리자에서 일치하는 번호를 선택하여 연결을 승인하세요.

승인되면 상태가 **Connected**로 변경되고 질문을 시작할 수 있어요.

<div id="connecting-a-second-store">
  ## 두 번째 스토어 연결하기
</div>

MCP 연결은 단일 스토어가 아니라 이메일 주소에 연결돼요. 연결을 한 번 설정하면 전체 설정 과정을 다시 거치지 않고도 추가 스토어를 연결할 수 있어요.

다른 스토어를 연결하려면:

1. 해당 스토어의 Aftersell 관리자에서 연결 페이지를 여세요.
2. 페이지에 **Link store** 버튼이 있는 **Store data access** 섹션이 표시돼요.
3. **Link store**를 클릭하세요. 스토어가 즉시 연결돼요 - 연결 코드나 승인이 필요 없어요.

연결되면 AI 클라이언트가 동일한 연결을 통해 해당 스토어의 Aftersell 데이터를 읽을 수 있어요. 둘 이상의 스토어가 연결되어 있다면 어떤 스토어에 대해 묻는 것인지 AI 클라이언트에게 알려주세요.

<div id="the-two-sections-on-the-connect-page">
  ## 연결 페이지의 두 섹션
</div>

연결 페이지에는 두 개의 독립적인 섹션이 있어요:

* **MCP connection** - AI 클라이언트와 Aftersell MCP 간 연결의 상태. 이메일 전역 설정이에요: 하나의 연결이 연결된 모든 스토어에 적용돼요.
* **Store data access** - 이 특정 스토어의 데이터를 연결을 통해 접근할 수 있는지 여부.

Store data access 섹션은 MCP 연결이 활성화된 후에만 나타나요.

<div id="connection-statuses">
  ## 연결 상태
</div>

<div id="mcp-connection">
  ### MCP 연결
</div>

| 상태                         | 의미                                                    |
| -------------------------- | ----------------------------------------------------- |
| **Not connected**          | 활성 MCP 연결이 없어요. 설정 단계에 따라 연결하세요.                      |
| **Awaiting your approval** | AI 클라이언트에 연결 코드를 입력했어요. 관리자에서 일치하는 확인 번호를 선택하여 승인하세요. |
| **Connecting…**            | 승인이 제출됐어요. AI 클라이언트가 연결을 마무리하고 있어요. 보통 몇 초 정도 걸려요.    |
| **Connected**              | AI 클라이언트가 연결되어 Aftersell 분석을 읽을 수 있어요.                |

연결이 완료되기 전에 연결 코드나 대기 중인 승인이 만료되면 상태는 **Not connected**로 유지돼요 - 별도의 만료 상태는 없어요. 새 코드를 생성하고 단계를 다시 진행하세요.

<div id="store-data-access">
  ### 스토어 데이터 액세스
</div>

위의 MCP 연결 섹션과 달리 이 섹션은 한 가지 경우에만 상태 배지를 표시해요 - **Expired**. 다른 상태는 다른 방식으로 표시돼요:

| 상태                 | 표시되는 것                               | 의미                                                           |
| ------------------ | ------------------------------------ | ------------------------------------------------------------ |
| **Linked**         | 체크 표시가 있는 **Linked** 버튼 - 배지 없음      | 이 스토어의 데이터를 MCP 연결을 통해 접근할 수 있어요.                            |
| **Expired**        | **Expired** 배지와 **Link store** 버튼    | 이 스토어의 액세스가 30일 동안 사용되지 않아 만료됐어요. **Link store**를 클릭해 복원하세요. |
| **Not yet linked** | 배지 없음 - 섹션 설명과 **Link store** 버튼만 표시 | 연결은 존재하지만 이 스토어는 아직 연결되지 않았어요.                               |
| **Access removed** | 배지 없음 - 경고 배너                        | 스토어 소유자나 스태프가 이 스토어의 액세스를 제거했어요. 복원을 요청하세요.                  |

<div id="disconnecting">
  ## 연결 해제하기
</div>

AI 클라이언트를 Aftersell MCP에서 연결 해제하려면 연결 페이지에서 **Disconnect**를 클릭하고 확인하세요. 이렇게 하면 AI 클라이언트가 모든 스토어에서 즉시 연결 해제돼요. 스토어 액세스 기록은 보관되므로 설정 단계를 다시 따라 언제든지 재연결할 수 있어요.

<div id="who-can-connect">
  ## 연결할 수 있는 사람
</div>

스토어 소유자, 스태프, 협업자 모두 직접 연결할 수 있어요. 협업자는 자신의 이메일 주소로 연결하고 스토어를 링크하며, 세션이 있는 스토어로 범위가 제한돼요.

다른 사람의 MCP 액세스 관리 - 다른 사람의 액세스 부여, 승인 또는 취소 - 는 스토어 소유자와 스태프로 제한돼요.

액세스 관리는 셀프 연결과 별도로 배포되므로, 자신의 AI 클라이언트를 연결할 수 있더라도 관리 화면은 아직 스토어에서 사용할 수 없을 수 있어요. 필요하면 고객 지원팀에 문의하세요.

<div id="frequently-asked-questions">
  ## 자주 묻는 질문
</div>

**MCP가 무엇인가요?** MCP(Model Context Protocol)는 AI 클라이언트가 외부 도구와 데이터에 연결할 수 있게 하는 개방형 표준이에요. 이 커넥터는 이를 사용해 AI 클라이언트에 스토어의 Aftersell 분석에 대한 읽기 전용 액세스를 제공해요.

**AI는 무엇에 접근할 수 있나요?** 스토어의 Aftersell 분석만 접근할 수 있어요. Aftersell은 스토어 데이터의 전체 사본을 보유하지 않으므로 AI가 Shopify의 모든 것을 볼 수는 없어요 - 이 상점 범위로 제한된, Aftersell이 보유한 분석만 볼 수 있어요. 읽기 전용이며 개인 식별이 가능한 고객 필드는 차단돼요.

**AI가 도구 호출을 승인하라고 요청해요. 무슨 의미인가요?** AI 클라이언트는 도구를 실행하기 전에 승인을 요청해서 여러분이 AI의 동작을 계속 제어할 수 있게 해요. AI가 Aftersell 데이터를 읽으려고 할 때 이 커넥터의 도구 호출을 요청해요. 승인하면 AI가 답변할 수 있어요. 읽기 전용이므로 승인해도 AI는 분석만 읽을 수 있어요; 주문을 하거나 스토어의 어떤 것도 변경할 수 없어요.

**내 데이터는 안전한가요?** 네. 커넥터는 읽기 전용이며 스토어의 Aftersell 분석으로만 범위가 제한돼요. 설정 중 확인 번호 단계는 오직 여러분만 연결을 승인할 수 있도록 보장해요.

**다른 스토어를 어떻게 연결하나요?** 각 스토어의 Aftersell 관리자에서 연결 페이지를 열고 **Link store**를 클릭해 연결에 액세스 권한을 부여하세요. MCP 연결은 연결한 모든 스토어에 적용되므로, 둘 이상이 있으면 어떤 스토어에 대해 묻는 것인지 AI 클라이언트에게 알려주세요.

**연결 코드가 만료됐어요. 어떻게 하나요?** 이 페이지에서 새 코드를 생성해 사용하세요. 새 코드는 이전의 미사용 코드를 대체해요.

**AI의 액세스를 어떻게 중지하나요?** 이 페이지에서 **Disconnect**를 클릭하면 AI 클라이언트가 즉시 Aftersell MCP에서 연결 해제돼요. 설정 단계를 다시 따라 언제든지 재연결할 수 있어요.

**여러 AI 클라이언트를 연결할 수 있나요?** 각 연결 코드는 1회용이에요. 두 번째 기기나 클라이언트를 연결하려면 새 연결 코드를 생성하고 설정 단계를 반복하세요.