# 困ったとき

接続先・権限・下書きの版・マイクの状態から問題を切り分けます。

Web: /help/ja/troubleshooting
Markdown: /help/content/ja/troubleshooting.md

## ログインや店舗選択で止まる [#ログインや店舗選択で止まる]

招待されたアカウントと組織が合っているか確認し、店舗一覧から対象店舗を選び直します。ドキュメントの閲覧だけでは店舗への権限は付きません。アクセスできない組織や店舗を推測したIDで開こうとせず、組織の管理者に参加状況を確認してください。

## MCPのtoolが見つからない・認可エラーになる [#mcpのtoolが見つからない認可エラーになる]

クライアントで実際のtool一覧を再取得します。利用中の画面と接続先のorigin、本番・staging、OAuthの組織、scope、有効期限を確認します。必要な場合は再認可して、`get_configuration`が返す店舗名・IDを照合してください。秘密のトークンを会話や画面共有へ貼らないでください。[MCP接続](/help/content/ja/mcp.md)へ戻れます。

## 保存・検証・公開が進まない [#保存検証公開が進まない]

`get_draft_diff`で最新の版と検証結果を取得します。競合なら最新版へ差分を再適用し、読めない価格や安全情報は保留します。検証済みでも公開には人の承認が必要です。公開版が進んだ場合は新しい公開版を基に変更を移します。[設定と公開](/help/content/ja/configuration.md)を参照してください。

## 音声が聞こえない・再接続しない [#音声が聞こえない再接続しない]

iPadのマイク許可、端末の音量、ネットワーク、対象卓の登録状態を確認します。音声停止中は明示的に再開するまで再接続しません。カートを保持したまま再開できるか確認してください。注文内容は画面でも確認できます。

## 店舗資料や画像を取り込めない [#店舗資料や画像を取り込めない]

ZIPは5MiB以内か、必須のSKILL.mdと参照ファイルがあるか、同名資料を置換する意図があるかを確認します。画像の出所が不足する場合は補い、Skill検査のエラーを直します。画面で取り込んだだけでは保存されないため、下書き保存も確認してください。手順は[店舗資料とSkill](/help/content/ja/store-skills.md)を参照します。

## ポイントやクーポンが想定と違う [#ポイントやクーポンが想定と違う]

QR参加だけではポイントは付与されず、クーポンの利用申請だけでは割引は確定しません。会員画面の明細とスタッフの会計で状態を確認します。ポイント方針・クーポンルールは保存時に適用されるため、メニュー下書きの未公開や破棄では取り消せません。[会員と特典](/help/content/ja/membership.md)の操作ごとの反映時点を確認してください。

## ゲームが表示されない・動かない [#ゲームが表示されない動かない]

登録・自動検証・試遊・公開を分けて確認し、管理画面で対象店舗と公開版を調べます。未公開の登録だけでは卓上へ表示されません。外部素材への依存や未対応の権限は[ゲームの仕様確認](/help/content/ja/games.md)から見直します。

## 状況を共有する [#状況を共有する]

対象環境、操作した時刻、画面のURL、再現する操作、表示されたエラー、下書きIDと版を整理します。APIキー、OAuthトークン、個人情報、生音声は含めないでください。未確認の接続・保存・公開を成功として報告しません。

[目次へ戻る](/help/content/ja/index.md)。
