---
title: アプリを接続、管理、再接続する
description: Runner のアプリ接続状態を理解し、認可を安全に修復または接続を削除します。
---

このガイドを使用して、1 つのアプリをその接続ライフサイクル全体で実行します。接続を開始し、
その実際の状態を確認し、必要に応じて認可を修復し、安全に切断します。

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

## 開始する前に

以下の場合に使用します:

- アプリが**接続**、**接続中...**、**再接続**、または**レビュー待ち**と表示されている;
- 前のプロバイダーフローが本当に完了したかどうかを確認する必要がある;
- エージェントアプリが異なるツールアクセスを必要とする; または
- 接続を削除する予定があり、最初に警告を理解する必要がある。

プロジェクトへのアクセスと、外部プロバイダーが要求するアカウント、認証情報、または承認が必要です。
一部のアプリは条件付きであり、すべてのワークスペースに表示されない場合があります。

## 行動する前にカードを読む

| カード状態またはコントロール | 意味 | 何をするか |
| --- | --- | --- |
| 読み込みインジケーター | Runner は保存された接続をチェックしています。 | 別のアクションを選択する前に待ちます。 |
| **接続** | Runner はこのアプリに使用可能な接続がありません。 | セットアップダイアログまたはプロバイダー認可フローを開きます。 |
| **接続中...** | 接続リクエストが進行中です。 | プロバイダーフローを完了するか、Runner が結果を返すのを待ちます。 |
| **接続済み** | Runner は使用可能な接続を認識しています。 | 変更が必要な場合は、その管理または切断コントロールを使用します。 |
| **管理** | 接続されたエージェントアプリには設定可能なツールがあります。 | アプリの詳細を開き、ツールアクセスを確認します。 |
| **再接続** | 認可が不足しているか、期限切れであるか、その他の注意が必要です。 | 認可を再度開始します。古い接続がまだ機能していると仮定しないでください。 |
| **レビュー待ち** | Stripe はアカウントを持っていますが、準備ができていません。 | ステータスまたはアクション通知に従います。ラベルは接続ボタンではありません。 |
| **オンボーディングを続行** | Stripe はまだ情報が必要です。 | 別のアカウントを作成する代わりに、既存のセットアップを続行します。 |
| 削除または**切断** | 接続を削除できます。 | プロバイダー固有の影響を読んで確認します。 |

## ライフサイクルを完了する

1. **アプリ**を開き、アプリを見つけます。
2. **接続**を選択します。
3. ダイアログに表示されているフィールドのみを入力します。アプリによっては、これはショップドメイン、
   API キー、キーとシークレット、プロバイダー認証情報、または外部認可である可能性があります。
4. プロバイダーステップを完了してから、アプリに戻ります。
5. カードが接続されたバッジまたはプロバイダーの接続されたコントロールを表示していることを確認します。
   閉じたダイアログまたはプロバイダーウィンドウは成功の証拠ではありません。
6. カードが**再接続**または**オンボーディングを続行**を表示する場合は、そのアクションを選択して
   既存の接続を続行します。
7. アプリを削除するには、その切断コントロールを選択し、確認を読み、
   記載されているワークスペース全体の影響が許容可能な場合のみ**切断**または**確認**を選択します。
8. アプリを再度開き、カードが切断された状態に戻ったことを確認します。

## ストアアプリとエージェントアプリは異なります

ストアアプリはプロバイダー固有のコントロールを使用します:

- **メール**はオン/オフスイッチを使用します。
- **Stripe**はオンボーディング、レビュー、アクション必須、ダッシュボード、および切断
  コントロールを表示できます。
- **Shippo**、**CJ Dropshipping**、**4PX**、および**Shopify**はプロバイダー固有のセットアップ
  データを要求し、破壊的な切断確認を表示します。

## 接続の安全性

- プロバイダーキーとシークレットをパスワードのように扱います。
- 接続がワークスペースに属するか、現在のプロジェクトのみに属するかを読みます。
- プロバイダーウィンドウの完了は、Runner が使用可能な結果を受け取ったことを保証しません。
- アクティブなストア操作中に、配送、支払い、メール、またはフルフィルメントプロバイダーを
  切断しないでください。警告と現在の注文を確認してください。
- 切断に失敗した場合、Runner は現在の状態を保持します。プロバイダーが削除されたと仮定しないでください。

## 関連ガイド

- [アプリと統合の概要](../apps-and-integrations)
- [エージェントアプリを接続して制御する](./agent-apps)
- [アプリ接続のトラブルシューティング](./troubleshooting)