概要
Salesforce Commerce API (SCAPI)管理APIを通じたSalesforce B2C Commerce Cloud:注文とそのステータス、製品検索と編集、カタログとカテゴリ、在庫リストレコードおよび登録された顧客。アカウントマネージャAPIクライアント(クライアント認証情報)、ショートコード、テナントIDおよびサイトID。
ガイド付きセットアップ
Salesforce Commerce Cloud を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Salesforce Commerce Cloud を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 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 + Microsoft Copilot
Salesforce B2C Commerce CloudをSalesforce Commerce API (SCAPI)管理APIを通じて利用します:注文とそのステータス、製品検索と編集、カタログとカテゴリ、在庫リストレコードおよび登録された顧客。アカウントマネージャAPIクライアント(クライアント認証情報)、ショートコード、テナントIDおよびサイトID。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択したときにアプリ内ストアで表示されます)。このコネクタに必要な環境変数は以下の通りです:
SFCC_SHORT_CODE, SFCC_TENANT_ID, SFCC_CLIENT_ID, SFCC_CLIENT_SECRET
ステップ1 — 認証情報を取得する
セットアップには約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はB2C在庫リスト(Merchant Tools、Products and Catalogs、Inventory)でリストIDと製品IDを使用します;リストのすべてのレコードをリストする呼び出しはありません。オムニチャネル在庫(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クライアントから欠落していることを意味します。
ステップ2 — アダプタをインストールする
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
ステップ3 — Microsoft Copilotにコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き(または新規作成し)、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name(例:
AnythingMCP)、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー(MCP Servers → 対象のサーバー → API keys)を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
Salesforce Commerce Cloudのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| ツール | 機能 |
|---|---|
salesforce_commerce_cloud_list_orders | サイトの注文をリスト表示します。デフォルトでは新しいものから順に:orderNo、status、paymentStatus、shippingStatus、exportStatus、confirmationStatus… |
salesforce_commerce_cloud_get_order | 注文番号で1つの注文を取得します:statuses、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、名前、タイプ(master、variant、item、set… |
salesforce_commerce_cloud_query_products | 完全なSalesforce検索クエリで製品を検索します:term、text、rangeおよびboolクエリをID、名前、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(例:colorとsize)および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 | 顧客リストの登録された顧客を顧客No、メール、名、姓または会社のフレーズで検索します:合計とヒットに… |
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に設定してください。"
- "私たちにはどの顧客グループがありますか?"
FAQ
これはSalesforce CRMコネクタですか? いいえ。これはSalesforce B2C Commerce CloudをSalesforce Commerce API (SCAPI)管理APIを通じて利用するためのものです。Sales CloudとCRMにはそれぞれ独自のSalesforceコネクタとガイドがあります。
何が必要ですか? Salesforce Commerce APIロールを持つアカウントマネージャAPIクライアントと、ビジネスマネージャからのショートコード、テナントIDおよびサイトIDが必要です。アカウントマネージャの管理者が設定します。
どのツールが初期状態でオフになっていますか? salesforce_commerce_cloud_update_order_statusおよびsalesforce_commerce_cloud_update_order_payment_statusです。AIがこれらのステータスを変更する必要がある場合のみ、コネクタページでオンにしてください。
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント(ライセンスまたは試用版)が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?