【Shopify最新ニュース2026・開発者向け】Storefront MCP のポリシー検索ツールが廃止予定に、UCP の ask_business へ

2026年11月14日

開発者向けの変更です。
Storefront MCP にある、店のポリシーと FAQ を調べるツールが deprecated（非推奨）になりました。
代わりに使うのは、UCP MCP の ask_business です。
UCP MCP が ask の能力（ask capability）を実装し、そのツールとして出しているものです。

掲載は2026年11月11日、Shopify の開発者向けの Changelog です。

出典: Shopify Developer Changelog「Storefront MCP policies and FAQs tool is being deprecated in favor of UCP MCP Ask tool」2026年11月11日
https://shopify.dev/changelog/storefront-mcp-policies-and-faqs-tool-is-being-deprecated-in-favor-of-ucp-mcp-ask-tool

フラグは Deprecation announcement（非推奨の告知）と Action required（対応が必要）です。
タグは API で、移行の期限は2027年1月15日です。

何が廃止予定になるのですか？

対象は、Storefront MCP のサーバーにある search_shop_policies_and_faqs というツールです。
接続先は {shop}.myshopify.com/api/mcp で、このツールを使っているエージェントは移行が必要になります。
原文の言葉は「is deprecated」で、示されているのは保守の期限です。

The deprecated tool will be maintained until January 15, 2027, but all documentation will refer to Ask MCP.
（非推奨のツールは2027年1月15日まで保守されますが、ドキュメントは全て Ask MCP を参照するようになります）

期限までは今のツールも保守されると原文は書いています。
ただし、ドキュメントは全て Ask MCP を参照するようになります。
ご自身のコードがどちらを呼んでいるかを、先に見てください。

代わりの ask_business は何をするツールですか？

ask_business は、店のポリシーやサービスについての買い手の質問に答えるツールです。
答えには、店のナレッジベース（knowledge base）とポリシーが使われます。

ask_business: Answer a buyer’s question about the store’s policies and services, using the store’s knowledge base and policies.
（ask_business: 店のナレッジベースとポリシーを使い、店のポリシーとサービスについての買い手の質問に答えます）

接続先（endpoint）は {shop-domain}/api/ucp/mcp に変わります。
UCP の能力の名前は dev.ucp.common.ask で、UCP MCP がこれを実装しています。

開発者は何を変えればよいですか？

原文の What you should do（やるべきこと）には、5つの項目が並んでいます。
あなたのエージェントが今のツールを呼んでいるなら、ここが作業の範囲です。

1つ目は、呼び出しを ask_business に移すことです。接続先も {shop-domain}/api/ucp/mcp に変えます。
2つ目は、どのリクエストにも ucp-agent.profile を入れた meta object（付帯情報のまとまり）を付けることです。エージェントのプロフィールでは dev.ucp.common.ask を宣言します。
3つ目は、質問を ask.query に入れることです。国や好みの言語などの買い手の文脈（buyer context）は、任意で ask.context に入れます。
4つ目は、古い応答を解析するコードの更新です。答えの形が変わるためです。
5つ目は、店が ask_business を出しているかの確認です。あなたのエージェントのプロフィールで tools/list を使って確かめます。

Include a meta object carrying ucp-agent.profile in every request. Your agent profile must declare dev.ucp.common.ask.
（全てのリクエストに ucp-agent.profile を入れた meta オブジェクトを含めてください。エージェントのプロフィールで dev.ucp.common.ask を宣言する必要があります）

原文は、店が ask_business を出しているかを、あなたのエージェントのプロフィールで tools/list を使って見るよう書いています。
ご自身の実装に、呼ぶ前にこの一覧を見る手順を足すのも一つの手です。
これはキクシル編集部の提案で、原文の指示ではありません。

返ってくる答えの形はどう変わりますか？

原文は、応答を解析するコードの更新も求めています。
ask_business が返すのは書き上げた答え（written answer）で、ナレッジベースの生の事実（raw facts）やポリシーの全文ではありません。

Note that ask_business returns a written answer in result.structuredContent.answer.plain, not raw knowledge base facts or full policy text. Update any code that parses the old response.
（ask_business は、ナレッジベースの生の事実やポリシーの全文ではなく、result.structuredContent.answer.plain に書かれた答えを返します。古い応答を解析するコードは更新してください）

答えの場所は result.structuredContent.answer.plain です。
ポリシーの全文を受け取って自分で要約していたエージェントなら、応答を読む処理を更新してください。

店の側には何が関わりますか？

店主が設定を変える手順は、この Changelog には出てきません。
ただ、ask_business が答えに使うのは店のナレッジベースとポリシーなので、あなたの店の登録内容が答えの材料になります。

AIエージェントに聞かれたときの答えを整えたいなら、あなたの店のナレッジベースとポリシーの中身を見てください。
開発をアプリの会社に任せている店は、search_shop_policies_and_faqs を使っているかを問い合わせてください。
この2つはキクシル編集部の整理で、公式の記載ではありません。