AI・外部連携のご案内

Salon Ueda（サロンウエダ）のAIアシスタントや外部ツール向けの案内ページです。
Web予約のURL指定方法（メニューや日時の初期選択）や、公開しているデータ・APIの仕様をシンプルにまとめています。

01

Web予約のURL指定方法 (URL Pre-fill)

ChatGPTなどのAIや外部サイトから当サロンの予約ページへ案内する際、URLにパラメータを付けることで、店舗種別・メニュー・日時をあらかじめ選択した状態で予約画面を開くことができます。

URLhttps://salonueda.jp/reservation?type={type}&menu={menu}&date={date}&time={time}

パラメータ一覧

パラメータ形式指定説明 / 記入例
type文字列推奨店舗種別。barber（理容） または beauty（美容）。未指定時は beauty。
menu文字列推奨 メニュー名（URLエンコード）。例: メンズカット, カットブロー。
部分一致で該当メニューが自動選択されます。
dateYYYY-MM-DD任意 予約希望日（本日〜60日以内）。
※当日の17:30以降は翌日以降の受付となります。
timeHH:mm任意予約希望時間（30分刻み）。例: 10:00, 14:30。

URL生成例

例1: 理容のメンズカットを案内する場合
https://salonueda.jp/reservation?type=barber&menu=%E3%83%A1%E3%83%B3%E3%82%BA%E3%82%AB%E3%83%83%E3%83%88
例2: 美容のカットブローを日時指定で案内する場合
https://salonueda.jp/reservation?type=beauty&date=2026-10-05&time=14:00&menu=%E3%82%AB%E3%83%83%E3%83%88%E3%83%96%E3%83%AD%E3%83%BC
例3: 理容のメンズシェービング（顔剃り）を案内する場合
https://salonueda.jp/reservation?type=barber&menu=%E3%83%A1%E3%83%B3%E3%82%BA%E3%82%B7%E3%82%A7%E3%83%BC%E3%83%93%E3%83%B3%E3%82%B0
02

API & MCP 連携仕様

AIエージェントや外部システムから予約枠の照会や仮押さえを行うためのインターフェースです。

連携の流れ

  1. メニュー照会: GET /api/v1/agent/menus でメニュー一覧・料金を取得
  2. 空き枠照会: GET /api/v1/agent/availability で空き状況を取得
  3. 仮押さえ: POST /api/v1/agent/holds で15分間の枠を仮押さえ（Token発行）
  4. お客様による確定: 発行された確認URL（/reservation/confirm?token=...）でお客様自身が最終確認

エンドポイント一覧

プロトコルエンドポイント用途
Model Context Protocol (MCP)https://salonueda.jp/api/mcp/sseClaude, Cursor, ChatGPT Apps等のSSE接続先
MCP HTTP JSON-RPChttps://salonueda.jp/api/mcpステートレスなMCPツール呼び出し
OpenAPI 3.0https://salonueda.jp/api/v1/agent/openapi.jsonCustom GPTs等のAPIスキーマ
RFC 9727 API Cataloghttps://salonueda.jp/.well-known/api-catalogAPI自動発見用インデックス