Loyverse MCP by usefulapi

usefulapi による Loyverse MCP

Claude、Cursor、または任意の MCP クライアントから Loyverse を利用できます。レシート、シフト、アイテム、在庫、顧客を確認し、顧客、カテゴリ、仕入先、在庫数を更新できます。 ローカルへのインストールは不要です。ご自身の Loyverse 認証情報を使って接続できます。

ライブエンドポイント： https://loyverse.usefulapi.io/mcp · ホームページ： https://usefulapi.io/loyverse

接続

• Claude（claude.ai、Desktop）：Customize → Connectorsを開き、+ Add → Add custom connectorをクリックして、https://loyverse.usefulapi.io/mcpを貼り付けます。
• Claude Code： claude mcp add --transport http loyverse https://loyverse.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。
• VS Code： VS Code に追加。
• Cursor およびその他のクライアント： URL をリモート MCP サーバーとして追加します。

{
  "mcpServers": {
    "loyverse": {
      "url": "https://loyverse.usefulapi.io/mcp"
    }
  }
}

URL のみを追加してください。クライアント設定にAuthorizationヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインを行い、ログインページで Loyverse の認証情報を求めます。

ステップごとの設定方法、認証情報の確認場所、よくある質問：https://usefulapi.io/loyverse/

初回接続時に、Loyverse 個人用アクセストークン（Back Office > Integrations > Access tokens）を入力します。 トークンは検証され、ユーザーごとに保存されます。また、ご自身のアカウントに限定されます。設定ファイルにキーを記載する必要はありません。

ツール

ツール	種類	機能
loyverse_get_merchant	読み取り	店舗情報を取得
loyverse_list_stores	読み取り	店舗一覧を取得
loyverse_list_employees	読み取り	従業員一覧を取得
loyverse_list_receipts	読み取り	レシート一覧を取得
loyverse_get_receipt	読み取り	レシートを1件取得
loyverse_list_shifts	読み取り	シフト一覧を取得
loyverse_list_items	読み取り	アイテム一覧を取得
loyverse_get_item	読み取り	アイテムを1件取得
loyverse_list_variants	読み取り	アイテムのバリエーション一覧を取得
loyverse_list_categories	読み取り	カテゴリ一覧を取得
loyverse_list_inventory	読み取り	在庫数一覧を取得
loyverse_list_customers	読み取り	顧客一覧を取得
loyverse_get_customer	読み取り	顧客を1人取得
loyverse_list_payment_types	読み取り	支払い方法一覧を取得
loyverse_list_discounts	読み取り	割引一覧を取得
loyverse_list_taxes	読み取り	税一覧を取得
loyverse_list_suppliers	読み取り	仕入先一覧を取得
loyverse_upsert_customer	書き込み	顧客を作成または更新
loyverse_upsert_category	書き込み	カテゴリを作成または更新
loyverse_upsert_supplier	書き込み	仕入先を作成または更新
loyverse_set_inventory_levels	書き込み	在庫数を設定
loyverse_usage_status	メタ	使用状況（無料枠の使用量）を表示
loyverse_request_feature	メタ	不足している機能をリクエスト
loyverse_upgrade	メタ	Pro にアップグレード（無制限*）
loyverse_cancel_subscription	メタ	Pro サブスクリプションを解約

readツールは読み取り専用です。writeツールはデータを変更するため、クライアント側で実行前に確認してください。metaツールは使用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。

料金

プラン	料金	上限
無料	$0	月50回のツール呼び出し
Pro（ユーザーごと）	$9/mo または $90/yr（2か月分無料）	無制限*

*Pro には、このサーバーで月10,000回のツール呼び出しというフェアユース上限があります。それ以上必要な場合は、[email protected] までご連絡ください。

Pro の対象はこのサーバーのみです。loyverse_upgradeでサブスクリプションに登録します（Stripe Checkout のリンクが返されます）。解約はいつでもloyverse_cancel_subscriptionで行えます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。また、期間終了前にloyverse_upgradeを実行すると、解約が取り消されます。[email protected] へのご連絡でも解約できます。

ライセンス

MIT © usefulapi。Loyverse とは提携しておらず、Loyverse による承認も受けていません。