概要
Salesforce Commerce API (SCAPI) Admin APIsを通じたSalesforce B2C Commerce Cloud: 注文とそのステータス、製品の検索と編集、カタログとカテゴリ、在庫リストレコードおよび登録された顧客。アカウントマネージャーAPIクライアント(クライアント資格情報)、ショートコード、テナントID、サイトID。
ガイド付きセットアップ
Salesforce Commerce Cloud を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Salesforce Commerce Cloud を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Salesforce Commerce Cloud のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → Salesforce Commerce Cloudをクリックし、資格情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Salesforce Commerce Cloud
Salesforce B2C Commerce CloudをSalesforce Commerce API (SCAPI) Admin APIsを通じて利用します: 注文とそのステータス、製品の検索と編集、カタログとカテゴリ、在庫リストレコードおよび登録された顧客。アカウントマネージャーAPIクライアント(クライアント資格情報)、ショートコード、テナントID、サイトID。
セットアップ
セットアップには約15分かかります。アカウントマネージャーの管理者が必要です。
- ビジネスマネージャーでAdministration, Site Development, Salesforce Commerce API Settingsを開き、Short Code(8文字)とOrganization ID(
f_ecom_の後にテナントIDが続く、例えばf_ecom_zzrf_001)をメモします。テナントIDはf_ecom_の後の部分です(ここではzzrf_001)。 - アカウントマネージャー(
https://account.demandware.com)でAPI Client, Add API Clientを開きます。パスワードを設定します(これがクライアントシークレットになります)およびトークンエンドポイント認証方法をclient_secret_basicに設定します。 - Rolesの下に
Salesforce Commerce APIを追加し、そのテナントフィルターとしてあなたのテナントIDを設定します。 - Allowed Scopes(およびDefault Scopes)の下に正確に次の内容を追加します:
sfcc.orders.rw sfcc.products.rw sfcc.catalogs sfcc.inventory-lists.rw sfcc.customerlists sfcc.customergroups。保存し、クライアントがアクティブであることを確認します。 SFCC_SHORT_CODEにショートコードを、SFCC_TENANT_IDにテナントIDを、サイトID(例えばRefArch、Merchant ToolsのSitesから)をSFCC_SITE_IDに、APIクライアントIDとパスワードをSFCC_CLIENT_IDおよびSFCC_CLIENT_SECRETに入力します。
コネクタはhttps://account.demandware.com/dwsso/oauth2/access_tokenにクライアント資格情報トークンを要求し、スコープSALESFORCE_COMMERCE_API:にあなたのテナントIDと上記のスコープを追加し、トークンが期限切れになるまで再利用します(約30分)。1つのトークンは1つのインスタンス(テナント)をカバーします。ステージングと本番環境ではコネクタを2回インストールします。
開始する場所: salesforce_commerce_cloud_list_orders(新しいものから順に、ステータスと日付でフィルタリング)、次にsalesforce_commerce_cloud_get_order。製品についてはsalesforce_commerce_cloud_search_productsをフレーズで検索し、次にsalesforce_commerce_cloud_get_productを使用します。
注文: salesforce_commerce_cloud_list_orders, salesforce_commerce_cloud_get_order。ステータス: salesforce_commerce_cloud_update_order_shipping_status, salesforce_commerce_cloud_update_order_export_status(OMSまたはERPが注文をエクスポートしたことを示します; これにより在庫が確定します)、salesforce_commerce_cloud_update_order_confirmation_status, salesforce_commerce_cloud_update_order_external_status。salesforce_commerce_cloud_update_order_status(注文をキャンセルまたは失敗させることができます)およびsalesforce_commerce_cloud_update_order_payment_statusはオフに設定されています。ツールは返金、キャプチャ、またはその他の方法でお金を移動せず、注文を作成することもありません。
製品とカタログ: salesforce_commerce_cloud_search_products(IDと名前のフレーズ)、salesforce_commerce_cloud_query_products(完全なクエリ: catalogId, categoryId, lastModified, online, type)、salesforce_commerce_cloud_get_product, salesforce_commerce_cloud_list_product_variations, salesforce_commerce_cloud_update_product, salesforce_commerce_cloud_list_catalogs, salesforce_commerce_cloud_list_categories, salesforce_commerce_cloud_get_category。テキストフィールドはローカライズされたオブジェクトです(defaultにde-DEなどのロケールが加わります)。オンラインおよび検索可能なフラグはサイトごとです。
在庫: salesforce_commerce_cloud_get_inventory_list, salesforce_commerce_cloud_get_inventory_recordおよびsalesforce_commerce_cloud_update_inventory_recordは、リストIDと製品IDによってB2C在庫リスト(Merchant Tools、Products and Catalogs、Inventory)で動作します。リストのすべてのレコードをリストする呼び出しはありません。オムニチャネル在庫(OCI)はカバーされていません。
顧客: salesforce_commerce_cloud_search_customers(顧客番号、メール、名前、会社のフレーズ)、salesforce_commerce_cloud_get_customer, salesforce_commerce_cloud_list_customer_addressesおよびsalesforce_commerce_cloud_list_customer_groups。顧客リストはしばしばサイトの名前が付けられています; Merchant Tools、Customers、Customer Listsを参照してください。
サイトとID: コネクタに設定されたサイトID(SFCC_SITE_ID)は、ツールのsite_idが省略された場合に使用されます; 注文呼び出しはこれがないと失敗します。製品、カテゴリ、および注文IDは文字列です; orderNoは購入者が見る番号です。時間はUTCのISO 8601形式です。
ページングと制限: リストは制限とオフセットを取ります(注文、製品および顧客の検索はページあたり最大200、カタログ、カテゴリ、バリエーション、住所およびグループは最大50)。注文リストは合計を返さず、オフセットと制限10,000で停止します: 日付で絞り込みます。検索の回答は合計を持ちます。Salesforceは忙しいインスタンスを制限します: 429は秒単位のRetry-Afterを伴い、503は負荷軽減を意味し、504は呼び出しが60秒以上かかったことを意味します。エラーはtitleとdetailを持つ問題文書です; 403は「組織へのアクセスが拒否されました」を意味し、テナントIDまたはロールテナントフィルターが間違っていることを示し、1つのAPIで403が発生すると、そのスコープがAPIクライアントから欠落していることを意味します。
前提条件: SFCC_SHORT_CODE, SFCC_TENANT_ID, SFCC_CLIENT_ID, SFCC_CLIENT_SECRET
コネクタをローカルにインストールする
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
http://localhost:3000/connectors/storeを開き、Salesforce Commerce Cloudを選択し、前提条件の下にリストされている環境変数を貼り付けます。
利用可能なツール
| ツール | 何をするか |
|---|---|
salesforce_commerce_cloud_list_orders | サイトの注文をリスト表示します。デフォルトでは新しいものから順に: orderNo, status, paymentStatus, shippingStatus, exportStatus, confirmationStatus… |
salesforce_commerce_cloud_get_order | 注文番号で1つの注文を取得します: ステータス、customerInfo(customerNo, email)、billingAddress、productItems(productId, productName, quantity… |
salesforce_commerce_cloud_update_order_shipping_status | 注文の配送ステータスを設定します: not_shipped, part_shippedまたはshipped。204で応答します。この呼び出しで購入者に通知はされません |
salesforce_commerce_cloud_update_order_export_status | 注文のエクスポートステータスを設定します(あなたのOMSまたはERPがそれを取得したかどうか): not_exported, ready, exportedまたはfailed。exportedを設定中… |
salesforce_commerce_cloud_update_order_confirmation_status | 注文の確認ステータスを設定します: confirmedまたはnot_confirmed。204で応答します |
salesforce_commerce_cloud_update_order_external_status | 注文の外部ステータスを設定します。あなたのOMSまたはERPが使用する自由な値(例えばIN_PICKING)。204で応答します |
salesforce_commerce_cloud_update_order_status | 注文のステータスを設定します: created, new, completed, cancelled, failedまたはfailed_with_reopen。注文をキャンセルまたは失敗させると、その… |
salesforce_commerce_cloud_update_order_payment_status | 注文の支払いステータスフラグを設定します: not_paid, part_paidまたはpaid。フラグのみが変更されます(お金は移動しません)が、財務およびOMS… |
salesforce_commerce_cloud_search_products | IDと名前のフレーズで製品を検索します(Admin Products API): 合計とヒットがid, name, type(master, variant, item, set… |
salesforce_commerce_cloud_query_products | 完全なSalesforce検索クエリで製品を検索します: term, text, rangeおよびboolクエリがid, name, online, searchable, type… |
salesforce_commerce_cloud_get_product | IDで1つの製品を取得します: name, descriptions, type, brand, ean, upc, manufacturer, onlineおよびサイトごとのsearchable, priceおよびcurrency, atsおよび… |
salesforce_commerce_cloud_list_product_variations | マスタ製品のバリエーションをリスト表示します: productId, variationValues(例えば色とサイズ)およびonlineフラグ。ページあたり最大50 |
salesforce_commerce_cloud_update_product | 製品フィールドを変更します(部分的: 送信されたフィールドのみ)。テキストフィールドはローカライズされたオブジェクトです |
salesforce_commerce_cloud_list_catalogs | インスタンスのカタログをリスト表示します: id, name, description, online, isMasterCatalog, assignedSites, rootCategoryおよびカテゴリと製品… |
salesforce_commerce_cloud_list_categories | カタログのカテゴリをリスト表示します: id, name, parentCategoryId, online, position, descriptionおよびページメタデータ。ページあたり最大50 |
salesforce_commerce_cloud_get_category | 指定された深さまでのサブカテゴリを持つカタログの1つのカテゴリを取得します: id, name, online, parentCategoryId, categoriesおよびページ… |
salesforce_commerce_cloud_get_inventory_list | 1つのB2C在庫リストを取得します: id, description, defaultInStockFlag, useBundleInventoryOnlyおよびそれが割り当てられているサイト |
salesforce_commerce_cloud_get_inventory_record | 1つの在庫リスト内の1つの製品の在庫を取得します: allocation(amount, resetDate)、stockLevel、ats(販売可能)、turnover… |
salesforce_commerce_cloud_update_inventory_record | 1つの在庫リスト内の1つの製品の在庫配分を設定します(部分的な更新)。配分は現在の量を置き換えます; atsはその後… |
salesforce_commerce_cloud_search_customers | 顧客番号、メール、名、姓または会社のフレーズで顧客リストの登録済み顧客を検索します: 合計とヒットが… |
salesforce_commerce_cloud_get_customer | 1人の登録済み顧客を取得します: customerNo, email, firstName, lastName, 電話番号, 誕生日, 性別, companyName, creationDate… |
salesforce_commerce_cloud_list_customer_addresses | 顧客の保存された住所をリスト表示します: addressId, firstName, lastName, address1, address2, city, postalCode, stateCode, countryCode, phone… |
salesforce_commerce_cloud_list_customer_groups | サイトの顧客グループをリスト表示します: id, description, type(staticまたはdynamic)およびrule。ページあたり最大50 |
例のプロンプト
- "サイトRefArchの今日の注文はどれで、まだエクスポートされていないのはどれですか?"
- "注文00012345の配送および支払いステータスを表示してください。"
- "在庫リストに10未満のユニットがあるカテゴリwomens-shoesの製品を見つけてください。"
- "在庫リストinventory_mの製品701644031206Mの在庫を40に設定してください。"
- "顧客グループはどれがありますか?"
次のステップ
このガイドは役に立ちましたか?