Square MCP リモートMCPサーバー – 公式URL・MCP接続設定・ツール一覧

🛡️ Official✓ VerifiedHTTP + SSEOAuth 2.1🛡️ A+~299 tok4 tools·Online26ms·30日間稼働率: 100%·最終チェック たった今

Square MCP は Block / Square が提供するリモートMCPサーバー(公式運営、カテゴリ:決済・請求・コマース)です。エンドポイント https://mcp.squareup.com/mcp を通じて、AIエージェントが直接呼び出せる 4 個の構造化ツールを提供します。

このページでは、公式リモートエンドポイント、トランスポート、認証方式、全ツールスキーマ、リアルタイムの死活監視・セキュリティ監査結果を掲載し、Cursor・Claude Code・VS Code・ChatGPT など 10 のクライアントへのMCP接続手順を解説します。

https://mcp.squareup.com/mcp
SSEhttps://mcp.squareup.com/sse
提供元
Block / Square ↗
カテゴリ
💳 決済・請求・コマース
HTTP + SSEhttps://mcp.squareup.com/mcp
Legacy SSE endpoint
SSEhttps://mcp.squareup.com/sse
Install in Cursor →

Or add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "square": {
      "url": "https://mcp.squareup.com/mcp"
    }
  }
}

🧰 Square のMCPツールとスキーマ(4)

ToolSafetyDescriptionParameters
list_payments
~70 tok
🟢 ReadList payments taken by the Square seller account.beginTime: stringlocationId: string
search_orders
~69 tok
🟢 ReadSearch Square orders with filters.locationIds: arrayquery: string
list_catalog_items
~51 tok
🟢 ReadList items in the Square catalog.cursor: string
create_payment_link
~89 tok
🟠 WriteCreate a Square checkout payment link.description*: stringamount*: numbercurrency: string

🛡️ セキュリティ評価・品質・コンテキスト監査

🛡️ セキュリティ評価 A+コンテキスト消費トークン: ~299 tokens(このサーバーの 4 ツール定義が毎回のシステムプロンプトに注入)

呼び出しあたりのトークンコストを試算 →

  • No prompt-injection or hidden-character anomalies detected in tool descriptions
  • Streamable HTTP primary endpoint (current 2025-03-26 transport)
  • OAuth 2.1 with PKCE S256 enforced
  • Official first-party endpoint operated by the vendor
  • Manually verified by RemoteMCP.net

🔐 OAuth 2.1 とセキュリティ

認証方式
OAuth 2.1
動的クライアント登録(DCR)
✅ 対応
PKCE S256
✅ 対応
Scopes
PAYMENTS_READORDERS_READITEMS_READPAYMENTS_WRITE
保護リソースメタデータ
https://mcp.squareup.com/.well-known/oauth-protected-resource
OAuth 2.1 設定を監査 →

📡 公式リモートエンドポイントとトランスポート

リモートエンドポイント https://mcp.squareup.com/mcp は Streamable HTTP(2025-03-26 仕様) を採用。旧クライアント向けに SSE エンドポイント https://mcp.squareup.com/sse も併設されています。Streamable HTTP は単一の POST エンドポイントで JSON-RPC の双方向通信を完結する現行推奨トランスポートで、npx mcp-remote ブリッジなしに Claude・Cursor・VS Code などへ URL だけでMCP接続できます。

接続前にエンドポイントを オンライン MCP Inspector に貼り付けて initialize / tools/list のハンドシェイクを確認することを推奨します。

🔐 認証・権限フロー

認証方式は OAuth 2.1 です。初回接続時にクライアントが 401 チャレンジを受け取り、WWW-Authenticate ヘッダーから RFC 9728 の保護リソースメタデータを解決。続けて認可サーバー発見(RFC 8414)、動的クライアント登録(DCR)、PKCE S256 によるブラウザ認可が自動で行われます。ブラウザで一度承認するだけで、キーの手動貼り付けは不要です。

🛡️ コンテキスト消費とセキュリティ監査

このサーバーには現在 4 個のツールが登録されており、定義の合計は約 299 トークン。リクエストごとにモデルのシステムプロンプトへ注入されます。セキュリティ評価は A+(公式運営ソース)。ツール名とスキーマが簡潔なほどコンテキストウィンドウへの「税」は低くなります。feecalculator.app で呼び出しあたりのコストも試算できます。

🧩 主要クライアントへのMCP接続

