# 连接 AI 客户端 (https://sellersheetai.com/zh/docs/start/clients)

> 把 SellerSheet 加到你已经在用的助手里——一个服务器地址，浏览器登录或 API key，每个客户端都是同一套工具。



<ClientsHashRedirect lang="zh" />

你的 AI 登录你的 SellerSheet 账号，只能看到你能看到的店铺，使用的工具和 Google 表格侧边栏完全相同。

## 你需要什么 [#你需要什么]

* 一个已连接店铺的 SellerSheet 账号——见[连接店铺](/zh/docs/start/connect)。
* 一个支持 Streamable HTTP 的 MCP 客户端——下面每个客户端都支持。

| 设置    | 值                                                               |
| ----- | --------------------------------------------------------------- |
| 服务器地址 | `https://sellersheetai.com/mcp`                                 |
| 传输方式  | Streamable HTTP                                                 |
| 登录    | 浏览器 OAuth（无需复制密钥）——或 API key，以 `Authorization: Bearer <key>` 发送 |

<Callout title="最快：用 Claude Code、Codex 或 CodeBuddy？直接装插件。">
  SellerSheet 插件一步装好技能**和** MCP 服务器——见[安装技能](/zh/docs/start/skills)。下面各页是手动配置的步骤，以及其他所有客户端的配置。
</Callout>

## 选择你的客户端 [#选择你的客户端]

<Cards>
  <Card title="Claude 桌面版与 claude.ai" href="/zh/docs/start/clients/claude" icon="<ClientIcon name=&#x22;claude&#x22; size={20} />" description="自定义连接器，在浏览器里登录。" />

  <Card title="Claude Code" href="/zh/docs/start/clients/claude-code" icon="<ClientIcon name=&#x22;claude&#x22; size={20} />" description="一条命令，再用 /mcp 登录。" />

  <Card title="ChatGPT" href="/zh/docs/start/clients/chatgpt" icon="<ClientIcon name=&#x22;openai&#x22; size={20} />" description="开发者模式下的自定义连接器。" />

  <Card title="Codex" href="/zh/docs/start/clients/codex" icon="<ClientIcon name=&#x22;openai&#x22; size={20} />" description="插件，或 codex mcp add。" />

  <Card title="Cursor" href="/zh/docs/start/clients/cursor" icon="<ClientIcon name=&#x22;cursor&#x22; size={20} />" description="在 Cursor Settings 或 mcp.json 里添加全局 MCP 服务器。" />

  <Card title="Windsurf" href="/zh/docs/start/clients/windsurf" icon="<ClientIcon name=&#x22;windsurf&#x22; size={20} />" description="mcp_config.json，用 serverUrl。" />

  <Card title="扣子 Coze" href="/zh/docs/start/clients/coze" icon="<ClientIcon name=&#x22;coze&#x22; size={20} />" description="MCP 工具，API key 放在请求头里。" />

  <Card title="WorkBuddy" href="/zh/docs/start/clients/workbuddy" icon="<ClientIcon name=&#x22;workbuddy&#x22; size={20} />" description="从连接器市场安装——无需命令。" />

  <Card title="CodeBuddy" href="/zh/docs/start/clients/codebuddy" icon="<ClientIcon name=&#x22;codebuddy&#x22; size={20} />" description="和 Claude Code 相同的插件。" />

  <Card title="任何 MCP 客户端" href="/zh/docs/start/clients/other" icon="<ClientIcon name=&#x22;mcp&#x22; size={20} />" description="地址、传输方式和两种登录方式。" />
</Cards>

## 确认连接成功 [#确认连接成功]

问：“你能看到哪些店铺？” AI 会调用 `get_user_context`，列出你的店铺标识（例如 <StoreRef />）、套餐和每个店铺的状态。每次会话都应该从这里开始。

## 登录是怎么回事 [#登录是怎么回事]

登录向 SellerSheet 证明的是**你**的身份——用 Google 或邮箱验证码，从不用亚马逊账号。你[连接店铺](/zh/docs/start/connect)时给的亚马逊授权已经保存在 SellerSheet。每次浏览器登录都会在应用的 **Settings → API & MCP** 下创建一个以客户端命名的 MCP key；在那里删除它，该客户端立即失效。

## 遇到问题 [#遇到问题]

| 现象                  | 处理                                    |
| ------------------- | ------------------------------------- |
| “Unauthorized”（401） | 登录或密钥已过期或被删除。重新登录，或新建一个密钥。            |
| 浏览器始终不打开            | 升级客户端——旧版本不支持 MCP 登录——或改用 API key。    |
| “没有店铺”              | 先连接店铺：[连接店铺](/zh/docs/start/connect)。 |
| 工具调用超时              | 有些亚马逊报表需要一两分钟。调大客户端的 MCP 工具超时时间。      |

更多见[故障排查](/zh/help/troubleshooting/ai)。下一步：[安装技能](/zh/docs/start/skills)，或[从代码调用同一套工具](/zh/docs/mcp-api/code)。