0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Shopify Agentic Storefronts入門 — MCPでAIショッピングエージェントを構築する

0
Last updated at Posted at 2026-03-23

Shopify Agentic Storefrontsの全体像

はじめに

AIエージェントが商品を検索し、カートに追加し、チェックアウトまで完了する「エージェントコマース」の時代が到来しつつある。Shopifyは Winter '26 Edition (2025年12月発表)で Agentic Storefronts を発表し、2026年に入って本格展開を進めている。ChatGPT・Perplexity・Microsoft Copilotといった主要AIプラットフォームに商品カタログを自動露出する仕組みが整備された。

この記事では、Shopifyが提供する Storefront MCPサーバーShopify Catalog 、そしてGoogle・Shopifyが共同策定した Universal Commerce Protocol(UCP) の3つの柱を中心に、エンジニアがAIショッピングエージェントを構築するための全体像を解説する。

この記事で学べること

  • Shopify Agentic Storefrontsのアーキテクチャと構成要素
  • Storefront MCPサーバーのセットアップ手順
  • Shopify Catalogによる商品検索APIの利用方法
  • UCP(Universal Commerce Protocol)の仕組みと対応プラットフォーム
  • AIエージェント × コマースの設計パターンと注意点

対象読者

  • AIエージェント開発に取り組むエンジニア
  • MCP(Model Context Protocol)を活用したいバックエンド開発者
  • ECプラットフォームとAIの統合に関心があるエンジニア

前提知識

  • Node.js(v18.20以上)の基本操作
  • MCP(Model Context Protocol)の基本概念
  • Shopify Partner アカウント(開発ストア作成に必要)

TL;DR

  • Shopify Agentic Storefrontsは、Storefront MCP・Shopify Catalog・UCPの3層でAIエージェントにコマース機能を提供する
  • Storefront MCPサーバーは個別ストアの商品検索・カート管理・ポリシー参照をAIエージェントから操作可能にする
  • Shopify Catalogは全Shopifyマーチャントの商品を横断検索できるグローバルインデックス
  • UCP(Universal Commerce Protocol)はGoogle・Shopify共同策定のオープン標準で、Visa・Mastercard・Stripeなど20社以上が支持

Shopify Agentic Storefrontsとは

Agentic Storefrontsの3層アーキテクチャ

Agentic Storefrontsは、Shopifyの Winter '26 Edition で発表されたAIコマース基盤である。従来のECサイトがWebブラウザ経由で人間に商品を見せていたのに対し、Agentic Storefrontsは AIエージェント経由 で商品を発見・購入できるインフラを提供する。

公式ドキュメントによると、マーチャント側の設定は1回だけで済む。Shopify管理画面から有効化すれば、 Shopify Catalog が商品データを構造化し、ChatGPT・Perplexity・Microsoft Copilotに自動で配信する仕組みになっている。

3つの構成要素

構成要素 役割 スコープ
Storefront MCP 個別ストアの商品検索・カート・ポリシー操作 単一ストア
Shopify Catalog 全Shopifyマーチャントの商品横断検索 グローバル(数十億商品)
UCP コマースライフサイクル全体の標準プロトコル マルチプラットフォーム

開発者がどのコンポーネントを使うかは、ユースケースによって異なる。単一マーチャント向けのカスタムAIアシスタントであればStorefront MCPが適しており、マーケットプレイス型のAIエージェントを構築するならShopify Catalogが推奨される。

Storefront MCPサーバーの仕組み

Storefront MCPサーバーは、MCP(Model Context Protocol)に準拠したAPIエンドポイントで、AIエージェントに対してShopifyストアのコマースデータへの構造化されたアクセスを提供する。

提供ツール

Storefront MCPサーバーが公開するツールは、公式ドキュメントで tools/list コマンドにより確認できる。主要なツールカテゴリは以下のとおりである。

カテゴリ 機能 具体例
商品検索 自然言語による商品検索、レコメンデーション 「赤いスニーカー 27cm」で検索
カート管理 カート作成・アイテム追加・数量変更・削除 quantity: 0 で削除
ストアポリシー 返品・配送・プライバシーポリシーの参照 返品条件の確認
チェックアウト チェックアウトURL生成(Checkout Kit経由) 購入フローの開始

