跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 Square，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
让你的 AI 处理你的 Square 业务：查询付款、退款和订单，管理客户，搜索和编辑商品目录，查看库存，创建并发送发票，查看门店和团队成员。沙盒或生产环境均可，使用你自己的访问令牌。
试试这样问
Square 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Square、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Square + Meta Muse
让你的 AI 处理你的 Square 业务：查询付款、退款和订单，管理客户，搜索和编辑商品目录，查看库存，创建并发送发票，查看门店和团队成员。沙盒或生产环境均可，使用你自己的访问令牌。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
SQUARE_ACCESS_TOKEN, SQUARE_API_URL
步骤 1 — 获取凭证
- 用你的 Square 账户登录 developer.squareup.com/apps，点击 Create an application（名称随意）。
- 打开该应用，进入 Credentials。顶部的开关可以在 Sandbox 和 Production 之间切换。
- 在所需环境的 Access token 旁点击 Show，复制令牌并填入
SQUARE_ACCESS_TOKEN，不要带 Bearer 字样，也不要带空格。 - 把
SQUARE_API_URL设为https://connect.squareupsandbox.com（沙盒令牌）或https://connect.squareup.com（生产令牌），末尾不要加斜杠。令牌只能在它自己的环境中使用。 - 安装连接器并运行
square_get_merchant：它会显示令牌所连接商家的名称、国家和货币。
访问令牌：Credentials 页面上的令牌是个人访问令牌，对你自己的 Square 账户拥有完全访问权限，连接器需要的正是它。它不会过期，但任何持有它的人都能以你商家的名义操作：请妥善保密；如果泄露，在同一页面更换令牌，并把新令牌填入 SQUARE_ACCESS_TOKEN。
沙盒和生产环境：沙盒令牌属于一个默认的测试卖家，不涉及真实的资金和客户。如需以卖家身份查看结果，在开发者控制台中打开 Sandbox test accounts → 对应账户 → Square Dashboard。沙盒从不通过邮件发送发票；请改为打开发票的公开链接。
权限和只读设置：Credentials 页面上的令牌始终拥有完全访问权限，因此只读设置需要在连接器中完成：停用 square_refund_payment、square_create_order、square_create_customer、square_update_customer、square_upsert_catalog_object、square_create_invoice、square_publish_invoice 和 square_cancel_invoice。
安装时默认关闭：square_delete_customer、square_delete_catalog_object 和 square_delete_invoice。只有在 AI 需要删除客户资料、目录对象（删除商品时会连同其规格一起删除）或发票草稿（其订单也会被取消）时才打开它们。
资金和客户邮件：square_refund_payment 会把钱退还给客户，且无法撤销；square_publish_invoice 会通过邮件把发票发送给客户并使其可以支付；square_cancel_invoice 会让已发布的发票无法再支付，并通知客户。调用这些工具前，AI 会说明金额、客户和 id，并等你确认。用 square_upsert_catalog_object 修改已有目录商品前也是如此。
发票：发票基于一个未完成（OPEN）的订单。AI 先用 square_create_order 创建订单（不会扣款），再用 square_create_invoice 创建草稿；在执行 square_publish_invoice 之前，客户不会收到任何内容。通过邮件发送时，客户资料中需要有邮箱地址。
目录修改会替换整个商品：square_upsert_catalog_object 会整体替换已有对象，因此 AI 会先用 square_get_catalog_object 读取商品，再发回完整的副本；遗漏的字段（包括规格）会被删除。库存按商品规格和门店分别记录，而不是按商品记录。
门店：大多数数据都属于某个门店（location），square_list_locations 会列出所有门店。不指定门店时，square_list_payments 只涵盖主门店，而发票总是按门店列出。离线收到的订单最多可能需要 72 小时才会显示。
常见错误：401 UNAUTHORIZED 表示令牌错误，或与 SQUARE_API_URL 不匹配（沙盒令牌配生产 URL，或反之）：请同时检查两者。403 表示令牌缺少该调用所需的权限；Credentials 页面上的令牌拥有完全访问权限，请确认你填入的正是它。400 VERSION_MISMATCH 表示对象在此期间已被修改，需要重新读取；其他 400 INVALID_REQUEST_ERROR 响应会指出出错的字段。404 NOT_FOUND 表示 id 错误，或对象属于其他门店或其他环境。429 RATE_LIMITED 表示 Square 正在限制该账户的请求：稍等片刻再试。
连接器不受理刷卡收款，也不处理礼品卡、会员积分、预约、订阅、结算打款或 Webhook。
步骤 2 — 安装 adapter
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
步骤 3 — 在 Muse 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Muse 以自定义连接器的形式添加远程 MCP 服务器，并通过 OAuth 登录。
- 在 Muse 中打开 Settings → Connectors，选择 Add custom connector。
- 粘贴 MCP 服务器 URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。 - Muse 会打开 AnythingMCP 的登录页面：登录并批准访问。
- 在聊天中，向 Muse 提出需要用到
Square的工具的请求。
你也可以在聊天中完成设置，适用于网页版、iOS 和 Android 应用以及 WhatsApp。给 Muse 发送这条消息：
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Muse 从 Meta 的云端连接，因此 localhost 无法使用。
可用工具
| Tool | What it does |
|---|---|
square_get_merchant | Read the seller account behind the token: business name, country, currency, language, status and main_location_id |
square_list_locations | List the business locations: id, name, address, timezone, currency, status and capabilities |
square_get_location | Read one location by id, or the main location with "main": address, hours, currency, capabilities |
square_list_payments | List payments (newest first by default) with amount, status, card details, order and customer ids, refunds and receipt URL |
square_get_payment | Read one payment: amounts (total, tip, app fee, refunded), status (APPROVED, PENDING, COMPLETED, CANCELED, FAILED), source and card… |
square_list_refunds | List refunds (newest first by default) across all locations unless one is given: amount, status, reason, payment id |
square_get_refund | Read one refund: amount, status, reason, payment and order ids |
square_refund_payment | Refund a payment in full or in part |
square_search_orders | Search orders of 1 to 10 locations by state, dates, customers or source, with line items, totals, tenders and fulfillments |
square_get_order | Read one order: state, line items with modifiers, taxes and discounts, totals, tenders (payments), refunds and fulfillments |
square_create_order | Create an OPEN order, for example as the basis of an invoice |
square_list_customers | List customer profiles: id, names, company, email, phone, address, reference id, version |
square_search_customers | Search customer profiles by email, phone, reference id, creation or update time, or group |
square_get_customer | Read one customer profile with its current version, groups and preferences |
square_create_customer | Create a customer profile |
square_update_customer | Update a customer profile |
square_delete_customer | Delete a customer profile for good |
square_list_catalog | List catalog objects of the given types (100 per page): items with variations and prices, categories, taxes, discounts, modifier lists |
square_search_catalog_items | Search items by text (name, description, SKU, UPC), category, location, stock level or product type |
square_search_catalog_objects | Search any catalog objects (items, variations, categories, taxes, discounts...) by keywords, exact or prefix attribute values, or change… |
square_get_catalog_object | Read one catalog object by id with its version (needed to update it), optionally with the objects it references |
square_upsert_catalog_object | Create a catalog object, or REPLACE an existing one as a whole: fields left out (variations included) are removed, so for an update send… |
square_delete_catalog_object | Delete a catalog object for good; deleting an item also deletes its variations |
square_get_inventory_counts | Read inventory counts for many item variations and locations at once: quantity (a string) per state such as IN_STOCK, newest first |
square_get_inventory_count | Read the inventory count of one item variation, per location and state |
square_list_invoices | List the invoices of one location: id, number, status (DRAFT, UNPAID, SCHEDULED, PARTIALLY_PAID, PAID, CANCELED, ...), recipient, payment… |
square_search_invoices | Search the invoices of one location, optionally of one customer, sorted by invoice date |
square_get_invoice | Read one invoice: status, version (needed to publish or cancel), order, recipient, payment requests with computed amounts, public_url and… |
square_create_invoice | Create a DRAFT invoice for an OPEN order (make one with square_create_order) |
square_publish_invoice | Publish a draft invoice: Square sends it to the customer (EMAIL delivery) or makes it payable at public_url, and it can no longer be edited… |
square_cancel_invoice | Cancel a published invoice so it can no longer be paid; the customer is notified |
square_delete_invoice | Delete a DRAFT invoice; its order is canceled too |
square_search_team_members | Search team members by location, status or owner flag: id, names, email, phone, status, is_owner and assigned locations |
square_get_team_member | Read one team member: names, email, phone, status, owner flag and location assignments |
示例提示
- “昨天主门店收到了哪些付款？其中有没有退款的？”
- “找到客户 [email protected]，显示她最近三个月的订单。”
- “Espresso Blend 1 kg 在每个门店各有多少库存？”
- “给 Acme 有限公司开一张发票：3 小时咨询，每小时 90 EUR，11 月 1 日到期，发送前先给我看看。”
FAQ
Muse 在哪些地区可用？ Meta 目前在美国和加拿大提供 Muse，可在网页版、iOS 和 Android 应用以及 WhatsApp 中使用。
Meta 会审核这个连接器吗？ 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具，你也可以随时在 Settings → Connectors 中断开它。
下一步
这份指南对你有帮助吗?
