MCPサーバー

Claude などの MCP（Model Context Protocol）対応クライアントから、レシートローラーの売上・商品・注文・在庫・予約・SNS を扱えます。ツールは、接続したユーザーが承認したスコープの範囲で、そのユーザーの権限のままAPIを呼び出します。

接続情報

エンドポイント: https://mcp.receiptroller.io/mcp
通信方式: HTTP POST（JSON-RPC 2.0）、プロトコルバージョン 2025-03-26
認証: OAuth 2.0 の認可コードフロー（PKCE S256）。動的クライアント登録（RFC 7591）に対応しているため、事前にクライアントIDを発行する必要はありません。
メタデータ: https://mcp.receiptroller.io/.well-known/oauth-protected-resource

https://mcp.receiptroller.io/.well-known/oauth-authorization-server

スコープ

クライアントが要求できるスコープです。ツールはユーザーのアクセストークンでAPIを呼び出すため、承認されていないスコープが必要な操作は 403 になります。

sns.content.read sns.content.write sns.audience.read analytics.read sales.read store.products.read store.products.write store.orders.read store.orders.write store.inventory.read store.inventory.write store.reservations.read store.memberships.read store.passes.read

ツール

tools/list で、入力スキーマを含む最新の一覧を取得できます。

アカウント

ビジネスアカウントと店舗の一覧。ほかのツールに渡す organizationId と storeId を調べます。

list_my_organizations
list_my_stores

売上分析

KPI、推移、予測、売れ筋、来店分析、離反リスク、店舗比較、アドバイス。

sales_get_kpis
sales_get_trend
sales_get_forecast
sales_get_top_products
sales_get_visitor_analysis
sales_get_churn_risk
sales_get_customer_recommendations
sales_compare_stores
sales_get_advice

SNS

連携したアカウントでの投稿の作成・予約・公開、分析、コメント。

sns_list_accounts
sns_get_account
sns_list_recent_posts
sns_get_post
sns_create_post
sns_update_post
sns_attach_media_from_url
sns_schedule_post
sns_publish_post
sns_delete_post
sns_get_analytics
sns_list_comments

商品

商品マスタの一覧・取得・作成・更新。

pim_list_products
pim_get_product
pim_create_product
pim_update_product

注文

注文の一覧・取得、ステータスの変更と出荷。

oms_list_orders
oms_get_order
oms_transition_order
oms_ship_order

在庫

ロケーション、在庫数、入出庫履歴の取得と在庫の調整。

wms_list_locations
wms_get_stock
wms_list_movements
wms_adjust_stock

予約・会員

予約、予約枠、統計、会員と回数券の保有者。閲覧のみです。

reservation_list
reservation_list_slots
reservation_get_stats
reservation_get_analytics
membership_list_members
pass_list_holders

店舗オーナー向けの紹介と接続手順は AIエージェント連携のページ