2種類のMCPサーバー

Shopifyは2つのMCPサーバーを提供している。

1. Storefront MCPサーバー
未認証ユーザー向け。商品ブラウジング、カート操作、ストアポリシー参照が可能。主にショッピングアシスタントの構築に使用する。

2. Customer Accounts MCPサーバー
認証済みユーザー向け。注文追跡、注文詳細の取得、アカウント設定の管理が可能。顧客サポートエージェントの構築に使用する。

セットアップ手順

公式ドキュメントに基づくStorefront MCPサーバーのセットアップ手順を示す。

1. 前提条件の確認

  • Node.js v18.20以上
  • Shopify Partnerアカウント
  • サンプル商品が登録された開発ストア

2. Shopifyアプリの作成

npm init @shopify/app@latest -- --template node
cd my-shopify-app
npm install

3. MCPクライアントの設定

MCPクライアントは、AIモデルとMCPサーバー間の通信を仲介するShopifyアプリである。設定ファイルで接続先のMCPサーバーを指定する。

{
  "mcpServers": {
    "shopify-storefront": {
      "url": "https://{store-domain}/mcp/storefront",
      "transport": "streamable-http"
    }
  }
}

4. ツールの呼び出し

MCPクライアントからツールを呼び出すイメージを以下に示す。ツール名やパラメータの正式な仕様は、接続後に tools/list で確認できる。

// 商品検索の例(ツール名は tools/list で確認)
const searchResult = await mcpClient.callTool({
  name: "search_shop_catalog",
  arguments: {
    query: "wireless headphones",
    limit: 10
  }
});

// カートへの追加
const cartResult = await mcpClient.callTool({
  name: "cart_add_item",
  arguments: {
    variantId: "gid://shopify/ProductVariant/12345",
    quantity: 1
  }
});

Shopify Catalogによるグローバル商品検索

Shopify Catalogの仕組み

Shopify Catalogは、全Shopifyマーチャントの商品を 数十億規模 で横断検索できるグローバルインデックスである。Winter '25 Editionで全開発者に開放された。

データ構造

公式ドキュメントによると、検索結果には以下のデータが含まれる。

  • 商品詳細: タイトル、説明文、画像
  • 価格帯: 全オファーを通じた価格レンジ
  • オプション: サイズ、色などの選択肢
  • ショップ情報: 個別の価格とチェックアウトURL
  • ユニバーサル商品ID: 詳細検索用の一意識別子

これらの構造化はShopify側で自動的に行われ、マーチャントが個別に設定する必要はない。

利用方法

公式ドキュメントによると、Shopify CatalogはMCP経由とREST API経由の2通りで利用できる。Catalog MCPは search_global_productsget_global_product_details の2つのツールを提供しており、JWT認証が必要となる。

Catalog MCPサーバー経由(推奨)

// Catalog MCPでの商品検索(公式ツール名)
const catalogResult = await mcpClient.callTool({
  name: "search_global_products",
  arguments: {
    query: "organic cotton t-shirt"
  }
});

// 商品詳細の取得
const detailResult = await mcpClient.callTool({
  name: "get_global_product_details",
  arguments: {
    productId: "universal-product-id-here"
  }
});

REST API経由

Catalog REST APIは、MCP非対応の環境やカスタムバックエンドから利用する場合に適している。APIエンドポイントの詳細は shopify.dev/docs/agents/catalog で確認できる。

Storefront MCP vs Catalog MCPの使い分け

観点 Storefront MCP Catalog MCP
検索範囲 単一ストア 全Shopifyマーチャント
カート操作 可能 不可(検索のみ)
レート制限 ストア単位 グローバル制限
推奨ユースケース 特定ブランドのAIアシスタント マーケットプレイス型エージェント

Universal Commerce Protocol(UCP)

UCPコマースライフサイクル

UCPは、GoogleとShopifyが共同で策定した オープンソースのコマース標準 である。AIエージェントがコマース機能を利用するための共通言語と機能プリミティブを定義している。

支持企業

