Square MCP Serverとは？
Block 傘下の Square は、MCP サーバーを https://mcp.squareup.com/mcp で OAuth のサインイン付きでホストしています。古い /sse エンドポイントも引き続き提供されてい ます。悪意あるクライアント登録を防ぐため、接続できるのは承認済みのクライアントだけで、ドキュメントには Claude.ai、Claude Desktop、Goose、Cursor、Windsurf が挙がっています。ホスト型サーバーが扱えるのは本番データだけで、プロジェクト全体がまだベータとされています。
サンドボックスでテストするには、オープンソースのローカルサーバーを npx square-mcp-server start で、ACCESS_TOKEN と SANDBOX=true を指定して動かします。DISALLOW_WRITES=true で読み取り専用になり、SQUARE_VERSION で API のバージョンを固定できます。npm パッケージは 2025年4月25日の 0.1.2 以降リリースがありませんが、リポジトリの README は 2026年10月に改訂され、多くのユーザーをホスト型サーバーへ誘導しています。
エンドポイントごとに 1 つのツールを用意するのではなく、ツールは 3 つです。サービスのメソッドを調べる get_service_info、パラメーターの詳細を取得する get_type_info、API を呼び出す make_api_request です。これで、決済、返金、注文、カタログ、在庫、請求書、入金、勤怠、ロイヤルティを含む 38 の Square サービスに届きます。
Square MCP Serverのインストール方法
https://mcp.squareup.com/mcpSquare MCP Serverは使う価値があるか？
Square は Stripe の汎用ツールと同じ道を選んでいます。3 つのツールで、エージェントは 38 の Square サービスのどれでも調べて呼び出せます。ツール一覧が小さく保たれるため、複数のサーバーでコンテキストウィンドウを共有するときに役立ちま す。また販売者は、専用のツールを待たずに、カタログ、注文、顧客、入金について質問できます。
汎用ツールの代償は、モデルが正しいメソッドを見つけ、リクエストの本文を自分で組み立てなければならないことです。未解決の issue を見ると、どこでうまくいかなくなるかがわかります。issue #20（2026年4月）は、make_api_request が location_ids などのフィールドに空の配列を送って Orders の検索を壊し、パスパラメーターも解決できないと報告しています。issue #31（2026年9月）は、CreatePayment の説明が呼び出しのたびに新しい冪等キーを作るようモデルに指示しているため、再試行したリクエストでカードに二重に請求しかねないと指摘しています。issue #27 は、汎用的な名前がほかのサーバーのツールと衝突するため、モデルが決済の質問を Stripe に回すことがあると述べています。
ホスト型サーバーは本番環境にしか届かず、まずサンドボックスでプロンプトを試すようにという Square 自身の助言と噛み合いません。そうするにはトークンを使ってローカルのパッケージを動かす必要があり、DISALLOW_WRITES の読み取り専用スイッチもそちらにしかありません。ドキュメントはホスト型サーバーの OAuth スコープを明示しておらず、MCP エンドポイントのレート制限やデータ保持の条件も公開していません。
先月最も売れた商品や、期限を過ぎた請求書はどれかといった、1 つの販売者の事業に関する読み取り専用の質問であれば、この設計は機能し、通常の Square の手数料以外に費用はかかりません。決済、返金、在庫に触れる書き込みは、issue #20 と #31 が閉じられるまで、すべての呼び出しで人の承認を挟む べきです。
真価を発揮する場面
Square を使う 2 店舗のカフェのオーナー
先月どのメニューがよく売れ、どれがほとんど動かなかったかを調べる
Claude で、エージェントがホスト型サーバーの make_api_request を通じて注文とカタログを照会します。追加料金はありません。同じツールで書き込みもできるため、呼び出しは毎回承認してください。location_ids で Orders の検索が失敗する場合、原因はプロンプトではなく未解決のバグ #20 です。
小売業のクライアント向けに Square の連携を作る開発者
なじみのない Square のエンドポイントをテストデータで試す
SANDBOX=true と DISALLOW_WRITES=true を指定して npx square-mcp-server start を実行します。get_service_info と get_type_info が対話型の API リファレンスとして働きます。無料で、本物のお金には一切触れません。
導入前に確認すること
- 導入
- 承認済みのクライアント（Claude.ai、Claude Desktop、Goose、Cursor、Windsurf）で https://mcp.squareup.com/mcp を追加し 、Square でサインインします。Claude Desktop の設定では npx mcp-remote を使います。サンドボックスでは、ACCESS_TOKEN と SANDBOX=true を指定して npx square-mcp-server start を実行します。
- 連携
- ツールは 3 つです。読み取り専用の探索用に get_service_info と get_type_info、そして決済、返金、注文、カタログ、在庫、請求書、入金を含む 38 のサービスで読み書きを行う make_api_request です。
- データとプライバシー
- ホスト型サーバーは OAuth を通じて本番の実データに対して動作します。ドキュメントにはスコープも保持の条件も記載がありません。ローカルサーバーはアクセストークンを自分のマシンに保持し、DISALLOW_WRITES=true で読み取り専用にできます。
- 大規模利用時のコスト
- サーバーは Apache-2.0 で無料です。作成された決済には Square の標準の決済手数料がかかります。1 つの操作には通常 2、3 回の呼び出し（探索、型の確認、リクエスト）が必要なので、タスクあたりのトークン使用量は専用ツールより多くなります。MCP のドキュメントにレート制限は公開されていません。
- 制限
- ベータ版で、ホスト型サーバーは本番専用です。未解決の issue では、配列パラメーターの欠落（#20）、再試行された決済での二重請求のリスク（#31）、ほかのサーバーとのツール名の衝突（#27）が報告されています。
良い点
- 3 つのツールで 38 の Square サービスに届く
- 承認済みクライアントの一覧を持つホスト型の OAuth サーバー
- ローカルサーバーでは読み取り専用モードとサンドボックスに対応
- ツール一覧が小さく、コンテキストにほかのサーバーの余地が残る
気になる点
- ベータ版で、npm パッケージは 2025年4月から変わっていない
- ホスト型サーバーは本番専用で、読み取り専用のスイッチがない
- 未解決のバグ：配列パラメーターの欠落、二重請求のおそれがある冪等性の記述
- 汎用的なツール名がほかのサーバーと衝突する
おすすめの人
アシスタントに売上、注文、カタログのデータを照会させたい Square の販売者と開発者。
Square MCP Serverの代替
Square MCP Server：よくある質問
- Square MCP Serverは使う価値があるか？
- Square の API 全体を 3 つのツールの背後に収めています。売上データを読むには巧みですが、ベータ版のバグが残っている間は、お金を動かす操作には危険です。 評価は5点満点中3.6点です。
- Square MCP Serverの料金は？
- 無料のオープンソース（Apache-2.0）です。通常の Square の 手数料がかかります。
- Square MCP Serverの欠点は？
- ベータ版で、npm パッケージは 2025年4月から変わっていない; ホスト型サーバーは本番専用で、読み取り専用のスイッチがない; 未解決のバグ：配列パラメーターの欠落、二重請求のおそれがある冪等性の記述; 汎用的なツール名がほかのサーバーと衝突する.
- Square MCP Serverは誰に向いているか？
- アシスタントに売上、注文、カタログのデータを照会させたい Square の販売者と開発者。
- チームや本番環境でSquare MCP Serverを使うと費用はいくらか？
- サーバーは Apache-2.0 で無料です。作成された決済には Square の標準の決済手数料がかかります。1 つの操作には通常 2、3 回の呼び出し（探索、型の確認、リクエスト）が必要なので、タスクあたりのトークン使用量は専用ツールより多くなります。MCP のドキュメントにレート制限は公開されていません。
- Square MCP Serverは企業データを扱っても安全か？
- ホスト型サーバーは OAuth を通じて本番の実データに対して動作します。ドキュメントにはスコープも保持の条件も記載がありません。ローカルサーバーはアクセストークンを自分のマシンに保持し、DISALLOW_WRITES=true で読み取り専用にできます。
- Square MCP Serverの代わりになるものは？
- 当サイト でレビューした中で最も近い代替はStripe MCP, PayPal MCP Server 、 Shopify Dev MCPです。
回答確認日：2026年10月23日