smaregi-api-skill

スマレジ API スキル

概要

smaregi-mcp（MCPサーバー）を通じてスマレジの全APIと連携。

このリファレンスは スマレジ Developer Platform の公開 API 仕様をもとに作成した独自ドキュメントです。スマレジ株式会社との公式な提携関係はありません。

このスキルの役割:

• スマレジ API の詳細リファレンスを提供（POS・在庫管理・ウェイター・受注出荷・タイムカード）
• smaregi-mcp 使用ガイドと API 呼び出し例を提供

セットアップ

認証設定

smaregi_configure ツールで契約ID・クライアントID・クライアントシークレットを設定。 環境変数（SMAREGI_CONTRACT_ID, SMAREGI_CLIENT_ID, SMAREGI_CLIENT_SECRET）でも設定可能。

確認

Claude 再起動後、smaregi_auth_status ツールで認証状態を確認。

リファレンス

API リファレンスが references/ に含まれます（全63ファイル）。各リファレンスにはエンドポイント、パラメータ、リクエストボディ、レスポンスの詳細情報があります。

目的のAPIを探すには、references/ ディレクトリ内のファイルをキーワード検索してください。

共通

• common-authentication.md - 認証（OAuth 2.0 Client Credentials）
• common-webhooks.md - Webhook

POS API

• pos-products.md - 商品
• pos-categories.md - カテゴリ
• pos-transactions.md - 取引
• pos-customers.md - 会員
• pos-customer-points.md - ポイント
• pos-stock.md - 在庫
• pos-stores.md - 店舗
• pos-staffs.md - スタッフ
• pos-payment-methods.md - 支払方法
• pos-coupons.md - クーポン
• pos-bargains.md - セール
• pos-layaways.md - 取り置き
• pos-terminals.md - 端末
• pos-daily-summaries.md - 日次精算
• pos-suppliers.md - 仕入先
• pos-roles.md - 役割
• pos-tax-rates.md - 税率
• pos-product-sets.md - セット商品
• pos-product-option-groups.md - オプショングループ
• pos-adjustments.md - 精算
• pos-divisions.md - 販売区分
• pos-discounts.md - 割引区分
• pos-receipt-provisoes.md - レシート特記事項
• pos-payment-method-groups.md - 支払方法グループ
• pos-store-divisions.md - 店舗区分

在庫管理API

• inventory-losses.md - ロス
• inventory-purchase-orders.md - 発注
• inventory-receiving.md - 入荷
• inventory-shipments.md - 出荷
• inventory-storage.md - 入庫
• inventory-shipping.md - 出庫
• inventory-stock-taking.md - 棚卸

ウェイターAPI

• waiter-menus.md - メニュー
• waiter-categories.md - カテゴリ
• waiter-toppings.md - トッピング
• waiter-topping-groups.md - トッピンググループ
• waiter-table-uses.md - テーブル利用
• waiter-orders.md - 注文
• waiter-custom-orders.md - カスタムオーダー
• waiter-reservations.md - 予約
• waiter-printing.md - 印刷
• waiter-dashboard.md - 営業状況