インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Loyverse をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
Loyverse POS のバックオフィス：販売と返金のレシート、シフトと現金、バリエーション付きの商品、カテゴリ、モディファイア、割引、税、店舗ごとの在庫、ポイント会員の顧客、従業員、店舗、POS 端末、支払い方法、仕入先、Webhook。返金と削除はインストール時にオフです。
こう聞いてみよう
Loyverse のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Loyverse をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Loyverse + Gemini
Loyverse POS のバックオフィス：販売と返金のレシート、シフトと現金、バリエーション付きの商品、カテゴリ、モディファイア、割引、税、店舗ごとの在庫、ポイント会員の顧客、従業員、店舗、POS 端末、支払い方法、仕入先、Webhook。返金と削除はインストール時にオフです。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
LOYVERSE_ACCESS_TOKEN
ステップ 1 — 認証情報を取得
設定は約 2 分です。Loyverse アカウントのオーナーのログインが必要です。
- オーナーとして Loyverse Back Office にサインインし、Settings、Access tokens（
https://r.loyverse.com/dashboard/#/integrations/tokens）を開きます。プランによっては、アクセストークンは Integrations アドオンに含まれます。 - Add access token をクリックし、名前と、必要なら有効期限を入力して保存します。トークンをコピーします。
- それを
LOYVERSE_ACCESS_TOKENに貼り付けます。Authorization: Bearer <token>として送信され、アカウントへのフルアクセス権を持つため、外部に漏らさないでください。 - コネクタをインストールし、
loyverse_get_merchantを実行します。店舗名と通貨が表示され、トークンが確認できます。
コネクタは Loyverse POS のバックオフィス API である Loyverse API v1.0（https://api.loyverse.com/v1.0）と通信します。
読み取れるデータ: アカウントは loyverse_get_merchant（通貨と小数点以下の桁数）、店舗は loyverse_list_stores と loyverse_get_store、POS 端末は loyverse_list_pos_devices。販売は loyverse_list_receipts で店舗と期間（created_at_min/created_at_max）またはレシート番号で新しい順に取得し、明細、割引、税、支払い、従業員、顧客が含まれます。loyverse_get_receipt は番号で 1 枚のレシートを読み取ります。シフトと現金は loyverse_list_shifts と loyverse_get_shift（現金の出し入れ、予定現金と実際の現金、総売上と純売上、税、支払い方法別の支払い）。支払い方法は loyverse_list_payment_types と loyverse_get_payment_type。カタログは loyverse_list_items、loyverse_get_item、SKU、バーコード、店舗別価格を持つバリエーションは loyverse_list_variants（sku で検索）と loyverse_get_variant、さらにカテゴリ、モディファイア、割引、税、仕入先。在庫は loyverse_list_inventory がバリエーションと店舗ごとの in_stock を返します。顧客は loyverse_list_customers（email で検索）と loyverse_get_customer で、来店回数、累計購入額、ポイントが含まれます。従業員は loyverse_list_employees と loyverse_get_employee、Webhook は loyverse_list_webhooks です。
書き込める内容: loyverse_create_receipt は別の販売チャネルなど、ほかの場所で行われた販売を記録します。在庫管理対象の商品の在庫を減らし、レポートに計上され、支払いの合計がレシートの合計と一致する必要があります。保存ツールは id なしでレコードを作成し、id 付きで更新します：loyverse_save_item、loyverse_save_variant、loyverse_save_category、loyverse_save_discount、loyverse_save_tax、loyverse_save_customer（total_points でポイント残高を設定）。更新はレコード全体を置き換えるため、AI は先に読み取り、残したいすべてのフィールドを送ります。loyverse_set_inventory は stock_after に差分ではなく新しい絶対数量を受け取ります。loyverse_create_webhook は HTTPS の URL を 1 つのイベント（レシート、商品、顧客、在庫変動、締めたシフト）に登録します。イベントタイプと URL の組み合わせは一意である必要があります。レシートの作成や在庫の変更の前に、AI は明細、金額、新しい在庫数を見せてから了承を待ちます。
インストール時はオフ: loyverse_refund_receipt、loyverse_delete_item、loyverse_delete_customer です。元に戻せない操作のため、チームが必要なときにワークスペース管理者がオンにします。
データ形式: ID は UUID で、レシートは receipt_number（例 1-1001）で指定します。金額はアカウント通貨の小数です（loyverse_get_merchant を参照）。レシートの receipt_type は SALE か REFUND で、返金は正の金額で記録されるため、AI は売上を合計するときに差し引きます。cancelled_at は取り消されたレシートを示します。時刻はすべて UTC（ISO 8601）で、AI は日ごとに集計する前に店舗のタイムゾーンに変換します。Back Office で削除されたレコードは、show_deleted が true でない限り表示されません。
ページング: 一覧ツールは limit 件（既定 50、最大 250）と、続きがある間は cursor を返し、AI はそれがなくなるまで cursor として渡します。店舗、POS 端末、支払い方法、割引、税は一度にすべて返ります。
制限とよくあるエラー: アカウントごとに 300 秒あたり 300 リクエストまでで、超えると Loyverse は 429 RATE_LIMITED を返します。エラーは errors: [{code, details, field}] の形で返ります。401 UNAUTHORIZED はトークンの誤りか期限切れです。コピーし直すか新しいトークンを作成してください。402 PAYMENT_REQUIRED はサブスクリプションか、API を含むアドオンの期限が切れています。403 FORBIDDEN、404 NOT_FOUND は ID の誤り、400 INVALID_VALUE または MISSING_REQUIRED_PARAMETER は対象のフィールドが示されます。
インストール時にオンのツールでは、コネクタはレシートの返金を行わず、何も削除しません。店舗、POS 端末、支払い方法、従業員、モディファイア、仕入先は読み取るだけで作成や変更はせず、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" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、
geminiを再起動します。 - Gemini CLI で
/mcpを実行します（またはシェルでgemini mcp list）。anythingmcpが接続済みとして表示されるはずです。 - プロンプトを入力しましょう。Gemini CLI が
Loyverseのツールを呼び出せるようになりました。
利用可能なツール
| Tool | What it does |
|---|---|
loyverse_get_merchant | Get the Loyverse account (merchant) behind the token: business name, email, country and currency with its decimal places |
loyverse_list_stores | List the stores of the account with name, address, phone and description |
loyverse_get_store | Get one store by its id (UUID) with name, address, phone number and description, as shown in the Back Office |
loyverse_list_pos_devices | List the POS devices (registers) of the account, optionally for one store, with name, store id and whether the device is activated |
loyverse_list_receipts | List sales and refund receipts, newest first, with line items, discounts, taxes, payments, totals, store, employee, customer and POS device |
loyverse_get_receipt | Get one receipt by its receipt number (e.g. 1-1001) with all line items, modifiers, discounts, taxes, payments and the refund link |
loyverse_create_receipt | Record a sales receipt in Loyverse (e.g. a sale made in another channel) |
loyverse_refund_receipt | Create a refund receipt for some or all lines of a sales receipt |
loyverse_list_shifts | List closed cash register shifts with opening and closing time, cash movements, expected and actual cash, gross and net sales, taxes and… |
loyverse_get_shift | Get one shift by id with cash drawer amounts, cash movements, sales totals, taxes and payment totals per payment type |
loyverse_list_payment_types | List payment types (cash, card, check and custom ones) with their id and type |
loyverse_get_payment_type | Get one payment type by id with its name, type (CASH, NONINTEGRATEDCARD, CHECK, OTHER and so on) and stores |
loyverse_list_items | List items of the catalog with category, taxes, modifiers, options and their variants (SKU, barcode, cost, default price and price per… |
loyverse_get_item | Get one item by id with its variants, prices per store, category, tax ids, modifier ids, stock tracking and composite components |
loyverse_save_item | Create an item, or update it when id is given (Loyverse upserts with POST) |
loyverse_delete_item | Delete an item and its variants from the catalog |
loyverse_list_variants | List item variants with SKU, barcode, option values, cost, default price and per-store price and availability |
loyverse_get_variant | Get one item variant by id with SKU, barcode, option values, cost and the price and availability in each store |
loyverse_save_variant | Create a variant of an existing item, or update it when variant_id is given (upsert with POST) |
loyverse_list_categories | List item categories with name and colour |
loyverse_get_category | Get one item category by id (UUID) with its name, colour and creation and deletion times |
loyverse_save_category | Create an item category, or rename or recolour it when id is given (Loyverse upserts with POST) |
loyverse_list_modifiers | List modifiers (e.g |
loyverse_list_discounts | List discounts with type (fixed or variable, percent or amount, by points), value, stores and whether access is restricted |
loyverse_get_discount | Get one discount by id (UUID) with its type, amount or percent, stores and restricted access flag |
loyverse_save_discount | Create a discount, or update it when id is given (upsert with POST) |
loyverse_list_taxes | List taxes with rate, type (included in the price or added to it) and stores |
loyverse_get_tax | Get one tax by id (UUID) with its name, rate in percent, type (INCLUDED or ADDED) and stores |
loyverse_save_tax | Create a tax, or update it when id is given (upsert with POST) |
loyverse_list_suppliers | List suppliers with contact name, email, phone, website, address and note |
loyverse_list_inventory | List stock levels per item variant and store (in_stock) |
loyverse_set_inventory | Set the stock of item variants in stores. stock_after is the new absolute quantity, not a change: read the current level first and confirm… |
loyverse_list_customers | List loyalty customers with contact details, customer code, note, first and last visit, total visits, total spent and points balance |
loyverse_get_customer | Get one customer by id with contact details, address, customer code, visits, total spent and loyalty points |
loyverse_save_customer | Create a customer, or update one when id is given (upsert with POST). total_points sets the loyalty balance |
loyverse_delete_customer | Delete a customer with their loyalty points |
loyverse_list_employees | List employees with name, email, phone, role and the stores they work in |
loyverse_get_employee | Get one employee by id (UUID) with name, email, phone number, owner flag and the stores they work in |
loyverse_list_webhooks | List the webhooks of the account with event type, target URL and status (ENABLED or DISABLED after failed deliveries) |
loyverse_create_webhook | Subscribe an HTTPS URL to one event: receipts, items, customers or inventory changes, or closed shifts |
プロンプトの例
- 「昨日の店舗ごとの純売上を、返金を差し引いて教えてください。」
- 「ダウンタウン店の最後に締めたシフトを、予定現金と実際の現金付きで見せてください。」
- 「ダウンタウン店で在庫が 5 個未満のバリエーションはどれですか？」
- 「ダウンタウン店の SKU LATTE-CUP-12 の在庫を 200 に設定してください。先に現在の在庫数を見せてください。」
- 「メールアドレス [email protected] の顧客を探して、来店回数、累計購入額、ポイントを見せてください。」
FAQ
Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。
次のステップ
このガイドは役に立ちましたか?