概要
1つのサイトのためのSquarespace Commerce API:追跡付きの注文と履行、在庫レベルと在庫調整、製品とバリアント、顧客プロファイルと連絡先、そして金融取引。APIキーの保持者。
ガイド付きセットアップ
Squarespace Commerce を Gemini に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Squarespace Commerce を接続して、MCP URL を Gemini に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Squarespace Commerce のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスして使用してください。 サインインし、Connectors → Squarespace Commerceをクリックし、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Squarespace Commerce + Gemini
1つのサイトのためのSquarespace Commerce API:追跡付きの注文と履行、在庫レベルと在庫調整、製品とバリアント、顧客プロファイルと連絡先、そして金融取引。APIキーの保持者。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択したときにアプリ内ストアで表示されます)。このコネクタに必要な環境変数は次のとおりです:
SQUARESPACE_API_KEY
ステップ 1 — 認証情報を取得する
設定には約3分かかります。
- Squarespaceサイトにログインします。左側のナビゲーションでSettingsを開き、AdvancedまでスクロールしてDeveloper API Keysをクリックします。APIキーにはCommerce Advancedプランが必要です。
- Generate keyをクリックし、名前を付け、権限を選択します:Orders(履行のための読み取りと書き込み)、Inventory(在庫変更のための読み取りと書き込み)、Products(読み取り専用)、Profiles、Contacts、Transactions(読み取り専用)。
- キーを
SQUARESPACE_API_KEYにコピーします。Squarespaceはこれを一度だけ表示します;サイトがアクティブな間は期限切れになりません。
すべての呼び出しには、キーとUser-Agentヘッダーを持つAuthorization: Bearerが含まれ、これはSquarespaceが要求します。
開始する場所:squarespace_commerce_get_websiteでサイトを確認し、その後fulfillment_statusがPENDINGの squarespace_commerce_list_ordersで出荷する注文を取得します。
注文:squarespace_commerce_list_orders、squarespace_commerce_get_order、およびsquarespace_commerce_fulfill_order(追跡付きの出荷を追加し、注文を履行済みとしてマークします;顧客にメールを送信できます)。呼び出しには注文のidを使用します;orderNumberは顧客が見るものです。返金やキャンセルはAPIの一部ではありません。
在庫:squarespace_commerce_list_inventory、squarespace_commerce_get_inventory、squarespace_commerce_adjust_inventory。すべての調整には新しいidempotency_key(UUID)が必要です:同じキーを再送信しても何も起こらず、再試行が安全になります。
製品:squarespace_commerce_list_productsおよびsquarespace_commerce_get_products(Products API v2:タイプPHYSICAL、SERVICE、GIFT_CARD、DIGITAL;各バリアントの価格と在庫)。製品の変更は含まれていません。
人々:squarespace_commerce_list_contacts、squarespace_commerce_search_contacts、squarespace_commerce_get_contact(Contacts API)および古いsquarespace_commerce_list_profiles、squarespace_commerce_get_profiles(Profiles API、メンテナンスモードですが、顧客ごとの注文合計が表示されるものです)。
お金:squarespace_commerce_list_transactionsおよびsquarespace_commerce_get_transactionsは、注文または寄付ごとの支払い、返金、手数料を読み取ります;ここではお金は動きません。
ページングと日付:リストは最大50件のレコードを返し、pagination.hasNextPageおよびpagination.nextPageCursorを使用します;次のページを取得するにはカーソルのみを渡します。modified_afterとmodified_beforeは一緒に指定する必要があり、UTC ISO 8601形式です。金額はcurrencyとvalue(小数点文字列)を持つオブジェクトです。IDで取得するツールは、カンマで区切られた最大50のIDを受け取ります。
レート制限:キーごとに1分あたり300リクエスト;それを超えるとSquarespaceは429で応答し、キーを1分間ブロックします。
ステップ 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" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、
geminiを再起動します。 - Gemini CLI で
/mcpを実行します(またはシェルでgemini mcp list)。anythingmcpが接続済みとして表示されるはずです。 - プロンプトを入力しましょう — Gemini CLI が
Squarespace Commerceのツールを呼び出せるようになりました。
利用可能なツール
| ツール | 機能 |
|---|---|
squarespace_commerce_get_website | APIキーが属するSquarespaceサイトの基本情報を読み取ります:id、siteTitle、url、timeZone、currency、language、locationなど。 |
squarespace_commerce_list_orders | 注文をリストし、最も最近変更されたものを最初に表示します。1ページあたり50件:id、orderNumber、createdOn、modifiedOn、channel、customerEmail、customerIdなど。 |
squarespace_commerce_get_order | idで1つの注文を読み取ります:squarespace_commerce_list_ordersと同じフィールドで、すべてのラインアイテム、割引、内部メモ、履行を含みます。 |
squarespace_commerce_fulfill_order | 注文を履行済みとしてマークし、出荷日、運送業者、サービス、追跡番号、追跡URLを持つ出荷を追加します。should_send_notification… |
squarespace_commerce_list_inventory | すべての製品バリアントの在庫をリストします。1ページあたり50件:variantId、sku、descriptor(製品名とオプション)、isUnlimited、quantity。次へ… |
squarespace_commerce_get_inventory | 特定のバリアントのリアルタイム在庫を読み取ります:variantId、sku、descriptor、isUnlimited、quantity |
squarespace_commerce_adjust_inventory | 1回の呼び出しでバリアントの在庫を変更します:数量を増減、有限数量を設定、またはバリアントを無制限にします。必要です… |
squarespace_commerce_list_products | 製品をリストします。1ページあたり50件:id、type(PHYSICAL、SERVICE、GIFT_CARD、DIGITAL)、storePageId、name、description、url、urlSlug、tagsなど。 |
squarespace_commerce_get_products | 最大50の製品をidで読み取り、それらのバリアント、価格、在庫、属性、画像を取得します。 |
squarespace_commerce_list_profiles | プロファイル(顧客、メーリングリストの購読者、寄付者)をリストします。1ページあたり50件:id、firstName、lastName、email、hasAccount、isCustomerなど。 |
squarespace_commerce_get_profiles | 最大50のプロファイルをidで読み取ります:名前、email、住所、マーケティング同意、transactionsSummary |
squarespace_commerce_list_contacts | 連絡先(プロファイルの後継)をリストします:id、firstName、lastName、email、phone、createdOn、defaultShippingAddress、マーケティングなど。 |
squarespace_commerce_search_contacts | 名前またはメールテキストで連絡先を検索し、要求された順にソートします:squarespace_commerce_list_contactsと同じフィールド。読み取り専用ですが、これは… |
squarespace_commerce_get_contact | 1つの連絡先を読み取ります:名前、email、電話、住所、マーケティングの好み |
squarespace_commerce_list_transactions | 注文または寄付(ドキュメント)ごとにグループ化された金融取引をリストします。1ページあたり50件:id、createdOn、modifiedOn、customerEmail、salesOrderIdなど。 |
squarespace_commerce_get_transactions | 最大50の取引ドキュメントをidで読み取り、支払い、返金、手数料、ラインアイテムを含みます。読み取り専用 |
例のプロンプト
- "どのSquarespaceの注文がまだ履行を待っていますか?"
- "注文1047をUSPS追跡9400111899223197428490で履行し、顧客にメールを送信します。"
- "在庫が5未満の製品はどれですか?"
- "バリアントSKU MUG-WHT-12の在庫に20ユニット追加します。"
- "先月の取引と総処理手数料を表示します。"
FAQ
どのプランが必要ですか? Squarespace Developer APIキーにはCommerce Advancedプランが必要です。必要な権限でSettings、Advanced、Developer API Keysの下でキーを生成します;一度だけ表示されます。
何をカバーしていますか? 1つのSquarespaceサイト:追跡付きの注文と履行、在庫と在庫調整、製品とバリアント(読み取り)、顧客プロファイルと連絡先、そして金融取引。
どのツールがオフの状態でインストールされますか? なし。製品は読み取り専用で、注文を履行したり在庫を変更したりすることは、実行される前に表示されます。
Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。
次のステップ
このガイドは役に立ちましたか?