MCP 経由で Square を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Square をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Square + Gemini

AI に Square のビジネスで作業させます。支払い、返金、注文の確認、顧客の管理、商品カタログの検索と編集、在庫の確認、請求書の作成と送信、店舗とチームメンバーの確認ができます。サンドボックスでも本番環境でも、自分のアクセストークンで接続します。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

SQUARE_ACCESS_TOKEN, SQUARE_API_URL

ステップ 1 — 認証情報を取得

1. developer.squareup.com/apps に Square アカウントでサインインし、Create an application をクリックします（名前は何でもかまいません）。
2. アプリケーションを開き、Credentials に進みます。上部の切り替えで Sandbox と Production を切り替えられます。
3. 使いたい環境の Access token の横にある Show をクリックしてトークンをコピーし、Bearer という語やスペースを付けずに SQUARE_ACCESS_TOKEN に貼り付けます。
4. SQUARE_API_URL には、サンドボックスのトークンなら https://connect.squareupsandbox.com、本番のトークンなら https://connect.squareup.com を、末尾のスラッシュなしで設定します。トークンは自分の環境でしか使えません。
5. コネクターをインストールし、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 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Square のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「昨日メインの店舗で受け取った支払いと、そのうち返金されたものがあるか教えて。」
• 「顧客 [email protected] を探して、過去 3 か月の注文を見せて。」
• 「Espresso Blend 1 kg の在庫は各店舗にいくつある？」
• 「Acme 株式会社宛てに、コンサルティング 3 時間（1 時間 90 EUR）、支払期限 11 月 1 日の請求書を作成して、送る前に内容を見せて。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続