KocoroShopify 集成配置指南
将 Kocoro 接入你的 Shopify 商店，让智能体用自然语言查询商品、订单、客户与库存。只需在 Shopify 后台创建一个只读权限的自定义应用，再把访问令牌填入 Kocoro。全流程约 5 分钟。
开始前的准备
- 一个具备「开发应用」权限的 Shopify 账号。
- 已安装并完成初始化的 Kocoro，并至少创建一个智能体。
- 1
打开 Shopify 后台的「设置」
登录 Shopify 管理后台（admin.shopify.com），点击左下角的「设置」。
- Shopify 管理后台: https://admin.shopify.com
图 1：在 Shopify 后台左下角打开「设置」。 - 2
进入「应用」并点击「开发应用」
在设置页左侧选择「应用」，点击右上角的「开发应用」。
图 2：设置 → 应用 → 开发应用。 - 3
创建遗留自定义应用
在「应用开发」页面点击「创建遗留自定义应用」。
如果看不到该按钮，可能需要先由店主开启「允许自定义应用开发」。图 3：点击「创建遗留自定义应用」。 - 4
填写应用名称并创建
在弹窗中输入应用名称（如 Kocoro），选择应用开发者，点击「创建应用」。
图 4：输入应用名称并点击「创建应用」。 - 5
配置 Admin API 集成
进入应用页面的「配置」标签页，在「Admin API 集成」卡片点击「配置」。
图 5：配置标签页 → Admin API 集成 → 配置。 - 6
勾选只读访问权限并保存
在「Admin API 访问范围」中逐个搜索并勾选以下 7 个只读权限（搜索框不支持一次粘贴多个），然后点击「保存」：
read_productsread_ordersread_customersread_inventoryread_locationsread_draft_ordersread_price_rules- Kocoro 只申请只读（read_*）权限，不会修改你商店的任何数据。
点击「保存」后，如果右上角的「安装应用」按钮仍是灰色，请再点击一次「保存」。图 6：勾选 7 个只读权限并点击「保存」。 - 7
安装应用
点击右上角的「安装应用」，在确认弹窗中点击「安装」。
图 7：确认安装应用。 - 8
复制 Admin API 访问令牌
安装后进入「API 凭据」标签页，复制以 shpat_ 开头的 Admin API 访问令牌；同时记下你的商店域名（如 yourstore.myshopify.com，可在左侧栏查看）。
令牌仅显示一次，请立即复制并妥善保管。图 8：复制访问令牌并记下商店域名。 - 9
在 Kocoro 中连接 Shopify
打开 Kocoro，进入「设置 → 自定义 → MCP 服务器」，打开「Shopify」的开关。在弹出的「连接 Shopify」对话框中填入店铺域名与 Admin API 访问令牌，点击「连接」。
- 令牌仅在建立连接时使用一次，不会存储在这台 Mac 上。
图 9：在 Kocoro 中填入店铺域名与令牌并连接。
完成！让智能体查询你的商店
连接成功后，智能体即可直接查询商店数据——试试「昨天有哪些订单？」「哪些商品库存不足？」「找出本月消费最高的客户」。