连接器指南阅读约 3 分钟16 个 MCP 工具7 种语言

Squarespace MCP 连接 Microsoft Copilot

Squarespace Commerce API 用于一个站点:订单和履行(带跟踪)、库存水平和库存调整、产品和变体、客户档案和联系人,以及财务交易。API 密钥持有者。

HC作者:HelpCode 团队更新于 3 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

Squarespace Commerce

Squarespace Commerce

Squarespace Commerce APIs for one site: orders and fulfillment with tracking, inventory levels and stock adjustments, products and variants, customer profiles and contacts, and financial transactions. API key bearer.

个工具

16

区域

INTL

类别

电子商务

身份验证

Bearer Token

所需环境变量

SQUARESPACE_API_KEY
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

Squarespace Commerce API 用于一个站点:订单和履行(带跟踪)、库存水平和库存调整、产品和变体、客户档案和联系人,以及财务交易。API 密钥持有者。

引导式设置

2 分钟将 Squarespace Commerce 连接到 Microsoft Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Squarespace Commerce,再把你的 MCP URL 添加到 Microsoft Copilot。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

Squarespace Commerce 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Squarespace Commerce · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Squarespace Commerce,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

Squarespace Commerce + Microsoft Copilot

Squarespace Commerce API 用于一个站点:订单和履行(带跟踪)、库存水平和库存调整、产品和变体、客户档案和联系人,以及财务交易。API 密钥持有者。

前提条件

请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

SQUARESPACE_API_KEY

第一步 — 获取凭据

设置大约需要 3 分钟。

  1. 登录到 Squarespace 站点。在左侧导航中打开 Settings,滚动到 Advanced 并点击 Developer API Keys。API 密钥需要 Commerce Advanced 计划。
  2. 点击 Generate key,为其命名,并选择权限:Orders(读取和写入以履行)、Inventory(读取和写入以更改库存)、Products(只读)、Profiles、Contacts 和 Transactions(只读)。
  3. 将密钥复制到 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

第三步 — 在 Microsoft Copilot 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。

  1. 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
  2. 填写 Server name(例如 AnythingMCP)、说明连接器用途的 Server description,以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。
  3. 身份验证选择 API key,把 Type 设为 Header,请求头名称填 X-API-Key,然后选择 Create。
  4. 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
  5. 在智能体的 Test 窗格中试一试:提出需要用到 Squarespace Commerce 的工具的请求。
  6. 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。

希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。

自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。

可用工具

工具功能
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 个单位。"
  • "显示上个月的交易和总处理费用。"

常见问题

需要哪个计划? Squarespace 开发者 API 密钥需要 Commerce Advanced 计划。在设置、Advanced、Developer API Keys 下生成一个密钥,并根据需要选择权限;它只显示一次。

它涵盖了什么? 一个 Squarespace 站点:订单和履行(带跟踪)、库存和库存调整、产品和变体(只读)、客户档案和联系人,以及财务交易。

哪些工具安装时关闭? 没有。产品是只读的,履行订单或更改库存在运行之前会显示给你。

这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。

我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。

智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。

下一步

这份指南对你有帮助吗?

2 分钟将 Squarespace Commerce 连接到 Microsoft Copilot

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Squarespace Commerce,再把你的 MCP URL 添加到 Microsoft Copilot。无需代码,也无需自行运行服务器。

相关指南