Storefront MCP廃止―UCP MCP ask_businessへ移行
search_shop_policies_and_faqsは2027年1月15日に廃止。今すぐask_businessへ切り替えを。
Storefront MCPサーバーが提供していたsearch_shop_policies_and_faqsツールは非推奨となりました。代替はUCP MCPのask_businessツールです。旧ツールは2027年1月15日まで維持されますが、すべての公式ドキュメントは新ツールを参照するよう更新されています。AIエージェントやチャットボットを構築している開発者は早期の移行を推奨します。
1変更内容の全体像
2業務に活かせる具体ユースケース
- 課題
- ショップのポリシー(返品・送料など)についての問い合わせが多く、カスタマーサポートの工数を削減したい
- 打ち手
- ask_businessツールを使ってAIエージェントがバイヤーの質問にリアルタイムで回答するチャットボットを構築する
- 効果
- ストアのナレッジベースをもとにした要約回答が自動生成され、問い合わせ対応を自動化できる
- 技術メモ
- ask.queryに質問文、ask.contextにバイヤーの国・言語などを渡す。レスポンスはresult.structuredContent.answer.plainから取得。
- 課題
- 複数言語・国向けに展開するストアで、バイヤーごとに適切な言語でポリシー回答を返したい
- 打ち手
- ask.contextにバイヤーの優先言語・国情報を含めてask_businessへリクエストし、ローカライズされた応答を取得する
- 効果
- 国際展開ストアでも一つのエンドポイントでマルチ言語対応の自動回答が実現できる
- 技術メモ
- ask.contextはオプションフィールド。元記事にはcountryやpreferred languageが例示されている。
- 課題
- エージェントが特定のストアでask_businessが利用可能か動的に確認したい
- 打ち手
- UCP MCPエンドポイントに対してtools/listを呼び出し、ask_businessが返却リストに含まれるかチェックするロジックを実装する
- 効果
- ツールの提供有無をランタイムで確認でき、未対応ストアへの不正リクエストを防止できる
- 技術メモ
- tools/listの結果はエージェントプロファイルによって異なる可能性がある。metaオブジェクトのucp-agent.profileを正しく設定すること。
3技術者目線のポイント
旧ツールsearch_shop_policies_and_faqsは2027年1月15日まで動作するが、以降は利用不可。移行はできるだけ早期に着手すること。
旧:https://{shop}.myshopify.com/api/mcp
新:https://{shop-domain}/api/ucp/mcp
ドメイン形式とパスが両方変わる点に注意。
すべてのリクエストにucp-agent.profileを含むmetaオブジェクトを添付する必要がある。エージェントプロファイルにはdev.ucp.common.askを宣言しなければならない。
旧ツールは生のナレッジベース情報やポリシー全文を返していたが、新ツールは要約された回答文をresult.structuredContent.answer.plainに返す。レスポンスパース処理の更新が必須。
tools/listを使って特定ストアでask_businessが提供されているか動的に確認できる。エージェントプロファイルによって返却内容が変わる可能性がある。
以降のすべての公式ドキュメントはAsk MCPを参照する形に更新済み。詳細はshopify.dev/docs/agents/askを確認すること。
| 項目 | 旧(Storefront MCP) | 新(UCP MCP) |
|---|---|---|
| エンドポイント | /api/mcp | /api/ucp/mcp |
| ツール名 | search_shop_policies_and_faqs | ask_business |
| 質問フィールド | 記載なし | ask.query |
| バイヤーコンテキスト | 記載なし | ask.context(任意) |
| 回答フィールド | 生ポリシー情報 | result.structuredContent.answer.plain |
| メタ必須 | 不要 | ucp-agent.profile必須 |
| 廃止期限 | 2027年1月15日 | — |
AIエージェントでShopifyストアのFAQ・ポリシー対応を自動化するなら、2027年1月15日の廃止期限前にStorefront MCPからUCP MCPのask_businessへ移行することで、より構造化された回答取得とマルチコンテキスト対応が実現できます。
Source: https://shopify.dev/changelog/storefront-mcp-policies-and-faqs-tool-is-being-deprecated-in-favor-of-ucp-mcp-ask-tool | 公開日: 2026年11月11日






Share:
カスタムアプリにIPアローリスト必須化|2027年対応ガイド
顧客データ消去リクエストの保留期間が10日→5日に短縮