API MIGRATION

Storefront MCP廃止―UCP MCP ask_businessへ移行

search_shop_policies_and_faqsは2027年1月15日に廃止。今すぐask_businessへ切り替えを。

Storefront MCP/api/mcpsearch_shop_policies_and_faqsDEPRECATED移行〜2027/01/15UCP MCP/api/ucp/mcpask_businessNEW STANDARD

Storefront MCPサーバーが提供していたsearch_shop_policies_and_faqsツールは非推奨となりました。代替はUCP MCPのask_businessツールです。旧ツールは2027年1月15日まで維持されますが、すべての公式ドキュメントは新ツールを参照するよう更新されています。AIエージェントやチャットボットを構築している開発者は早期の移行を推奨します。

1変更内容の全体像

BEFORE(旧構成)AFTER(新構成)エンドポイントhttps://{shop}.myshopify.com/api/mcpエンドポイントhttps://{shop-domain}/api/ucp/mcpツール名search_shop_policies_and_faqsツール名ask_businessレスポンス形式生のナレッジベース事実・ポリシー全文レスポンス形式result.structuredContent.answer.plain(要約文)追加メタ不要metaオブジェクト必須ucp-agent.profile + dev.ucp.common.ask宣言

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
ドメイン形式とパスが両方変わる点に注意。

metaオブジェクト必須

すべてのリクエストに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日