Registep MCP Server

POS売上データにAIから直接アクセス。67ツールで売上分析・在庫管理・AIチャットを統合。

67 Tools Airレジ スマレジ BASE MCP Protocol OAuth 2.1

クイックスタート

3ステップでRegistep MCP Serverに接続できます。

1

アカウント作成

registep.jp でアカウントを作成し、APIトークンを取得

2

接続設定

お使いのAIツールにMCPサーバーURLとトークンを設定

3

利用開始

AIに「今日の売上を教えて」と聞くだけで売上データにアクセス

エンドポイント

https://registep.jp/mcp

ヘルスチェック: GET https://registep.jp/mcp-health

認証方法

Registep MCP Serverは2つの認証方式に対応しています。

1. OAuth 2.1 + PKCE(ChatGPT App Store)

ChatGPT経由の接続ではOAuth 2.1フローが自動的に使用されます。

  • Auth0テナント: registep.jp.auth0.com
  • 認可エンドポイント: https://registep.jp.auth0.com/authorize
  • トークンエンドポイント: https://registep.jp.auth0.com/oauth/token
  • スコープ: openid profile email offline_access

2. Bearer Token(Claude Code / Cursor / その他)

ダッシュボードで発行されるAPIトークン(reg_ プレフィックス)を使用します。

Authorization: Bearer reg_your_token_here

トークンはダッシュボードの「設定 > API連携」から発行できます。

接続設定

お使いのAIツールに合わせた設定例です。

ChatGPT App Store で「Registep」を検索してインストール。
OAuth認証が自動で行われます。

1. ChatGPT → Explore GPTs → "Registep" を検索
2. 「Start」をクリック
3. Registepアカウントでログイン
4. 認証完了後、AIに売上について質問できます
{
  "mcpServers": {
    "registep": {
      "url": "https://registep.jp/mcp",
      "headers": {
        "Authorization": "Bearer reg_your_token_here"
      }
    }
  }
}

~/.claude.json に上記を追加してください。

{
  "mcpServers": {
    "registep": {
      "url": "https://registep.jp/mcp",
      "headers": {
        "Authorization": "Bearer reg_your_token_here"
      }
    }
  }
}

Cursor Settings > MCP Servers に上記を追加してください。

# Initialize session
curl -X POST https://registep.jp/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer reg_your_token_here" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": { "name": "my-app", "version": "1.0" }
    }
  }'

# Call a tool
curl -X POST https://registep.jp/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer reg_your_token_here" \
  -H "Mcp-Session-Id: SESSION_ID_FROM_INIT" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "store_list",
      "arguments": {}
    }
  }'

ツールリファレンス

全67ツールをカテゴリ別に掲載しています。

