🛍️ Commerce Cloud MCP Server

🛍️ Commerce Cloud MCP Server

AI アプリケーションを Salesforce Commerce Cloud に接続するためのサーバーです。Model Context Protocol（MCP）を使用して、AI クライアントアプリケーションと Commerce Cloud インスタンス間のデータ交換を可能にします。

✨ 機能

• 🛍️ 商品の管理と更新
• 📊 注文の分析とインサイト
• 🗂️ カスタムオブジェクトの操作
• 📄 コンテンツアセットの管理
• ⚙️ 環境に基づく設定

🔄 フロー図

🚀 セットアップ手順

前提条件

• Node.js バージョン 22 以降
• Git
• OCAPI にアクセスできる Salesforce Commerce Cloud インスタンス
• MCP クライアントアプリケーション（Claude Desktop App など）

インストール手順

1. リポジトリをクローンします。

git clone https://github.com/your-username/commercecloud-mcp-server.git
cd commercecloud-mcp-server

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

npm install

3. 環境ファイルを作成して設定します。

cp .env.example .env

.env ファイルを編集し、Salesforce Commerce Cloud の認証情報を設定します。

4. プロジェクトをビルドします。

npm run build

5. OCAPI の設定をインポートします。

   OCAPI の設定ファイルは data/ocapi ディレクトリにあります。これらを SFCC Business Manager にインポートします。

   • Business Manager にログインします
   • Administration > Site Development > Open Commerce API Settings に移動します
   • data/ocapi ディレクトリ内の各 JSON ファイルについて、以下を行います。
     • 適切な API タイプ（Shop/Data）を選択します
     • JSON ファイルの内容をコピーします
     • 設定フィールドに貼り付けます
     • 「Save」をクリックします

   これらの設定により、MCP サーバーの動作に必要なエンドポイントが有効になります。

6. MCP クライアントアプリケーションを設定します（例：Claude Desktop App）。

   • Claude Desktop App を開きます
   • File > Settings > Developer > Edit Config に移動します
   • claude_desktop_config.json ファイルが含まれるフォルダーが開きます
   • ファイルをエディターで開き、サーバーの詳細を追加します。

{
  "mcpServers": {
    "commercecloud": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/commercecloud-mcp-server/dist/index.js"]
    }
  }
}

注：/ABSOLUTE/PATH/TO/ を、プロジェクトフォルダーの実際のパスに置き換えてください。

📋 ユースケース

ユースケース名	説明	実装状況
商品詳細	Commerce Cloud から商品情報を取得します	✅ 現在サポートされています
商品の更新	画像から商品説明を生成し、商品詳細を自動的に更新します	✅ 現在サポートされています
注文詳細	注文パターンを分析し、顧客の購入行動に関するインサイトを取得します	✅ 現在サポートされています
カスタムオブジェクト	カスタムオブジェクトの読み取り、書き込み、作成を行います	✅ 現在サポートされています
コンテンツアセット	Commerce Cloud からコンテンツアセットを取得します	✅ 現在サポートされています
コンテンツの更新	デザイン画像からコンテンツ本文を生成し、コンテンツアセットを自動的に更新します	✅ 現在サポートされています
サイト設定	サイト固有の設定と環境設定を管理します	🔄 今後実装予定
プロモーションとキャンペーン	プロモーションとキャンペーンを管理します	🔄 今後実装予定
ジョブ設定	ジョブ設定を管理します	🔄 今後実装予定

📚 関連ドキュメント

• Model Context Protocol（MCP）
• TypeScript SDK
• Open Commerce API

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

👥 クレジット

このプロジェクトを実現するツールを作ってくださった、私よりはるかに優れた方々がいます。これらのプロジェクトに感謝を述べたいと思います。

• colinhacks の (zod) に感謝します。
• Egoist の (tsup) に感謝します。

このツールがお役に立てば幸いです！🌟

Brinsil が ❤️ を込めて作成しました。