インストール不要。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 キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Square + Meta Muse
AI に Square のビジネスで作業させます。支払い、返金、注文の確認、顧客の管理、商品カタログの検索と編集、在庫の確認、請求書の作成と送信、店舗とチームメンバーの確認ができます。サンドボックスでも本番環境でも、自分のアクセストークンで接続します。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
SQUARE_ACCESS_TOKEN, SQUARE_API_URL
ステップ 1 — 認証情報を取得
- developer.squareup.com/apps に Square アカウントでサインインし、Create an application をクリックします（名前は何でもかまいません）。
- アプリケーションを開き、Credentials に進みます。上部の切り替えで Sandbox と Production を切り替えられます。
- 使いたい環境の Access token の横にある Show をクリックしてトークンをコピーし、Bearer という語やスペースを付けずに
SQUARE_ACCESS_TOKENに貼り付けます。 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 でアイテムを読み取り、完全なコピーを送り返します。省いた項目は、バリエーションも含めて削除されてしまうためです。在庫数はアイテム単位ではなく、バリエーションとロケーションごとに管理されます。
ロケーション: ほとんどのデータはロケーション（店舗）に属しており、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 — アダプターをインストール
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 のサインインページを開きます。サインインしてアクセスを承認します。
- チャットで、
Squareのツールが必要になる依頼を Muse にしてみましょう。
チャットから設定することもできます（Web、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://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。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] を探して、過去 3 か月の注文を見せて。」
- 「Espresso Blend 1 kg の在庫は各店舗にいくつある？」
- 「Acme 株式会社宛てに、コンサルティング 3 時間（1 時間 90 EUR）、支払期限 11 月 1 日の請求書を作成して、送る前に内容を見せて。」
FAQ
Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。
Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。
次のステップ
このガイドは役に立ちましたか?