公式サイト(ucp.dev)によると、以下の企業がUCPを支持している。

  • Eコマース: Shopify、Etsy、Wayfair、Target、Walmart、Best Buy、Flipkart、Macy's、Zalando
  • 決済: Visa、Mastercard、Stripe、Adyen、American Express
  • テクノロジー: Google

3つのコア機能

UCPの初期リリースは3つのコア機能にフォーカスしている。

1. Checkout(チェックアウト)
AIエージェントがチェックアウトセッションを作成し、購入者情報の収集から決済完了までを実行する標準インターフェース。

2. Identity Linking(ID連携)
OAuth 2.0に基づき、AIエージェントのユーザーとマーチャント側の顧客アカウントを安全に紐付ける仕組み。クレデンシャルを共有せずに認可関係を維持できる。

3. Order Management(注文管理)
確定済み注文のトラッキング、フルフィルメントイベントの取得、購入後の調整(返品・交換など)を標準化する。

統合方式

UCPは既存のインフラと柔軟に統合できるよう設計されている。

統合方式 説明 適用ケース
REST API 標準的なHTTP API経由の統合 既存バックエンドからの統合
MCP Model Context Protocol経由 AIエージェントフレームワーク
A2A Agent-to-Agentプロトコル経由 マルチエージェントシステム

技術仕様と参照実装は GitHub リポジトリで公開されている。

AIプラットフォーム連携の現状

Shopify Agentic Storefrontsは、2026年3月時点で以下のAIプラットフォームとの連携をサポートしている。

プラットフォーム 連携方式 ステータス
ChatGPT(OpenAI) Shopify Catalog経由 提供中
Perplexity Shopify Catalog経由 提供中
Microsoft Copilot Shopify Catalog経由 提供中
その他AIプラットフォーム UCP / MCP対応 順次拡大予定

OpenAIはChatGPTでのエージェントショッピング機能を強化中であり、CNBCの2026年3月20日の報道によると、初回の実装を改善した第2弾を準備している。Visaもラテンアメリカ5市場でエージェントコマースのパイロットを完了しており、決済インフラ側の整備も進んでいる。

開発時の注意点

セキュリティ

  • チェックアウトフローでは、Shopifyの Checkout Kit を経由する設計が推奨されている。AIエージェントが直接クレジットカード情報を扱う設計は避けるべきである
  • Customer Accounts MCPサーバーを使用する場合、OAuth認証が必要となる。アクセストークンの管理と失効処理を適切に実装する必要がある

レート制限

  • Catalog MCPはグローバル共有のレート制限を受ける。大量リクエストが必要なユースケースでは、Storefront MCPとの併用が推奨されている
  • 公式ドキュメントでは、単一マーチャント向けエージェントの場合にStorefront MCPを優先する設計が推奨されている

プラットフォーム制約

  • Agentic Storefrontsは2026年3月時点で一部ストアへの早期アクセス段階であり、全ストアに開放されているわけではない。対象ストアにはShopify管理画面で通知が届く
  • Liquid テーマはShopify Catalog(AI検出)の恩恵を受けられるが、MCPのフル機能を活用するにはHeadless(Hydrogen)構成が推奨されている

Agentic Plan

Shopifyは新たに Agentic Plan という料金プランを提供している。AIチャネル経由の販売に特化したプランで、マーチャントがAgentic Storefrontsを有効化するために必要となる場合がある。プランの詳細と料金は shopify.com/agentic-plan で確認できる。

まとめ

  • Shopify Agentic Storefrontsは、 Storefront MCPShopify CatalogUCP の3層アーキテクチャでAIエージェントにコマース機能を提供する
  • Storefront MCPサーバーは個別ストアの商品検索・カート管理を、Shopify CatalogはShopify全体の商品横断検索を担当する
  • UCPはGoogle・Shopify主導のオープン標準で、Visa・Mastercard・Stripeなど20社以上が支持しており、エージェントコマースのデファクトスタンダードになる可能性がある
  • 2026年3月時点ではChatGPT・Perplexity・Copilotとの連携が提供中で、今後のAIプラットフォーム拡大に伴い、MCPベースのAIショッピングエージェント開発の需要は増していくと考えられる

参考リンク

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?