> ## 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 托管了一个 MCP 服务器，为你的 AI 客户端提供对你商店 Aftersell 分析数据的只读访问。

自助连接页面让你可以将 AI 客户端（例如 Claude Desktop）关联到你商店的 Aftersell 分析数据。连接后，你可以直接用自然语言向 AI 客户端询问有关商店 upsell 表现、漏斗结果等方面的问题。

该连接是只读的：你的 AI 客户端可以读取你的 Aftersell 分析数据，但无法下单或更改任何设置。可识别个人身份的客户字段会被屏蔽。

<div id="what-you-can-ask">
  ## 你可以问什么
</div>

连接后，你可以向 AI 客户端提出类似下面这些问题：

* 上周我的 upsell 带来了多少额外收入？
* 在购买后表现方面，我和类似商店相比如何？
* 我的漏斗本周表现如何？
* 拆解一下我的优惠响应情况——有多少被接受、被拒绝或超时？
* 为什么我的购买后优惠没有向更多购物者展示？
* 上个月哪些 upsell 商品带来的收入最多？
* 我的活跃漏斗中哪一个的转化表现不佳？
* 本月我的商店每天有多少订单，平均订单价值是多少？
* 比较我的主优惠步骤、第二个优惠和 downsell——哪个转化率最高？
* 我的 upsell 转化率最近是上升还是下降？
* 过去两周每天有多少人看到了我的购买后优惠？
* 我的每访客收入与类似商店相比如何？
* 追踪订单 #1234——购物者看到优惠了吗？

<div id="connecting-your-ai-client">
  ## 连接你的 AI 客户端
</div>

连接页面首先显示 **Choose your AI client**（选择你的 AI 客户端），可选 **Claude Desktop**、**Claude Code**、**Codex App** 和 **Codex CLI**。下方的步骤会随你的选择而变化：Claude Desktop 和 Codex App 会提供一个连接器 URL 供你粘贴到客户端自身的设置中，而 Claude Code 和 Codex CLI 则会提供一条可直接复制的终端命令。

以下演示以 Claude Desktop 为例。

1. 在连接页面上，选择 **Claude Desktop**。系统会自动为你生成一个一次性连接代码，并显示在第 3 步 **Enter the connect code** 下——你无需点击任何按钮即可获得。该代码在生成后 **6 小时**过期；**Regenerate** 可为你生成新代码，如果当前没有显示代码，则会显示 **Generate** 按钮。
2. 从第 2 步 **Add the connector to Claude Desktop** 复制 **Remote MCP server URL**。无论是否已生成代码，该 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. 页面会显示 **Store data access** 部分，其中有一个 **Link store** 按钮。
3. 点击 **Link store**。商店会立即完成关联——无需连接代码或批准。

关联后，你的 AI 客户端就可以通过同一个连接读取该商店的 Aftersell 数据。如果你关联了多家商店，请告诉 AI 客户端你询问的是哪家商店。

<div id="the-two-sections-on-the-connect-page">
  ## 连接页面上的两个部分
</div>

连接页面包含两个相互独立的部分：

* **MCP connection** —— 你的 AI 客户端与 Aftersell MCP 的连接状态。这是全邮箱范围的：一个连接可以访问你关联的所有商店。
* **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 想读取你的 Aftersell 数据时，它会请求调用此连接器的工具。批准后它就能回答问题。由于是只读的，批准仅允许 AI 读取你的分析数据；它无法下单或更改商店中的任何内容。

\*\*我的数据安全吗？\*\*安全。该连接器是只读的，且范围仅限于你商店的 Aftersell 分析数据。设置过程中的验证数字环节可确保只有你本人才能批准连接。

\*\*如何连接另一家商店？\*\*从每家商店的 Aftersell 后台打开连接页面，点击 **Link store** 为你的连接授予访问权限。你的 MCP 连接可以访问你关联的所有商店，因此当你有多家商店时，请告诉 AI 客户端你询问的是哪一家。

\*\*我的连接代码过期了怎么办？\*\*在此页面生成新代码并使用新代码。每个新代码都会替换之前未使用的代码。

\*\*如何停止 AI 的访问？\*\*点击此页面上的 **Disconnect**，即可立即断开你的 AI 客户端与 Aftersell MCP 的连接。之后你随时可以按设置步骤重新连接。

\*\*我可以连接多个 AI 客户端吗？\*\*每个连接代码都是一次性的。要连接第二台设备或客户端，请生成新的连接代码并重复设置步骤。