> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kleep.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# インストール

> カートリッジのインポート、サイトへの割り当て、メタデータのインポート

## カートリッジのインポート

1. カートリッジのソースコードをダウンロードします。
2. ディレクトリを展開し、**link\_kleep** フォルダを SFRA と同じ階層に移動します。
3. Kleep コネクター（`storefront-reference-architecture` フォルダ）から SFRA プロジェクトを削除できます — これはテスト用途にのみ使用されます。

<img src="https://mintcdn.com/kleepai/A9OHiEXCm7A82FUt/images/sfcc/image.png?fit=max&auto=format&n=A9OHiEXCm7A82FUt&q=85&s=e63c269d7d76eb2faaf8a1442422e414" alt="image.png" width="1106" height="290" data-path="images/sfcc/image.png" />

カートリッジの構成は次のようになります。

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image1.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=f48167d08d0bc546ea7a13f7a88eb2dc" alt="image.png" width="726" height="858" data-path="images/sfcc/image1.png" />

4. 依存関係をインストールします。

```bash theme={null}
cd /path/to/link_kleep
npm install
```

5. フロントエンドをコンパイルします。

```bash theme={null}
npm run compile
```

6. 同じディレクトリに `dw.json` ファイルを作成します。

```json theme={null}
{
    "hostname": "...",
    "username": "...",
    "password": "...",
    "version": "..."
}
```

* **hostname** — サンドボックスのアドレス、例：`zzaa-001.sandbox.us01.dx.commercecloud.salesforce.com`
* **username / password** — アカウントマネージャーの認証情報
* **version** — **Administration > Code Deployment** でのアクティブなコードバージョン、例：`version1`

7. カートリッジをアップロードします。

```bash theme={null}
npm run uploadCartridges
```

8. **Administration > Development Setup > Folder Browser > Cartridges** に移動して、アップロードを確認します。

## サイトへのカートリッジの割り当て

1. **Administration > Sites > Manage Sites** に移動します。**Storefront Sites** リストからサイトを選択します。

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image2.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=6997b2a6015a415c0d532aa531c074b9" alt="image.png" width="1055" height="489" data-path="images/sfcc/image2.png" />

2. **Settings** タブを選択します。カートリッジパスの先頭に次を追加します：`int_kleep_sfra:int_kleep`

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image3.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=caaf757ebdabeb66f42c3b8b9936af5b" alt="image.png" width="826" height="487" data-path="images/sfcc/image3.png" />

3. **Administration > Sites > Manage Sites** に移動し、**Manage the Business Manager site** セクションのリンクをクリックします。

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image4.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=c12dce5c34d7a600ff94b2a2df1b4f10" alt="image.png" width="885" height="508" data-path="images/sfcc/image4.png" />

4. Cartridges テキストボックスに `bc_kleep:int_kleep` を入力します（複数のカートリッジを使用する場合は `:` で区切ります）。

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image5.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=b81dd667cfef1178d65e38fd2aad2ea1" alt="image.png" width="857" height="545" data-path="images/sfcc/image5.png" />

## メタデータのインポート

1. **Administration > Site Development > Site Import & Export** に移動します。
2. メタデータフォルダを含む `kleep-metadata.zip` をアップロードします。

<img src="https://mintcdn.com/kleepai/taAv0usV4Q0HyYiD/images/sfcc/image6.png?fit=max&auto=format&n=taAv0usV4Q0HyYiD&q=85&s=753a06c31d5682a8e6e550809d01ba46" alt="image.png" width="1321" height="685" data-path="images/sfcc/image6.png" />

3. `kleep-metadata.zip` を選択してインポートを完了します。
