摘要
Squarespace Commerce API 用于一个站点:订单和履行(带跟踪)、库存水平和库存调整、产品和变体、客户档案和联系人,以及财务交易。API 密钥持有者。
引导式设置
2 分钟将 Squarespace Commerce 连接到 Claude
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Squarespace Commerce,再把你的 MCP URL 添加到 Claude。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
AnythingMCP 已收录在 Claude 的连接器目录中:一键添加到 Claude (在新标签页中打开),然后登录并选择 Claude 可以使用哪些 MCP 服务器。
试试这样问
Squarespace Commerce 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Squarespace Commerce,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Squarespace Commerce + Claude
Squarespace Commerce API 用于一个站点:订单和履行(带跟踪)、库存水平和库存调整、产品和变体、客户档案和联系人,以及财务交易。API 密钥持有者。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
SQUARESPACE_API_KEY
第一步 — 获取凭据
设置大约需要 3 分钟。
- 登录到 Squarespace 站点。在左侧导航中打开 Settings,滚动到 Advanced 并点击 Developer API Keys。API 密钥需要 Commerce Advanced 计划。
- 点击 Generate key,为其命名,并选择权限:Orders(读取和写入以履行)、Inventory(读取和写入以更改库存)、Products(只读)、Profiles、Contacts 和 Transactions(只读)。
- 将密钥复制到
SQUARESPACE_API_KEY。Squarespace 只显示一次;在站点处于活动状态时不会过期。
每次调用都携带 Authorization: Bearer 和密钥,以及 Squarespace 所需的 User-Agent 头。
从哪里开始:squarespace_commerce_get_website 确认站点,然后使用 squarespace_commerce_list_orders 和 fulfillment_status PENDING 获取待发货的订单。
订单:squarespace_commerce_list_orders、squarespace_commerce_get_order 和 squarespace_commerce_fulfill_order(添加带跟踪的发货并标记订单为已履行;可以发送电子邮件给客户)。在调用中使用订单 id;orderNumber 是客户看到的。退款和取消不在 API 范围内。
库存:squarespace_commerce_list_inventory、squarespace_commerce_get_inventory、squarespace_commerce_adjust_inventory。每次调整需要一个新的 idempotency_key(UUID):重新发送相同的密钥不会产生任何效果,这使得重试是安全的。
产品:squarespace_commerce_list_products 和 squarespace_commerce_get_products(产品 API v2:类型 PHYSICAL、SERVICE、GIFT_CARD 和 DIGITAL;每个变体的价格和库存)。产品更改不包括在内。
人员:squarespace_commerce_list_contacts、squarespace_commerce_search_contacts、squarespace_commerce_get_contact(联系人 API)以及较旧的 squarespace_commerce_list_profiles、squarespace_commerce_get_profiles(档案 API,处于维护模式,但仍是每个客户的订单总额)。
资金:squarespace_commerce_list_transactions 和 squarespace_commerce_get_transactions 读取每个订单或捐赠的付款、退款和费用;这里没有资金流动。
分页和日期:列表最多返回 50 条记录,带有 pagination.hasNextPage 和 pagination.nextPageCursor;仅传递光标以获取下一页。modified_after 和 modified_before 必须一起给出,并且是 UTC ISO 8601。资金值是带有 currency 和 value(十进制字符串)的对象。按 ID 获取工具最多接受 50 个用逗号分隔的 ID。
速率限制:每个密钥每分钟 300 次请求;超过此限制,Squarespace 返回 429 并阻止该密钥一分钟。
第二步 — 安装适配器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
第三步 — 在 Claude 中添加连接器
你的服务器 URL: 在 AnythingMCP 中,打开 MCP Servers → 该连接器所在的服务器,并复制其 URL(
https://cloud.anythingmcp.com/mcp/…)。在本指南中显示YOUR_SERVER_ID的地方使用它。
推荐路径:在 claude.ai web 上工作,无需编辑任何配置文件。
- 在 Claude 中,打开 Plugins(部分套餐仍显示为 Customize)→ Connectors。
- 点击 + Add,然后 Add custom connector。
- 输入名称,例如
Squarespace Commerce,以及远程 MCP 服务器 URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Continue,保留检测到的设置,再次点击 Continue。 - 选择 Sign in now,点击 Add 并登录到 AnythingMCP(OAuth)以允许访问。
下面的所有工具都会出现在你的聊天中:开始输入提示。
可用工具
| 工具 | 功能 |
|---|---|
squarespace_commerce_get_website | 读取与 API 密钥相关的 Squarespace 站点的基本信息:id、siteTitle、url、timeZone、currency、language 和 location.… |
squarespace_commerce_list_orders | 列出订单,按最近修改的顺序排列,每页 50 条:id、orderNumber、createdOn、modifiedOn、channel、customerEmail、customerId… |
squarespace_commerce_get_order | 按 id 读取一个订单:与 squarespace_commerce_list_orders 相同的字段,包含所有行项目、折扣、内部备注和履行信息 |
squarespace_commerce_fulfill_order | 将订单标记为已履行,并添加带有发货日期、承运人、服务、跟踪号码和跟踪 URL 的发货。should_send_notification… |
squarespace_commerce_list_inventory | 列出所有产品变体的库存,每页 50 条:variantId、sku、descriptor(产品名称和选项)、isUnlimited 和 quantity。下一个… |
squarespace_commerce_get_inventory | 读取特定变体的实时库存:variantId、sku、descriptor、isUnlimited 和 quantity |
squarespace_commerce_adjust_inventory | 在一次调用中更改变体的库存:按数量增加或减少,设置有限数量,或使变体无限制。需要一个… |
squarespace_commerce_list_products | 列出产品,每页 50 条:id、type(PHYSICAL、SERVICE、GIFT_CARD、DIGITAL)、storePageId、name、description、url、urlSlug、tags… |
squarespace_commerce_get_products | 按 id 读取最多 50 个产品及其变体、定价、库存、属性和图像 |
squarespace_commerce_list_profiles | 列出档案(客户、邮件列表订阅者、捐赠者),每页 50 条:id、firstName、lastName、email、hasAccount、isCustomer… |
squarespace_commerce_get_profiles | 按 id 读取最多 50 个档案:姓名、电子邮件、地址、营销同意和 transactionsSummary |
squarespace_commerce_list_contacts | 列出联系人(档案的继任者):id、firstName、lastName、email、phone、createdOn、defaultShippingAddress 和 marketing… |
squarespace_commerce_search_contacts | 按名称或电子邮件文本搜索联系人,按要求排序:与 squarespace_commerce_list_contacts 相同的字段。只读,尽管它是一个… |
squarespace_commerce_get_contact | 读取一个联系人:姓名、电子邮件、电话、地址和营销偏好 |
squarespace_commerce_list_transactions | 列出按订单或捐赠(文档)分组的财务交易,每页 50 条:id、createdOn、modifiedOn、customerEmail、salesOrderId… |
squarespace_commerce_get_transactions | 按 id 读取最多 50 个交易文档,包含付款、退款、费用和行项目。只读 |
示例提示
- "哪些 Squarespace 订单仍在等待履行?"
- "用 USPS 跟踪 9400111899223197428490 履行订单 1047,并发送电子邮件给客户。"
- "哪些产品的库存少于 5 个单位?"
- "将变体 SKU MUG-WHT-12 的库存增加 20 个单位。"
- "显示上个月的交易和总处理费用。"
常见问题
它是否适用于 Claude Code 和 Claude Desktop? 是的,两个都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
需要哪个计划? Squarespace 开发者 API 密钥需要 Commerce Advanced 计划。在设置、Advanced、Developer API Keys 下生成一个密钥,并根据需要选择权限;它只显示一次。
它涵盖了什么? 一个 Squarespace 站点:订单和履行(带跟踪)、库存和库存调整、产品和变体(只读)、客户档案和联系人,以及财务交易。
哪些工具安装时关闭? 没有。产品是只读的,履行订单或更改库存在运行之前会显示给你。
下一步
这份指南对你有帮助吗?