困ったとき
接続先・権限・下書きの版・マイクの状態から問題を切り分けます。
このページの内容
ログインや店舗選択で止まる
招待されたアカウントと組織が合っているか確認し、店舗一覧から対象店舗を選び直します。ドキュメントの閲覧だけでは店舗への権限は付きません。アクセスできない組織や店舗を推測したIDで開こうとせず、組織の管理者に参加状況を確認してください。
MCPのtoolが見つからない・認可エラーになる
クライアントで実際のtool一覧を再取得します。利用中の画面と接続先のorigin、本番・staging、OAuthの組織、scope、有効期限を確認します。必要な場合は再認可して、get_configurationが返す店舗名・IDを照合してください。秘密のトークンを会話や画面共有へ貼らないでください。MCP接続へ戻れます。
保存・検証・公開が進まない
get_draft_diffで最新の版と検証結果を取得します。競合なら最新版へ差分を再適用し、読めない価格や安全情報は保留します。検証済みでも公開には人の承認が必要です。公開版が進んだ場合は新しい公開版を基に変更を移します。設定と公開を参照してください。
音声が聞こえない・再接続しない
iPadのマイク許可、端末の音量、ネットワーク、対象卓の登録状態を確認します。音声停止中は明示的に再開するまで再接続しません。カートを保持したまま再開できるか確認してください。注文内容は画面でも確認できます。
店舗資料や画像を取り込めない
ZIPは5MiB以内か、必須のSKILL.mdと参照ファイルがあるか、同名資料を置換する意図があるかを確認します。画像の出所が不足する場合は補い、Skill検査のエラーを直します。画面で取り込んだだけでは保存されないため、下書き保存も確認してください。手順は店舗資料とSkillを参照します。
ポイントやクーポンが想定と違う
QR参加だけではポイントは付与されず、クーポンの利用申請だけでは割引は確定しません。会員画面の明細とスタッフの会計で状態を確認します。ポイント方針・クーポンルールは保存時に適用されるため、メニュー下書きの未公開や破棄では取り消せません。会員と特典の操作ごとの反映時点を確認してください。
ゲームが表示されない・動かない
登録・自動検証・試遊・公開を分けて確認し、管理画面で対象店舗と公開版を調べます。未公開の登録だけでは卓上へ表示されません。外部素材への依存や未対応の権限はゲームの仕様確認から見直します。
状況を共有する
対象環境、操作した時刻、画面のURL、再現する操作、表示されたエラー、下書きIDと版を整理します。APIキー、OAuthトークン、個人情報、生音声は含めないでください。未確認の接続・保存・公開を成功として報告しません。