バッジの意味: read-only データ取得のみ write データ変更あり destructive 削除・不可逆 open-world 外部通信あり
store_list read-only
登録済み店舗の一覧を取得
store_create write
新しい店舗を作成
ParameterTypeRequiredDescription
namestring必須店舗名
codestring任意店舗コード
pos_systemstring任意POS種別 (airregi/smaregi/base)
industry_categorystring任意業種カテゴリ
industry_detailstring任意業種詳細
phonestring任意電話番号
postal_codestring任意郵便番号
addressstring任意住所
store_update write
店舗情報を更新
ParameterTypeRequiredDescription
idnumber必須店舗ID
namestring任意店舗名
enabledboolean任意有効/無効
store_delete destructive
店舗を完全に削除
ParameterTypeRequiredDescription
idnumber必須店舗ID
store_settings_get read-only
店舗設定を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
store_settings_update write
店舗設定を更新
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
settingsobject必須設定オブジェクト
store_email_add write
配信先メールアドレスを追加
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
emailstring必須メールアドレス
store_email_remove destructive
配信先メールアドレスを削除
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
emailstring必須メールアドレス
store_schedule_set write
配信スケジュールを設定
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
scheduleobject必須スケジュール設定
store_airregi_credentials_set write
Airレジ認証情報を設定
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
usernamestring必須ユーザー名
passwordstring必須パスワード
schedule_list read-only
全配信スケジュールを一覧
notification_list read-only
通知履歴を取得
ParameterTypeRequiredDescription
limitnumber任意取得件数 (default: 50)
activity_log_list read-only
ユーザー操作ログを取得
ParameterTypeRequiredDescription
daysnumber任意取得日数 (default: 30)
limitnumber任意取得件数 (default: 50)
action_filterstring任意アクション種別フィルタ
sql_query read-only
カスタムSQLクエリを実行(SELECT文のみ)
ParameterTypeRequiredDescription
sqlstring必須SQL文(SELECTのみ)
max_rowsnumber任意最大行数 (default: 1000, max: 10000)
airregi_sales_summaryread-only
期間指定の売上サマリーを取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
start_datestring必須開始日 (YYYY-MM-DD)
end_datestring必須終了日 (YYYY-MM-DD)
periodstring任意集計単位 (daily/weekly/monthly)
airregi_sales_todayread-only
本日のリアルタイム売上を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
airregi_transaction_listread-only
取引一覧を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
start_datestring必須開始日
end_datestring必須終了日
categorystring任意カテゴリフィルタ
limitnumber任意取得件数 (default: 100)
airregi_category_salesread-only
カテゴリ別売上内訳を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
start_datestring必須開始日
end_datestring必須終了日
airregi_product_salesread-only
商品別売上ランキングを取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
start_datestring必須開始日
end_datestring必須終了日
sort_bystring任意ソート (revenue/quantity)
limitnumber任意取得件数 (default: 20)
airregi_salesread-only
柔軟なフィルタ付き売上クエリ
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
start_datestring必須開始日
end_datestring必須終了日
categorystring任意カテゴリ
product_namestring任意商品名
payment_methodstring任意支払方法
group_bystring任意グループ化
smaregi_store_listread-only
スマレジ店舗一覧を取得
smaregi_store_inforead-only
店舗詳細情報を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
smaregi_pos_storesread-only
POS端末の一覧を取得
smaregi_sales_summaryread-only
売上サマリーを取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
start_datestring必須開始日
end_datestring必須終了日
smaregi_sales_todayread-only
本日の売上を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
smaregi_transaction_listread-only
取引一覧を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
start_datestring必須開始日
end_datestring必須終了日
smaregi_transaction_getread-only
特定の取引詳細を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
transaction_idstring必須取引ID
smaregi_product_listread-only
全商品を一覧
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
smaregi_product_getread-only
商品詳細を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
product_idstring必須商品ID
smaregi_product_searchread-only
キーワードで商品検索
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
keywordstring必須検索キーワード
smaregi_category_listread-only
カテゴリ一覧を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
smaregi_stock_listread-only
在庫概要を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
smaregi_stock_getread-only
商品別在庫詳細を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
product_idstring必須商品ID
settings_company_updatewrite
会社情報を更新
ParameterTypeRequiredDescription
company_namestring任意会社名
postal_codestring任意郵便番号
addressstring任意住所
phonestring任意電話番号
settings_line_getread-only
LINE通知設定を取得
settings_line_updatewrite
LINE通知設定を更新
ParameterTypeRequiredDescription
enabledboolean必須有効/無効
settings_line_testopen-world
LINE通知テストを送信
settings_credit_getread-only
AIクレジット残高を確認
chat_sendwrite
AIアシスタントにメッセージを送信
ParameterTypeRequiredDescription
messagestring必須メッセージ
session_idstring任意セッションID
store_idnumber任意店舗ID
chat_session_createwrite
新しいチャットセッションを作成
ParameterTypeRequiredDescription
titlestring任意セッションタイトル
folder_idstring任意フォルダID
chat_session_loadread-only
既存セッションを読み込み
ParameterTypeRequiredDescription
session_idstring必須セッションID
chat_session_listread-only
セッション一覧を取得
ParameterTypeRequiredDescription
folder_idstring任意フォルダID
limitnumber任意取得件数 (default: 50)
chat_session_deletedestructive
セッションを完全に削除
ParameterTypeRequiredDescription
session_idstring必須セッションID
chat_session_update_titlewrite
セッションタイトルを変更
ParameterTypeRequiredDescription
session_idstring必須セッションID
titlestring必須新しいタイトル
chat_session_movewrite
セッションをフォルダに移動
ParameterTypeRequiredDescription
session_idstring必須セッションID
folder_idstring必須フォルダID
chat_folder_listread-only
フォルダ一覧を取得
chat_folder_createwrite
新しいフォルダを作成
ParameterTypeRequiredDescription
namestring必須フォルダ名
chat_folder_renamewrite
フォルダ名を変更
ParameterTypeRequiredDescription
folder_idstring必須フォルダID
namestring必須新しい名前
chat_folder_deletedestructive
フォルダを完全に削除
ParameterTypeRequiredDescription
folder_idstring必須フォルダID
chat_usage_getread-only
AI利用統計を確認
csv_history_listread-only
CSVファイル履歴を一覧
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
yearnumber任意
monthnumber任意
csv_content_getread-only
CSVファイルの内容を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
filenamestring必須ファイル名
weather_history_listread-only
過去の天気データを取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
yearnumber任意
monthnumber任意
weather_date_getread-only
特定日の天気を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
datestring必須日付 (YYYY-MM-DD)
base_shop_inforead-only
BASEショップ接続状況を確認
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
base_store_listread-only
BASE連携店舗の一覧
base_sales_todayread-only
本日のBASE売上を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
base_item_listread-only
商品一覧を取得(フィルタ対応)
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
pagenumber任意ページ番号
per_pagenumber任意1ページの件数
searchstring任意検索キーワード
base_stock_updatewrite
在庫数を更新
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
item_idnumber必須商品ID
stocknumber必須在庫数
base_item_getread-only
商品詳細を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
item_idnumber必須商品ID
base_item_createwrite
新しい商品を作成
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
titlestring必須商品名
pricenumber必須価格
detailstring任意商品説明
stocknumber任意在庫数
base_item_updatewrite
商品情報を更新
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
item_idnumber必須商品ID
titlestring任意商品名
pricenumber任意価格
base_item_deletedestructive
商品を完全に削除
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
item_idnumber必須商品ID
base_order_listread-only
注文一覧を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
statusstring任意注文ステータス
date_fromstring任意開始日
date_tostring任意終了日
base_order_getread-only
注文詳細を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
unique_keystring必須注文キー
base_category_listread-only
カテゴリ一覧を取得
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
base_category_createwrite
新しいカテゴリを作成
ParameterTypeRequiredDescription
store_idnumber必須店舗ID
namestring必須カテゴリ名

レート制限・セキュリティ

レート制限

項目制限値
リクエスト制限100リクエスト/分/IP
SQLクエリ結果最大 10,000 行
クエリタイムアウト30秒

セキュリティ

  • ユーザー分離: 全クエリは認証ユーザーのデータのみに制限
  • READ ONLY SQL: sql_query ツールは registep_readonly ユーザーで実行(SELECT権限のみ)
  • 禁止キーワード: DROP, DELETE, UPDATE, INSERT, ALTER, INTO OUTFILE, DUMPFILE
  • HTTPS必須: 全通信はTLS暗号化
  • CORS制限: registep.jp ドメインのみ許可

エラーハンドリング

MCP Serverは JSON-RPC 2.0 形式でエラーを返します。

HTTP Status説明対処法
401認証エラー(トークン無効・期限切れ)トークンを再発行してください
403権限不足(他ユーザーのデータへのアクセス)自分のデータのみアクセス可能です
404リソースが見つからないIDやパラメータを確認してください
429レート制限超過1分後にリトライしてください
500サーバー内部エラーしばらく後にリトライしてください

エラーレスポンス例

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32001,
    "message": "Authentication required. Please provide a valid Bearer token."
  }
}

プライバシー・利用規約

お問い合わせ: support@registep.jp