インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Lightspeed Retail (X-Series) をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
1 つのストアの Lightspeed Retail X-Series（旧 Vend）：店舗（アウトレット）、レジとレジ締めの集計、日付による販売検索、商品と商品ファミリー、カテゴリ、ブランド、仕入先、価格表、プロモーション、在庫数、在庫調整、コンサインメントと発注書、顧客、ストアクレジット、ギフトカード。返品と削除はインストール時にオフです。
こう聞いてみよう
Lightspeed Retail (X-Series) のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Lightspeed Retail (X-Series) をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Lightspeed Retail (X-Series) + Cursor
1 つのストアの Lightspeed Retail X-Series（旧 Vend）：店舗（アウトレット）、レジとレジ締めの集計、日付による販売検索、商品と商品ファミリー、カテゴリ、ブランド、仕入先、価格表、プロモーション、在庫数、在庫調整、コンサインメントと発注書、顧客、ストアクレジット、ギフトカード。返品と削除はインストール時にオフです。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
LIGHTSPEED_DOMAIN_PREFIX, LIGHTSPEED_PERSONAL_TOKEN
ステップ 1 — 認証情報を取得
X-Series 専用: このコネクタは、旧 Vend である Lightspeed Retail (X-Series) API の日付バージョン 2026-10 を、1 つのストアの https://<domain_prefix>.retail.lightspeed.app/api/2026-10 で使います。別の API を持つ Lightspeed Retail R-Series と Lightspeed Restaurant には対応していません。
設定は約 2 分です。パーソナルトークンには Plus プラン以上と管理者ユーザーが必要です。
- 管理者として Retail POS のバックオフィスで Setup、Personal tokens を開き、Add personal token をクリックします。名前を付け（必要なら有効期限も設定し）、トークンを生成してコピーします。
- それを
LIGHTSPEED_PERSONAL_TOKENに貼り付けます。Authorization: Bearer <token>として送信され、作成したユーザーとして動作します。 LIGHTSPEED_DOMAIN_PREFIXにストアのアドレスの最初の部分を設定します。https://mystore.retail.lightspeed.appならmystoreです。- コネクタをインストールし、
lightspeed_retail_get_retailerを実行します。ストアの名前、通貨、タイムゾーンが表示され、トークンが確認できます。
ストアの設定: lightspeed_retail_get_retailer、lightspeed_retail_get_current_user、店舗（アウトレット）は lightspeed_retail_list_outlets と lightspeed_retail_get_outlet、レジは lightspeed_retail_list_registers と lightspeed_retail_get_register、lightspeed_retail_get_register_payments_summary（レジ締めに使う、開いているシフトの支払い方法ごとの予定額と現金の出し入れ）、支払い方法、税、ユーザー（スタッフ）、シフトです。
販売: 期間、店舗、レジ、顧客、レシート番号で探すときは、AI は lightspeed_retail_search を type: sales と date_from/date_to 付きで使います。通常の一覧は日付を無視します。lightspeed_retail_list_sales はすべての販売をバージョン順にたどり（同期用）、lightspeed_retail_get_sale は明細、支払い、顧客、ユーザー、レジ付きで 1 件の販売を読み取ります。
カタログ: lightspeed_retail_list_products（1 商品なら sku）、lightspeed_retail_get_product、lightspeed_retail_get_product_family、lightspeed_retail_get_product_family_of_product。バージョン 2026-10 以降、商品ファミリーが共通データ（名前、ブランド、カテゴリ、タグ）を持ち、各商品がバリエーションごとのデータ（コード、価格、仕入先）を持ちます。参照データ：カテゴリ、旧来の商品タイプ、ブランド、タグ、仕入先、価格表（price book）、プロモーション。
在庫: lightspeed_retail_list_inventory_levels は商品と店舗ごとの在庫数、平均原価、発注点、発注量を返し、フィルター、並べ替え、発注リスト用の to_be_procured_only が使えます。lightspeed_retail_get_product_inventory_levels は 1 商品の全店舗の在庫を、lightspeed_retail_list_inventory_records と lightspeed_retail_list_stock_adjustments は元の在庫レコードと在庫調整を一覧にします。仕入先への発注、店舗間移動、仕入先への返品、棚卸しはコンサインメントです：lightspeed_retail_list_consignments、lightspeed_retail_get_consignment、lightspeed_retail_list_consignment_products（発注数と入荷数）。発注書は lightspeed_retail_list_purchase_orders と lightspeed_retail_get_purchase_order で読み取ります。
顧客: AI は lightspeed_retail_search（type: customers、メール、名前、コード、電話番号）で顧客を見つけ、lightspeed_retail_get_customer（ロイヤルティ残高、ストアクレジット、売掛残高、年初からの購入額）を読み取ります。ほかに lightspeed_retail_list_customers、lightspeed_retail_list_customer_groups、lightspeed_retail_get_customer_store_credit、ギフトカードは lightspeed_retail_list_gift_cards と lightspeed_retail_get_gift_card です。
書き込める内容: lightspeed_retail_create_sale は販売を記録します（state が closed なら完了、parked か pending なら後で使うために保存）。lightspeed_retail_update_sale は保留中または未完了の販売を変更・完了し、販売全体を置き換えるため、AI は先に読み取ります。商品は lightspeed_retail_create_product_family、lightspeed_retail_add_products_to_family（新しいバリエーション）、共通データは lightspeed_retail_update_product_family、価格、コード、仕入先、店舗ごとの税、在庫設定は lightspeed_retail_update_product です。さらに lightspeed_retail_create_supplier、lightspeed_retail_create_stock_adjustments（quantity は増減量で、減らすときは負の値。破損、盗難、発見在庫などの理由付き）、lightspeed_retail_create_consignment（OPEN 状態で作成され、商品は Lightspeed 上か後で追加）、lightspeed_retail_create_customer、lightspeed_retail_update_customer（first_name と last_name は必須）があります。販売と在庫調整は在庫とレポートにすぐ反映されるため、AI は明細と合計を見せてから了承を待ちます。
インストール時はオフ: lightspeed_retail_return_sale、lightspeed_retail_delete_product、lightspeed_retail_delete_customer です。元に戻せない操作のため、チームが必要なときにワークスペース管理者がオンにします。
データ形式: 応答はレコードを data で包みます。ID は UUID です。金額はストア通貨の小数です。販売には totals（税抜の price、tax、price_incl_tax）があり、各明細では pricing.price が税抜単価、pricing.total が割引後の明細合計、pricing.cost_total が原価、tax.amount と tax.total が単価あたりと明細全体の税額です。税率は小数です（0.2 = 20%）。時刻は UTC（ISO 8601）で、date_from/date_to は UTC、time_from/time_to は timezone と組み合わせた現地時刻を受け付けます。販売の state は closed、parked、pending（売掛または取り置き）、voided のいずれかです。
ページング: ほとんどの一覧はバージョンでページングします。応答の version には min と max があり、AI は max を after として渡して次のページを取得し、data が空になったら止めます。lightspeed_retail_search と lightspeed_retail_list_inventory_levels は offset、ギフトカードは before でページングします。
制限とよくあるエラー: レジ 1 台あたり 5 分間に約 300 リクエスト、プラス 50 までで、超えると Lightspeed は Retry-After 付きの 429 を返します。401 はトークンの誤りか期限切れ、またはドメインプレフィックスの誤りです。403 はトークンのユーザーにその操作が許可されていません。パーソナルトークンはそのユーザーとして動作するため、管理者でトークンを作成してください。すべての呼び出しで 404 になる場合は LIGHTSPEED_DOMAIN_PREFIX の誤り（.retail.lightspeed.app より前の部分だけを入力）、特定のレコードだけなら ID の誤りです。422 は検証エラーで、対象のフィールドが示されます。
インストール時にオンのツールでは、コネクタは返品処理を行わず、何も削除しません。発注書、価格表、プロモーション、ストアクレジット、ギフトカードは読み取るだけで変更しません。仕入先への新しい発注はコンサインメントとして作成します。
ステップ 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 — Cursor にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:
{
"mcpServers": {
"anythingmcp": {
"url": "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と置き換えます。 - ファイルを保存し、Cursor を再起動します。
- Cursor → Settings → MCP を開き、
anythingmcpが一覧にあり接続済みであることを確認します。 - チャットを始めましょう。エージェントが
Lightspeed Retail (X-Series)のツールを呼び出せるようになりました。
利用可能なツール
| Tool | What it does |
|---|---|
lightspeed_retail_get_retailer | Get the retailer (store account): name, domain prefix, currency, time zone, tax settings and loyalty settings |
lightspeed_retail_get_current_user | Get the user the personal token belongs to: name, email, account type (admin, manager, cashier) and the outlets they can use |
lightspeed_retail_list_outlets | List the outlets (store locations) with name, address, time zone, default tax and receipt settings |
lightspeed_retail_get_outlet | Get one outlet (store location) by id with its address, time zone, default tax and settings |
lightspeed_retail_list_registers | List registers (tills) with outlet, name, open or closed state, current register opening and invoice numbering |
lightspeed_retail_get_register | Get one register (till) by id with outlet, whether it is open and the current register opening (shift) |
lightspeed_retail_get_register_payments_summary | Get the payments summary of the current opening of one register: expected amounts per payment type, cash movements and totals, as used to… |
lightspeed_retail_list_payment_types | List payment types (cash, card, gift card, store credit, on account, custom) with their id and config |
lightspeed_retail_list_taxes | List sales taxes with name, rate (a fraction, 0.2 = 20%) and components |
lightspeed_retail_get_tax | Get one sales tax by id with its name, rate as a fraction (0.2 = 20%) and tax components |
lightspeed_retail_list_users | List users (staff) with name, email, account type and outlets |
lightspeed_retail_get_user | Get one user (staff member) by id with name, display name, email, account type and outlets |
lightspeed_retail_list_shifts | List staff shifts (clock in and clock out) with user, outlet, start and end time |
lightspeed_retail_list_products | List products (each sellable item or variant) with name, SKU and codes, prices, family, supplier codes and active state |
lightspeed_retail_get_product | Get one product by id: variant name, codes, prices including and excluding tax, family, measurements, suppliers, outlet taxes and inventory |
lightspeed_retail_get_product_family | Get a product family by id: name, description, classification (STANDARD, VARIANT, COMPOSITE), brand, category, tags and all member products |
lightspeed_retail_get_product_family_of_product | Get the product family a product belongs to, with all its sibling variants or composite components |
lightspeed_retail_create_product_family | Create a product family with its products: a STANDARD product, a VARIANT family (variant attributes, one product per variant) or a COMPOSITE |
lightspeed_retail_update_product_family | Update the shared data of a product family: name, description, brand, category, tags, inventory tracking or composite components |
lightspeed_retail_add_products_to_family | Add products (new variants) to an existing product family, each with its codes, variant attribute values and prices |
lightspeed_retail_update_product | Update one product: prices, codes, supplier codes and prices, outlet taxes, inventory settings, measurements or whether it is active in… |
lightspeed_retail_delete_product | Delete one product |
lightspeed_retail_list_product_categories | List the product category tree (id, name, parent and path) |
lightspeed_retail_list_product_types | List the legacy product types with id and name |
lightspeed_retail_list_brands | List the product brands of the store with id and name, paged by version |
lightspeed_retail_list_tags | List the product tags of the store with id and name, paged by version |
lightspeed_retail_list_suppliers | List suppliers with name, description, default markup and contact details |
lightspeed_retail_get_supplier | Get one supplier by id with contact person, email, phone, addresses, description and default markup |
lightspeed_retail_create_supplier | Create a supplier with a name, description, default markup and contact details (company, person, email, phone, address) |
lightspeed_retail_list_price_books | List price books (special prices per customer group, outlet and validity dates) with their settings |
lightspeed_retail_list_promotions | List promotions (discounts, buy X get Y, promo codes) with conditions, outlets, customer groups and validity dates |
lightspeed_retail_get_promotion | Get one promotion by id with its conditions, actions, outlets, customer groups, channels and validity dates |
lightspeed_retail_list_inventory_levels | List stock levels per product and outlet with counts, average cost, reorder point and amount |
lightspeed_retail_get_product_inventory_levels | Get the stock of one product in every outlet: current count, average cost, reorder point and reorder amount |
lightspeed_retail_list_inventory_records | List raw inventory records (product, outlet, count, reorder settings) by version, for one product or the whole store |
lightspeed_retail_list_stock_adjustments | List stock adjustments (damage, theft, stock found, internal use and custom reasons) with product, outlet, quantity and reason |
lightspeed_retail_create_stock_adjustments | Adjust stock up or down with a reason (damage, expiry, theft, internal use, donation, stock found, sample). quantity is the change… |
lightspeed_retail_list_consignments | List consignments: supplier orders, outlet transfers, returns and stocktakes, with status, outlet, supplier and dates |
lightspeed_retail_get_consignment | Get one consignment by id: type, status, outlet, source outlet or supplier, reference, due and received dates and cost and count totals |
lightspeed_retail_list_consignment_products | List the products of a consignment with ordered and received counts and cost, for checking a delivery or stocktake |
lightspeed_retail_create_consignment | Create a consignment: a supplier order, an outlet transfer, a supplier return or a stocktake, in OPEN status |
lightspeed_retail_list_purchase_orders | List purchase orders to suppliers with number, supplier, outlet, status, ordered and received totals |
lightspeed_retail_get_purchase_order | Get one purchase order by id with supplier, outlet, status, dates, totals and delivery information |
lightspeed_retail_list_sales | List sales by version (oldest changes first) with line items, payments, totals, customer, user, register and status |
lightspeed_retail_get_sale | Get one sale by id: invoice number, status, date, line items with price, discount, tax and cost, payments, customer, user and register |
lightspeed_retail_search | Search sales, products or customers |
lightspeed_retail_create_sale | Record a sale: line items with product, quantity, price and tax, payments and customer. state closed completes it, parked or pending saves… |
lightspeed_retail_update_sale | Update a parked or pending sale (lines, payments, customer, note) or complete it by setting state to closed |
lightspeed_retail_return_sale | Start a return (refund) of a closed sale: Lightspeed creates a return sale linked to the original on the register |
lightspeed_retail_list_customers | List customers by version with name, code, contact details, group, loyalty balance and on-account balance |
lightspeed_retail_get_customer | Get one customer by id: name, code, email, phone, addresses, group, loyalty balance, store credit and on-account balance and year to date… |
lightspeed_retail_create_customer | Create a customer with name, contact details, address, customer group, loyalty enrolment and marketing consent |
lightspeed_retail_update_customer | Update a customer: contact details, address, group, note, loyalty or marketing consent. first_name and last_name are required by the API |
lightspeed_retail_delete_customer | Delete a customer |
lightspeed_retail_list_customer_groups | List customer groups (e.g |
lightspeed_retail_get_customer_store_credit | Get the store credit of one customer: current balance and the list of store credit transactions (issued, redeemed, reversed) |
lightspeed_retail_list_gift_cards | List gift cards with number, balance, status (ACTIVE, REDEEMED, VOIDED, EXPIRED) and expiry, newest first |
lightspeed_retail_get_gift_card | Get a gift card by its card number with balance, status, expiry and the transactions (issue, redeem, reverse) |
プロンプトの例
- 「昨日の店舗ごとの売上を、税抜と税込で教えてください。」
- 「メインストリート店で発注点を下回っている商品はどれですか？ 仕入先ごとの発注リストを作ってください。」
- 「メールアドレス [email protected] の顧客を探して、ロイヤルティ残高とストアクレジットを見せてください。」
- 「メインストリート店の SKU TSHIRT-BLK-M について、理由を破損としてマイナス 3 の在庫調整を記録してください。保存する前に見せてください。」
- 「レシート番号 10452 の販売を、明細、割引、支払い付きで見せてください。」
FAQ
Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。
次のステップ
このガイドは役に立ちましたか?