Registep MCP Server
POS売上データにAIから直接アクセス。67ツールで売上分析・在庫管理・AIチャットを統合。
67 Tools
Airレジ
スマレジ
BASE
MCP Protocol
OAuth 2.1
クイックスタート
3ステップでRegistep MCP Serverに接続できます。
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
新しい店舗を作成
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | 必須 | 店舗名 |
code | string | 任意 | 店舗コード |
pos_system | string | 任意 | POS種別 (airregi/smaregi/base) |
industry_category | string | 任意 | 業種カテゴリ |
industry_detail | string | 任意 | 業種詳細 |
phone | string | 任意 | 電話番号 |
postal_code | string | 任意 | 郵便番号 |
address | string | 任意 | 住所 |
store_update
write
店舗情報を更新
| Parameter | Type | Required | Description |
|---|---|---|---|
id | number | 必須 | 店舗ID |
name | string | 任意 | 店舗名 |
enabled | boolean | 任意 | 有効/無効 |
store_delete
destructive
店舗を完全に削除
| Parameter | Type | Required | Description |
|---|---|---|---|
id | number | 必須 | 店舗ID |
store_settings_get
read-only
店舗設定を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
store_settings_update
write
店舗設定を更新
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
settings | object | 必須 | 設定オブジェクト |
store_email_add
write
配信先メールアドレスを追加
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
email | string | 必須 | メールアドレス |
store_email_remove
destructive
配信先メールアドレスを削除
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
email | string | 必須 | メールアドレス |
store_schedule_set
write
配信スケジュールを設定
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
schedule | object | 必須 | スケジュール設定 |
store_airregi_credentials_set
write
Airレジ認証情報を設定
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
username | string | 必須 | ユーザー名 |
password | string | 必須 | パスワード |
schedule_list
read-only
全配信スケジュールを一覧
notification_list
read-only
通知履歴を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | 任意 | 取得件数 (default: 50) |
activity_log_list
read-only
ユーザー操作ログを取得
| Parameter | Type | Required | Description |
|---|---|---|---|
days | number | 任意 | 取得日数 (default: 30) |
limit | number | 任意 | 取得件数 (default: 50) |
action_filter | string | 任意 | アクション種別フィルタ |
sql_query
read-only
カスタムSQLクエリを実行(SELECT文のみ)
| Parameter | Type | Required | Description |
|---|---|---|---|
sql | string | 必須 | SQL文(SELECTのみ) |
max_rows | number | 任意 | 最大行数 (default: 1000, max: 10000) |
airregi_sales_summaryread-only
期間指定の売上サマリーを取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
start_date | string | 必須 | 開始日 (YYYY-MM-DD) |
end_date | string | 必須 | 終了日 (YYYY-MM-DD) |
period | string | 任意 | 集計単位 (daily/weekly/monthly) |
airregi_sales_todayread-only
本日のリアルタイム売上を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
airregi_transaction_listread-only
取引一覧を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
start_date | string | 必須 | 開始日 |
end_date | string | 必須 | 終了日 |
category | string | 任意 | カテゴリフィルタ |
limit | number | 任意 | 取得件数 (default: 100) |
airregi_category_salesread-only
カテゴリ別売上内訳を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
start_date | string | 必須 | 開始日 |
end_date | string | 必須 | 終了日 |
airregi_product_salesread-only
商品別売上ランキングを取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
start_date | string | 必須 | 開始日 |
end_date | string | 必須 | 終了日 |
sort_by | string | 任意 | ソート (revenue/quantity) |
limit | number | 任意 | 取得件数 (default: 20) |
airregi_salesread-only
柔軟なフィルタ付き売上クエリ
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
start_date | string | 必須 | 開始日 |
end_date | string | 必須 | 終了日 |
category | string | 任意 | カテゴリ |
product_name | string | 任意 | 商品名 |
payment_method | string | 任意 | 支払方法 |
group_by | string | 任意 | グループ化 |
smaregi_store_listread-only
スマレジ店舗一覧を取得
smaregi_store_inforead-only
店舗詳細情報を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
smaregi_pos_storesread-only
POS端末の一覧を取得
smaregi_sales_summaryread-only
売上サマリーを取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
start_date | string | 必須 | 開始日 |
end_date | string | 必須 | 終了日 |
smaregi_sales_todayread-only
本日の売上を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
smaregi_transaction_listread-only
取引一覧を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
start_date | string | 必須 | 開始日 |
end_date | string | 必須 | 終了日 |
smaregi_transaction_getread-only
特定の取引詳細を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
transaction_id | string | 必須 | 取引ID |
smaregi_product_listread-only
全商品を一覧
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
smaregi_product_getread-only
商品詳細を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
product_id | string | 必須 | 商品ID |
smaregi_product_searchread-only
キーワードで商品検索
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
keyword | string | 必須 | 検索キーワード |
smaregi_category_listread-only
カテゴリ一覧を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
smaregi_stock_listread-only
在庫概要を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
smaregi_stock_getread-only
商品別在庫詳細を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
product_id | string | 必須 | 商品ID |
settings_company_updatewrite
会社情報を更新
| Parameter | Type | Required | Description |
|---|---|---|---|
company_name | string | 任意 | 会社名 |
postal_code | string | 任意 | 郵便番号 |
address | string | 任意 | 住所 |
phone | string | 任意 | 電話番号 |
settings_line_getread-only
LINE通知設定を取得
settings_line_updatewrite
LINE通知設定を更新
| Parameter | Type | Required | Description |
|---|---|---|---|
enabled | boolean | 必須 | 有効/無効 |
settings_line_testopen-world
LINE通知テストを送信
settings_credit_getread-only
AIクレジット残高を確認
chat_sendwrite
AIアシスタントにメッセージを送信
| Parameter | Type | Required | Description |
|---|---|---|---|
message | string | 必須 | メッセージ |
session_id | string | 任意 | セッションID |
store_id | number | 任意 | 店舗ID |
chat_session_createwrite
新しいチャットセッションを作成
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | 任意 | セッションタイトル |
folder_id | string | 任意 | フォルダID |
chat_session_loadread-only
既存セッションを読み込み
| Parameter | Type | Required | Description |
|---|---|---|---|
session_id | string | 必須 | セッションID |
chat_session_listread-only
セッション一覧を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
folder_id | string | 任意 | フォルダID |
limit | number | 任意 | 取得件数 (default: 50) |
chat_session_deletedestructive
セッションを完全に削除
| Parameter | Type | Required | Description |
|---|---|---|---|
session_id | string | 必須 | セッションID |
chat_session_update_titlewrite
セッションタイトルを変更
| Parameter | Type | Required | Description |
|---|---|---|---|
session_id | string | 必須 | セッションID |
title | string | 必須 | 新しいタイトル |
chat_session_movewrite
セッションをフォルダに移動
| Parameter | Type | Required | Description |
|---|---|---|---|
session_id | string | 必須 | セッションID |
folder_id | string | 必須 | フォルダID |
chat_folder_listread-only
フォルダ一覧を取得
chat_folder_createwrite
新しいフォルダを作成
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | 必須 | フォルダ名 |
chat_folder_renamewrite
フォルダ名を変更
| Parameter | Type | Required | Description |
|---|---|---|---|
folder_id | string | 必須 | フォルダID |
name | string | 必須 | 新しい名前 |
chat_folder_deletedestructive
フォルダを完全に削除
| Parameter | Type | Required | Description |
|---|---|---|---|
folder_id | string | 必須 | フォルダID |
chat_usage_getread-only
AI利用統計を確認
csv_history_listread-only
CSVファイル履歴を一覧
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
year | number | 任意 | 年 |
month | number | 任意 | 月 |
csv_content_getread-only
CSVファイルの内容を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
filename | string | 必須 | ファイル名 |
weather_history_listread-only
過去の天気データを取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
year | number | 任意 | 年 |
month | number | 任意 | 月 |
weather_date_getread-only
特定日の天気を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
date | string | 必須 | 日付 (YYYY-MM-DD) |
base_shop_inforead-only
BASEショップ接続状況を確認
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
base_store_listread-only
BASE連携店舗の一覧
base_sales_todayread-only
本日のBASE売上を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
base_item_listread-only
商品一覧を取得(フィルタ対応)
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
page | number | 任意 | ページ番号 |
per_page | number | 任意 | 1ページの件数 |
search | string | 任意 | 検索キーワード |
base_stock_updatewrite
在庫数を更新
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
item_id | number | 必須 | 商品ID |
stock | number | 必須 | 在庫数 |
base_item_getread-only
商品詳細を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
item_id | number | 必須 | 商品ID |
base_item_createwrite
新しい商品を作成
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
title | string | 必須 | 商品名 |
price | number | 必須 | 価格 |
detail | string | 任意 | 商品説明 |
stock | number | 任意 | 在庫数 |
base_item_updatewrite
商品情報を更新
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
item_id | number | 必須 | 商品ID |
title | string | 任意 | 商品名 |
price | number | 任意 | 価格 |
base_item_deletedestructive
商品を完全に削除
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
item_id | number | 必須 | 商品ID |
base_order_listread-only
注文一覧を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
status | string | 任意 | 注文ステータス |
date_from | string | 任意 | 開始日 |
date_to | string | 任意 | 終了日 |
base_order_getread-only
注文詳細を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
unique_key | string | 必須 | 注文キー |
base_category_listread-only
カテゴリ一覧を取得
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
base_category_createwrite
新しいカテゴリを作成
| Parameter | Type | Required | Description |
|---|---|---|---|
store_id | number | 必須 | 店舗ID |
name | string | 必須 | カテゴリ名 |
レート制限・セキュリティ
レート制限
| 項目 | 制限値 |
|---|---|
| リクエスト制限 | 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