---
title: アプリ接続のトラブルシューティング
description: アプリがロード、接続、再接続、ツールアクセスの保存、または切断されない場合の問題を診断します。
---

アプリがロード、接続、再接続、ツールアクセスの保存、または期待どおりに切断されない場合は、このガイドを使用します。プロバイダーフローを盲目的に繰り返すのではなく、Runner が実際に表示している状態から開始します。

**エントリパス:** **プロジェクト → アプリ**

## 開始する前に

1. 意図したプロジェクトとワークスペースのアプリを開いたことを確認します。
2. **アプリを検索** をクリアし、Agent アプリカテゴリフィルターをクリアします。
3. ページを 1 回更新し、接続状態がロードされるまで待ちます。
4. 正確なカード状態を読みます: **接続**、**接続中...**、**接続済み**、**再接続**、
   **レビュー待機中**、またはアクション必須通知。
5. その状態に一致する復旧アクションのみを開きます。
6. API キー、シークレット、身元文書、支払い詳細、または完全なプロバイダーコールバック URL をサポートメッセージまたはスクリーンショットに含めないでください。

## 重要なコントロールと結果

| コントロール | 選択後に何が起こるか |
| --- | --- |
| **検索をクリア** | 現在の Agent アプリ検索を削除して、利用可能なカタログが再度表示されるようにします。 |
| **接続** / **接続して認可** | そのアプリのセットアップまたは外部認可フローを開きます。 |
| **再接続**（表示される場合） | 既存のプロバイダー接続の認可を再開します。 |
| **再試行** | 現在のパネルで表示されている失敗したカタログ、ツールリスト、または接続リクエストを繰り返します。 |
| **オンボーディングを続行** | アクションが必要な場合、既存の Stripe オンボーディングフローに戻ります。 |
| **切断** | 確認を開くか、文書化された削除フローを開始します。プロバイダー側の認証情報を変更する前に保存された状態を確認します。 |

## 症状と復旧表

| 表示内容 | 可能性のある意味 | 安全な次のアクション |
| --- | --- | --- |
| アプリが見つからない | 検索、カテゴリ、ワークスペースアクセス、または条件付き機能がそれを非表示にしています。 | 検索をクリアし、**すべて** を選択してから、この機能がこのワークスペースで利用可能であることを確認します。 |
| カードがロード中のままです | Runner は保存された接続を解決していません。 | アプリを 1 回更新します。状態が不明な間に別の接続を送信しないでください。 |
| **アプリが見つかりません** | Agent アプリが現在のフィルターと一致しません。 | **検索をクリア** を選択します。 |
| **接続** が何もしない | 必須フィールドが空または無効であるか、プロバイダーフローを開始できませんでした。 | フィールドエラーを読み、必須値を再度コピーし、該当する場合はプロバイダーポップアップを許可します。 |
| **接続中...** が終了しない | 外部認可が閉じられた、ブロックされた、または結果を返しませんでした。 | アプリに戻り、状態を更新してから、Runner が提供する場合は **再接続** を使用します。 |
| プロバイダーは成功と言いますが Runner は言いません | Runner は使用可能な接続を確認していません。 | アプリを再度開きます。**接続済み** のみを成功として扱い、重複を作成する代わりに **再接続** を使用します。 |
| **再接続** | 既存の認可に注意が必要です。 | それを選択し、プロバイダーフローを再度完了します。 |
| **レビュー待機中** | Stripe は送信された詳細を確認しています。 | アクション通知に従ってください。ラベルを削除するためだけに別のアカウントを開始しないでください。 |
| **Stripe アクションが必要** | Stripe は情報が必要であるか、機能を一時停止しています。 | **今すぐ期限**、**後で期限**、**確認中**、支払い、およびペイアウト通知を確認してから、表示される場合は **オンボーディングを続行** を使用します。 |
| API キーまたはシークレットが拒否されました | 値が間違っている、期限切れ、間違ったアカウントからのもの、またはこの統合で受け入れられていません。 | プロバイダーから再度コピーします。推測でシークレットを編集しないでください。 |
| Shopify ドメインが無効です | 値が永続的な Shopify ストアドメインではありません。 | カスタムストアフロントドメインではなく `your-store.myshopify.com` を使用します。 |
| Agent アプリ認可ウィンドウがブロックされています | ブラウザが外部フローを防止しました。 | Runner のポップアップを許可し、**接続して認可** を再度開始します。 |
| Agent アプリツールがロードに失敗します | Runner はそのアプリのツールリストを取得できませんでした。 | **アプリ詳細** で **再試行** を選択します。 |
| ツールスイッチが失敗を報告します | 新しいツール設定は保存されませんでした。 | スイッチが更新されるまで待ち、現在の状態を確認してから、1 回再試行します。 |
| 切断が失敗を報告します | Runner は削除を確認しませんでした。 | 既存の接続がまだアクティブであると想定し、再度試行する前にアプリを再度開きます。 |