Square MCP について、Cursor / Claude Code / VS Code / ChatGPT / Windsurf / Kiro / Codex / Cline / Gemini など 10 クライアント向けの設定を自動生成しています。ワンクリック deeplink、claude mcp add コマンド、JSON / TOML スニペットから選べます。代表的なツール:list_payments、search_orders、list_catalog_items、create_payment_link など。

📖 Square の詳細

Square MCP — Remote MCP Server

Square's remote MCP exposes seller-account data — payments, orders, catalog items — plus payment-link creation, using Square's standard OAuth 2.0 scopes. The primary endpoint speaks Streamable HTTP at /mcp, with a legacy /sse endpoint kept for older clients.

Official Square MCP Endpoint & Transport Architecture

  • Primary endpoint (Streamable HTTP): https://mcp.squareup.com/mcp
  • Legacy SSE endpoint: https://mcp.squareup.com/sse
  • Transport: Streamable HTTP + legacy SSE

Streamable HTTP is the current MCP transport (2025-03-26 spec): a single URL accepts JSON-RPC POSTs and may stream responses over SSE, so one endpoint serves both simple and streaming workloads. Square MCP also keeps a legacy HTTP+SSE endpoint for clients pinned to the 2024 spec — always prefer the Streamable HTTP URL when your client supports it.

Authentication, Scopes & Permission Boundaries

Square MCP uses OAuth 2.1 — the first request returns a 401 Unauthorized challenge with a WWW-Authenticate header pointing at the authorization metadata. Compliant clients (Cursor, Claude, VS Code, ChatGPT) handle the whole flow — PKCE and Dynamic Client Registration, so no manual client setup is needed — and simply open a browser consent screen.

Of the 4 cataloged tools, 3 are read-only and 1 can write or mutate state (create resources, run SQL, post messages). Grant access only to the accounts and projects you intend agents to act on, and prefer scoped credentials or a dedicated workspace where the provider supports them.

Common Troubleshooting & Connection Tips

  • 401 Unauthorized on connect — that's expected; the server is OAuth-protected. Let your client complete the browser consent flow, or inspect the endpoint in our OAuth debugger to see the exact WWW-Authenticate challenge.
  • Which URL should I use? Prefer https://mcp.squareup.com/mcp (Streamable HTTP). The SSE URL is only for older clients pinned to the pre-2025-03-26 spec.
  • "Session expired" / stale Mcp-Session-Id — just re-send initialize; stateless clients can ignore session headers entirely.
  • Prefer /mcp (Streamable HTTP); /sse exists only for clients pinned to the legacy SSE transport.
  • OAuth scopes follow Square's granular permission model.

🚀 Square MCP リモートMCPへの接続方法

  1. リモートエンドポイントを取得 — 公式エンドポイント https://mcp.squareup.com/mcp をコピーします。
  2. クライアント設定に追加 — Cursor の mcp.json / Claude Code CLI / 各クライアントに URLを追加します(下記クライアント別ガイド参照)。
  3. 認可して検証 — ブラウザで OAuth 認可を完了後、当サイトの Inspector で initialize と tools/list を実行して接続を確認します。

🔌 Square × クライアント別MCP接続ガイド

❓ よくある質問

Square MCP のリモートMCPサーバーは公式ですか?

このエントリは「公式運営」と表示されています。エンドポイントは Block / Square 公式が運営しています。掲載エンドポイントはすべて実際の MCP initialize ハンドシェイクで検証済みです。

Claude / Cursor で Square MCP にMCP接続するには?

リモートエンドポイント https://mcp.squareup.com/mcp をコピーします。Claude Code では claude mcp add --transport http square https://mcp.squareup.com/mcp を実行。Cursor ではワンクリック deeplink か ~/.cursor/mcp.json に { "mcpServers": { "square": { "url": "https://mcp.squareup.com/mcp" } } } を追加します。初回呼び出し時に OAuth 2.1 の認可画面が自動で開きます。

接続時に 401 が返る/キーを要求される場合は?

401 は OAuth 2.1 による正常なチャレンジです。クライアントが RFC 9728 メタデータに従って自動的に認可を行います。認可が途中で止まる場合は OAuth 2.1 Debugger で PRM / DCR / CORS の設定を確認してください。

ローカル stdio MCP とリモート MCP の違いは?

ローカル MCP は npx / uvx で起動する stdio 子プロセスで、ローカルランタイムが必要で API キーを平文で設定ファイルに書きます。リモート MCP は Block / Square がホストする HTTPS エンドポイントで、インストール不要・OAuth 2.1 対応・同一 URL をデスクトップとモバイルで共用できます。詳しくは ローカル vs リモート MCP 比較 をご覧ください。

🔗 関連するリモートMCPサーバー