トラブルシューティング
よくある問題とその解決方法。
クイック回復ガイド
構築の問題
プランが説明した内容と一致しない
何が起きているか: プランに誤った機能やスコープが含まれている。
修正方法:
- プランを承認しないでください。
- 何が間違っているかを説明する修正を入力します。例: 「プランにチーム機能が含まれていますが、シングルユーザーのみ必要です。チーム機能を削除して個人の習慣管理に集中してください。」
- MonstarX がプランを修正します。
- 意図と一致するまで繰り返し、承認します。
防ぐ方法: プロンプティングの最初のプロンプトテンプレートを使用し、明示的なスコープ外リストを含めてください。
構築が止まるまたは完了しない
何が起きているか: MonstarX が構築を開始したが、プロセスが止まっているように見える。
修正方法:
- 60 秒待ちます。複雑な構築には時間がかかります。
- ページを更新します。
- プロジェクトが保存されているか確認します（通常は保存されています）。
- それでも止まっている場合は、同じプロジェクトで何が未完成かを説明する新しいメッセージを送ります。
構築後に Preview が空白
何が起きているか: Preview タブに何も表示されない、または空の画面が表示される。
最も可能性の高い原因: 必須サービスが接続されていない。
修正方法:
- Connectors タブをクリックします。
- Required とマークされたサービスを見つけます。
- インテグレーションの手順に従って接続します。
- Preview に戻って再読み込みします。
その他の考えられる原因:
- 生成されたコードのエラー。Discuss mode を使って尋ねてください: 「Preview が空白です。コードに知っておくべきエラーがありますか？」
- ネットワークの問題。ページを再読み込みしてみてください。
チャットボックスに入力したが Preview がまだ空白
何が起きているか: メッセージを送って構築が完了したが、Preview タブに空の画面が表示される。
最も可能性の高い原因: 構築前に必須コネクターがセットアップされていなかった。
修正方法:
- Connectors タブをクリックします。
- Required とマークされた未接続のサービスを探します。
- 接続します — ステップバイステップの手順はインテグレーションをご覧ください。
- Preview タブに戻って再読み込みします。
必須サービスがすべてすでに接続されている場合は、Discuss mode を使って尋ねてください: 「前のメッセージの後に Preview が空白になっています。コードにエラーがありますか？」
クレジット不足
何が起きているか: 「クレジットが残っていません」というメッセージが表示され、構築が開始されない。
修正方法:
- アカウント設定に移動して現在のプランを確認します。
- より多くの月間クレジットを得るために上位のプランにアップグレードします — プランと料金をご覧ください。
- 有料プランの場合、月間クレジットがまだリセットされていないか確認します。
クレジットは MonstarX がアプリを構築または再構築するときに消費されます。プランの検討やレビューではクレジットは消費されません。
リクエストした機能が見当たらない
何が起きているか: 説明した内容が構築済みアプリに含まれていない。
修正方法:
- 承認したプランを確認します — その機能は含まれていましたか？
- はい: 計画されたが構築されなかった。フォローアップメッセージを送って追加します。
- いいえ: プランに含まれていなかった。次回は明示的に含めてください。
- プロンプティングのフォーマットを使って具体的なフォローアップを送ります。
防ぐ方法: 承認前にプラン全体を読んでください。何かが足りない場合は、承認前に修正してください。
インテグレーションの問題
必須サービスがアプリをブロックしている
何が起きているか: コネクターが Required と表示されており、アプリはそれなしでは動作しない。
修正方法:
- インテグレーションのそのサービスのセットアップガイドに従います。
- アカウントを持っていない場合は、無料の代替手段が記載されていないか確認します。
- インテグレーションを完全に削除したい場合は、Discuss mode を使って尋ねてください: 「この機能から[サービス名]を削除して、よりシンプルなアプローチを使えますか？」
Supabase 接続が失敗する
- プロジェクトが一時停止 — supabase.com にログインしてプロジェクトを再開してください
- 認証情報が間違っている — Supabase ダッシュボードでプロジェクト URL と anon キーを確認してください
- 移行が失敗する — Supabase の SQL エディターでエラーの詳細を確認してください
- プロジェクトが非アクティブ — 無料プロジェクトは 1 週間の非アクティブ後に一時停止されます。ログインして再開してください
Stripe のキーが機能しない
修正方法:
- 正しいキーの種類を使用していることを確認します。
- テストモード:
pk_test_とsk_test_ - ライブモード:
pk_live_とsk_live_
- テストモード:
- テストキーとライブキーを同じプロジェクトで混在させないでください。
- Stripe ダッシュボードでアカウントレベルの問題がないか確認します。
メールが送信されない（Resend）
何が起きているか: パスワードリセットや確認メールが届かない。
修正方法:
- Resend ダッシュボードで送信エラーを確認します。
- Resend で送信ドメインがセットアップされて確認されているか確認します。
- スパムや迷惑メールフォルダを確認します。確認されていないドメインからのメールはよくそこに届きます。
- Resend の API キーがまだアクティブかどうかを確認します。
公開の問題
Publish ボタンがグレーアウトしている
修正方法:
- 必須サービスがすべて接続されているか確認します。
- アプリが Preview で正しく読み込まれているか確認します。
- ページを更新して再試行します。
公開済みリンクにエラーが表示される
修正方法:
- 30〜60 秒待ちます。公開がまだ完了中の可能性があります。
- プライベートまたはシークレットブラウザウィンドウでリンクを開きます。
- エラーが続く場合は、Connectors タブで切断されている必須サービスがないか確認してから再公開します。
フォローアップの変更後にアプリが壊れた
何が起きているか: 最近の変更によって何かが機能しなくなった。
修正方法:
- すぐに Discuss mode を使います: 「前の変更で[壊れた内容]が動かなくなりました。何が変わりましたか？」
- MonstarX に元に戻すよう依頼します: 「[セクションまたは機能]への最後の変更を取り消してください。他はすべてそのままにしてください。」
- 一度に一つのことを修正します。一つのメッセージですべてを修正しようとしないでください。
防ぐ方法: アプリの複数の部分に触れるメッセージの前には Discuss mode を使いましょう。
GitHub の問題
GitHub へのプッシュが失敗する
修正方法:
- Connectors タブで GitHub アカウントが接続されているか確認します。
- 接続されたアカウントに新しいリポジトリを作成する権限があるか確認します。
- リポジトリ名がすでに使われている場合は、別の名前を試してください。
- 接続が古くなっているようであれば、GitHub アカウントを切断して再接続します。
全般的なヒント
段階的に構築する。 シンプルに始めましょう。一度に一つのメッセージで機能を追加し、一度にすべてを説明しようとしないでください。
承認前にプランを読む。 構築が始まる前の唯一のチェックポイントです。
Discuss mode を自由に使う。 メッセージが大きな変更をトリガーするか不確かな場合は、先に Discuss mode で聞きましょう。
開発中はテストの認証情報を使う。 最終公開前にのみライブキーに切り替えてください。
個別の修正ではなくパターンを説明する。 同じ問題が複数の場所に現れる場合は、一度で説明しましょう: 「アプリ全体のすべてのボタンは #2563eb を使うべきです。すべての箇所を修正してください。」