## プロバイダー固有のチェック

### Stripe

- **再接続** または **オンボーディングを続行** で既存のオンボーディング試行を続行します。
- カード色のみに依存するのではなく、アクション要件を読みます。
- 公開されたストアフロントでも支払いが一時停止または利用不可の場合があります。
- Runner が関連するアカウントを持った後にのみ、Stripe ダッシュボードアクションを使用します。

### メール

- 失敗したスイッチ変更は保存された状態に戻ります。
- 有効なスイッチは特定のメールが配信されたことを証明しません。
- ストアイベント、受信者、メール設定、および現在公開されているバージョンを安全なテストデータで確認します。

### Shippo

- 意図したアカウントから Shippo API キーを再度コピーします。
- 接続されたカードは料金、キャリア、ラベル、または配送作成を確認しません。

### Shopify

- 永続的な `myshopify.com` ドメインを使用します。
- ワークスペースに既にストアが接続されている場合は、切断する前に確認します。
- 接続リンクの有効期限が切れた場合、または返されたストアが入力したドメインと一致しない場合は、認可を再開します。

### CJ ドロップシッピング

- API キーが使用する CJ アカウントに属していることを確認します。
- 切断後、Runner は共有 CJ アカウントにフォールバックするため、将来のサプライヤーアクションの前にアカウントコンテキストを確認します。

### 4PX

- API キーとシークレットが同じアカウントに属し、正しいフィールドにあることを確認します。
- 接続されたカードは宛先または注文が履行の対象であることを証明しません。

### Agent アプリ

- セクション全体または個別のアプリは条件付きで利用不可の場合があります。
- アプリが存在しないと判断する前にフィルターをクリアします。
- 再接続する前にツールスイッチを確認します。セットアップを簡単にするためだけにアクセスを許可しないでください。

## 切断に失敗したか、不確実な結果が生じた

1. プロバイダーアカウントと現在のストア操作を変更しないままにします。
2. **プロジェクト → アプリ** を再度開き、カード状態を確認します。
3. まだ接続されていると表示される場合は、接続をアクティブとして扱います。
4. アクティブなチェックアウト、メール、配送、サプライヤー、または履行作業がまだそれらに依存しているかどうかを理解するまで、プロバイダー側の認証情報を削除しないでください。
5. 状態が明確になった後にのみ、Runner 切断を再試行します。

## 安全にヘルプを求める

提供してください:

- アプリ名;
- 正確に表示される状態とエラーテキスト;
- 接続、返却、ツール管理、または切断中に問題が発生するかどうか;
- シークレットクエリ値のないプロジェクト URL; および
- 問題を実質的に示す場合はプライバシーセーフなスクリーンショット。

実際の API キー、シークレット、プロバイダーパスワード、身元文書、支払い詳細、顧客データ、または隠された認可パラメーターを提供しないでください。

## 関連ガイド

- [アプリと統合の概要](../apps-and-integrations)
- [アプリを接続、管理、再接続する](./connect-manage-reconnect)
- [Agent アプリを接続して制御する](./agent-apps)