# Windsurf (https://sellersheetai.com/zh/docs/start/clients/windsurf)

> 在 mcp_config.json 里把 SellerSheet 加到 Windsurf——用 serverUrl，不是 url——第一次调用工具时登录。



把 SellerSheet 加到 Windsurf 的 MCP 配置；第一次调用工具时打开登录。

## 准备工作 [#准备工作]

* 一个已连接店铺的 SellerSheet 账号——见[连接店铺](/zh/docs/start/connect)。
* 已安装 Windsurf。

## 第 1 步：复制 SellerSheet MCP 地址 [#第-1-步复制-sellersheet-mcp-地址]

```text
https://sellersheetai.com/mcp
```

## 第 2 步：在 Windsurf 中添加 SellerSheet [#第-2-步在-windsurf-中添加-sellersheet]

编辑 `~/.codeium/windsurf/mcp_config.json`（或 **Windsurf Settings → MCP Servers → Add Server**）。Windsurf 用 `serverUrl`，不是 `url`：

```json title="mcp_config.json"
{
  "mcpServers": {
    "sellersheet": { "serverUrl": "https://sellersheetai.com/mcp" }
  }
}
```

## 第 3 步：登录并测试 [#第-3-步登录并测试]

1. 重启 Windsurf；第一次调用 SellerSheet 工具时会打开浏览器登录。
2. 问：“你能看到哪些店铺？” AI 会调用 `get_user_context`，列出你的店铺标识（例如 <StoreRef />）、套餐和每个店铺的状态。每次会话都应该从这里开始。

## 常见问题 [#常见问题]

### “Unauthorized”（401） [#unauthorized401]

登录或密钥已过期或被删除。重新登录，或新建一个密钥。

### 浏览器始终不打开 [#浏览器始终不打开]

升级客户端——旧版本不支持 MCP 登录——或改用 [API key](/zh/docs/mcp-api/keys)。

### “没有店铺” [#没有店铺]

先连接店铺：[连接店铺](/zh/docs/start/connect)。

更多见[故障排查](/zh/help/troubleshooting/ai)。下一步：[安装技能](/zh/docs/start/skills)，或[试试提示词库](/zh/docs/start/prompts)。