Claude Square連携の使い方 — 接続手順とできること
Claude Square連携の接続手順と、権限が3層に分かれる仕組み。ディレクトリのコネクタが本番データだけに触る点、ツールが3つだけ見える点まで解説します。
Claude Square連携とは
Claude Square連携は、決済サービスのSquare, Inc.自身が開発するコネクタです。Anthropicのコネクタディレクトリに「Anthropic verified」付きで掲載され、カテゴリは「Financial services」、サインインが必須で、追加は2025年11月です。取引・顧客プロファイル・在庫・決済・売上の分析といったSquareの商取引データを、チャットから参照し操作できます。
接続先はSquareが運用するリモートのMCPサーバー(https://mcp.squareup.com/mcp)です。Squareの開発者ドキュメントでは、このサーバーはベータ版と案内されています。つまずきやすいのは機能の多さより、本番データに直接つながる点と、権限が3か所に分かれている点です。以下では接続の流れ、権限の仕組み、症状別の対処の順に説明します。
ディレクトリに載るツールは3つだけ
ディレクトリのページに載っているツールは、get_service_info(Squareのサービス情報の取得)、get_type_info(Square APIの型情報の取得)、make_api_request(Square APIへのリクエスト送信)の3つです。
説明文が挙げる取引・顧客・在庫・決済・売上の操作は、請求書発行や在庫確認のように個別のツールとして並んでいるわけではありません。Squareのドキュメントによると、このサーバーはSquare APIプラットフォーム全体への橋渡しで、顧客・注文・商品などへのアクセスを提供します。つまり「何ができるか」は、ツールの数ではなくSquare API側の範囲で決まります。
Squareのアカウントでできる操作を、まずSquareの管理画面側で把握しておくと依頼文を組み立てやすくなります。ディレクトリページ自体は、開発者が公開するツールをAnthropicが管理していない点も注意書きとして載せています。
接続手順
Square連携を使い始めるまで
- 1
ディレクトリでSquareを選ぶ
コネクタのディレクトリからSquareを探し、「Connect」を押します。
- 2
Squareアカウントでサインインする
認証画面に従い、Squareのアカウントでサインインしてアクセスを許可します。
- 3
要求されるアクセスを確かめる
ディレクトリのコネクタでは、接続の途中でサービスが求めるアクセスの内容が表示されます。決済データを扱うので、ここは読んでから進めます。
- 4
会話ごとに有効にする
チャット左下の「+」(または「/」)から「Connectors」を開き、Squareをオンにします。会話ごとにオンにする点は、接続の後も変わりません。
Team・Enterpriseプランでは順序が変わります。組織のOwnerまたはPrimary Ownerが先にコネクタを有効にする必要があり、有効化は利用可能にするだけで、メンバーへのアクセスの自動付与にはなりません。メンバーは有効化のあとに、各自でサインインします。ベータ提供のEnterprise-managed authを使うと、組織で1回承認するだけで、メンバーは初回ログイン時にアクセスを引き継ぎます。
接続状態のコネクタを後から整えるときは、サービスごとに切断・接続設定の変更・権限と範囲の確認ができます。コネクタ全般の仕組みはClaude Connectorsとはにまとまっています。
ページごとに説明が分かれる箇所
Claudeのヘルプ(Use connectors to extend Claude's capabilities)とSquareの開発者ドキュメントでは、画面の呼び方が一致しません。
| 場面 | Claudeのヘルプ | Squareの開発者ドキュメント |
|---|---|---|
| 組織への追加(Team) | ClaudeのヘルプOrganization settings > Connectors > Browse connectors > Add to your team | Squareの開発者ドキュメントSettings > Integrations > Add moreに、サーバーのURLを入力 |
| 組織への追加(Enterprise) | Claudeのヘルプ同上 | Squareの開発者ドキュメントSettings > Data management > Integrations > Add more |
| チャットでの接続・有効化 | Claudeのヘルプ「+」からConnectorsを開いてオンにする | Squareの開発者ドキュメント「Search and tools」メニューでConnect、同じメニューで個別のSquareツールを有効化 |
Squareのドキュメントは、サーバーのURLを自分で入力する手順です。Claudeのヘルプは、ディレクトリから「Add to your team」で追加する手順です。メニュー名が見つからないときは、もう一方の呼び方でも探します。
権限は3か所で決まる
Claudeはサインインしたユーザー自身のSquare権限をそのまま引き継ぎます。そのアカウントで見えない取引や顧客データには、Claude経由でもたどり着けません。Team・Enterpriseでは権限がユーザー単位で適用されるため、同じ組織でも店舗スタッフと経理担当ではClaudeから見える範囲が変わります。Squareのロール設計がそのままClaudeの上限になります。
権限を握っている場所
Square側
Squareアカウントがその操作の権限を持っているか。Claudeで許可しても、ここを超えて広がることはありません。
Claude側(Tool permissions)
「Customize > Connectors」でSquareを選ぶと、ツールの権限が種類ごとのカテゴリ(例: 読み取り専用、書き込み・削除)に分かれて並びます。それぞれ「Always allow」「Needs approval」「Blocked」から選べます。
Claude側の設定は、個人の画面だけでなく組織単位でも使えます。Team・Enterpriseでは、Ownerが組織全体に対して書き込みだけを止めて読み取りだけ許可する、といった一律の制限をかけられます。この制限は個々のメンバーが上書きできません。
請求書の発行や決済の処理のように取り消しにくい書き込みは、「Needs approval」にしておく選択肢があります。Squareのツールは3つだけで、実行は make_api_request に集約されるため、読み取りと書き込みがカテゴリとして分かれない場合もあります。表示されたカテゴリに合わせて選び、動作に慣れてから範囲を広げる進め方も取れます。
本番だけに触る点
Squareのドキュメントによると、リモートのMCPサーバーが触れるのは本番のリソースだけで、サンドボックスには届きません。サンドボックスで試すには、手元でローカルのSquare MCPサーバーを起動します。環境変数 SANDBOX を true にし、サンドボックスのアクセストークンを ACCESS_TOKEN に渡す構成です。Squareは、本番で使う前にサンドボックスのアカウントで依頼文を試すことを勧めています。ローカルサーバーなら、環境変数 DISALLOW_WRITES を true にして読み取り専用の操作に制限することもできます。
Claude Desktopでローカルサーバーを使う設定は、Squareのドキュメントでは次の形です。
{
"mcpServers": {
"mcp_square_api": {
"command": "npx",
"args": ["square-mcp-server", "start"],
"env": {
"ACCESS_TOKEN": "YOUR_SQUARE_ACCESS_TOKEN",
"SANDBOX": "true"
}
}
}
}ソースコードはSquareのGitHubリポジトリ(square-mcp-server)で公開されており、不具合報告はそのissueで受け付けています。ディレクトリのコネクタをつなぐと、依頼文のテストも本番の売上や顧客に対して走ります。決済や請求書の発行を含む依頼文は、実際の顧客に届く操作になります。試し打ちの段階では、読み取り専用の依頼から始めると影響が出にくくなります。
通信は暗号化され、Claudeに同期できるのは元のサービスで見る権限のある範囲だけです。コネクタ先のサービスは自社のインフラ上、自社の規約のもとでデータを処理します。処理場所が米国外になる場合もあり、Enterpriseの「US-only inference」はこの処理場所を変えません。
依頼文は読み取りと書き込みを分けて書く
実行がSquare APIへのリクエストに集約されるため、依頼文では対象・期間・読み取りか書き込みかを分けて書くと、意図しない操作を避けられます。たとえば次のように、集計だけを頼む文と、変更を伴う文は別の依頼にします。
- 読み取り:「先月の注文を商品別に集計し、売上の多い順に3件挙げて」
- 書き込み:「顧客Aさん宛てに、金額と明細を示した請求書の下書きを作って。送信はまだしないで」
後者のように変更の前で止める指示を添えると、「Needs approval」の承認画面と合わせて二重に確認できます。書き込みの依頼は、実行前に対象の顧客・金額・件数をClaudeに復唱させてから進めると、取り違えに気づきやすくなります。
Claude CodeやClaude Desktopの設定ファイルから使う
ディレクトリ経由ではなく、設定ファイルでSquareのサーバーを登録する方法もあります。Claude Codeでは、v2.1.289の claude mcp add --help に、リモートのHTTPサーバーを追加する書式が載っています。
# claude mcp add --help の例を Square に置き換えた形
claude mcp add --transport http square https://mcp.squareup.com/mcp同じヘルプには、OAuthのクライアントIDを渡す --client-id や、コールバックのポートを固定する --callback-port も並んでいます。Squareのドキュメントは、OAuthでサインインするリモートサーバーを推奨し、アクセストークンの手動管理が不要で権限の粒度も細かいと説明しています。
Claude Desktopでは、claude_desktop_config.json にリモートサーバーを書く方法がSquareのドキュメントに載っています。次の設定は mcp-remote 経由でOAuthのサインインを行います。
{
"mcpServers": {
"mcp_square_api": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.squareup.com/mcp"]
}
}
}Squareは、悪意あるクライアント登録を防ぐためにMCPクライアントの許可リストを持っています。リストにないクライアントを追加してほしいときは、Squareの開発者フォーラムで依頼する形です。
決済や請求書を扱う自動化を組むときの考え方は、Coworkで経理業務を自動化するにもあります。書き込み系のツールを含む処理は、承認設定を残したまま試してから範囲を広げる流れになります。
症状から探す
ディレクトリで見当たらない。Squareはコネクタのディレクトリに載っているので、検索窓に「Square」と入れるか「Financial services」カテゴリから探します。
書き込み操作だけ失敗する。「Customize > Connectors」のTool permissionsで、Squareの項目が「Blocked」か「Needs approval」のままになっていないかを見ます。許可されていれば、次はSquareアカウント自体にその権限があるかです。
Claudeで許可したのに操作できない。Squareの権限はClaude側の設定で上書きできません。Squareの管理画面で、そのユーザーに該当操作の権限があるかを確かめます。
スマートフォンで使えない。WebまたはDesktopのClaudeで接続すると、次回ログイン時からiOS・Androidアプリでも使えます。モバイルからの接続はベータ提供です。
会話を共有できない。Team・Enterpriseプランでは、コネクタを使えるのは非公開のプロジェクトだけで、同期した内容を含むチャットは共有できません。
認証が失敗する。通信環境とSquareアカウントの有効状態を確かめ、それでも直らなければ接続を解除して接続し直します。サービス側のアカウント種別や権限の要件も合わせて見直します。
よくある質問
Freeプランでも接続できますか
接続できます。Webコネクタは、Claude・Cowork・Claude Desktop・Claude Mobileの全ユーザーが対象です。
まとめ
Claude Square連携は、本番のSquareアカウントに直接つながるため、読み取り専用の依頼から始め、取り消しにくい書き込みは承認を挟んでから範囲を広げると影響を抑えられます。最初の一回はサンドボックスで依頼文を試し、本番に移ってからも読み取りの依頼で動きを見る順番だと、取り違えに気づきやすくなります。ほかの連携先を比べたいときは、Claude中小企業向けConnectorおすすめ3選が手がかりになります。