ShopifyとClaudeをMCPで接続する方法|ストアのデータをAIが作業

Connect AIでShopifyとClaudeを接続

この記事でわかること

・ClaudeにShopifyのデータを貼り付けて手作業で反映する運用の限界と、MCPで実ストアに直接つなぐ意味
・Shopify AI Toolkitの導入・認証から、開発ストアでの検証・プレビュー・本番反映までの6ステップ
・手順をそのまま実行できるうえ、複数システムにまたがるAIのアクセスをCData Connect AIで統制する判断材料も得られる

ShopifyでClaudeを使うとき、多くの方が同じやり方をしているのではないでしょうか。商品データやテーマのコードをチャットに貼り付け、Claudeに手直しを頼み、返ってきた結果を自分の手でストアに反映しています。単発の作業ならこれで足ります。ただ、作業が増えるとこのやり方は回らなくなりますし、そもそもClaudeはストアの中身を一度も見ていません。

この状況は、両者をきちんと接続すると変わります。Model Context Protocol(MCP)は、AIエージェントを業務システムにつなぐオープン標準です。このMCPのサーバーを介すると、ClaudeはストアのGraphQLスキーマ・Admin API・開発者ドキュメントに、構造化された形でリアルタイムにアクセスできるようになります。接続後のClaudeは、テーマの監査や商品の一括更新をこなし、クエリを実行する前にAPIスキーマを確かめることもできます。相手にしているのは、チャット欄に貼り付けたスナップショットではありません。いま動いている実際のストアのデータです。

公式のMCP接続だけでは足りないチームには、CData Connect AIという選択肢もあります。マネージドMCPプラットフォームとしてこの接続を拡張し、AIとストアの間のやり取りすべてに、認証の一元管理・アクセス制御・監査ログを加えます。

ClaudeとShopifyをつなぐと何ができる?

MCPで実ストアにつなぐと、Claudeはテーマの監査・商品データの一括更新・APIスキーマの検証を、ストアの現状に合わせて進められます。具体的には、次の3つです。

  • テーマの監査:shopify theme checkのリンターの指摘を読み取り、該当するファイルへ修正を当てます(Step 5)。

  • 商品データの一括更新:商品説明など、商品データをまとめて書き換えます。

  • スキーマの検証:クエリを実行する前に、introspect_admin_schemaで現行のAdmin APIスキーマを確かめます(Step 5)。

各手順の詳細は、Step 1〜6で順に扱います。

Shopify AI ToolkitとConnect AIの違いは?

本記事が扱うのは、店頭で顧客に応対する接客用のAIチャットボットではなく、運営・開発側の担当者がClaudeでストアを扱う方法です。

ShopifyとClaudeをつなぐ経路は、大きく2つに分かれます。本記事のStep 1〜6で扱うのは、Shopify AI Toolkitを使う開発者向けの経路です。テーマの編集や商品データの一括更新を自分の端末から進める方は、こちらを順に読んでください。

一方、複数のシステムや複数の担当者がAIにリアルタイムデータを扱わせる場面では、アクセストークンを人ごと・コネクタごとに管理する運用が負担になります。ここで論点になるのが、Connect AIのようなMCPの管理基盤です。AIのアクセスをどう統制するかを検討しているIT部門の方は、後半の「AIのShopifyアクセスをどう統制する?」から読み始めても構いません。組織としてMCPの接続方式をどう選ぶかは、組織でのMCP導入・接続方式を選ぶ3つの評価軸で整理しています。

経路

主な担い手

主な用途

認証・権限の管理

Shopify AI Toolkit(Claude Codeなど)

開発者・EC運営の技術担当

テーマ編集・商品の一括更新・スキーマ確認

OAuthまたはアクセストークンを担当者が個別に管理

CData Connect AI

IT部門・データ管理者

Shopifyを含む複数システムへのAIアクセスの統制

認証を一元化し、アクセス制御と監査ログを適用

どちらを選ぶかは、次の3点で判断できます。

  • 担当者が少数で、単一のストアだけを扱う場合は、Shopify AI Toolkitが向いています。

  • 複数のシステムや担当者にまたがり、トークン管理が負担になる場合は、Connect AIが向いています。

  • AIのアクセスについて監査証跡が必要な場合も、Connect AIが向いています。

Step 1:連携前に何を準備する?

Claudeがストアに触れる前に、ツールチェーンを整えておく必要があります。ここを飛ばすと、あとで認証エラーや、エラー表示のないままコマンドが失敗する問題の切り分けに時間を取られます。

次の3つを、最新の状態でインストールしておきます。

ツール

最低バージョン

備考

Node.js

v18+

Claude CodeやShopify CLIとの互換性を考えると、v20.10以降を推奨

Shopify CLI

v3.x

テーマのpull・push、ストア操作に必要

Claude Code

最新

Anthropicのターミナル向けAIエージェント

Claude Codeは、Anthropicが提供するターミナル向けのツールです。手元のマシン上で、ファイルの読み書き・CLIコマンドの実行・APIの操作・コードの編集を直接行います。テキストボックスに打ち込むチャット画面とは違い、ローカル環境の中で動くツールです。ストア単位の操作ができるのは、この性質があるからです。

まずNode.jsをインストールし、続けてShopify CLIを入れます。

npm install -g @shopify/cli @shopify/theme

注:現行バージョンでは、@shopify/themeは独立したパッケージではなく@shopify/cliに同梱されています。

IDEで作業したい場合、Shopify AI ToolkitはMCP対応のエージェントをサポートするCursorやVS Codeの拡張機能でも使えます。Claude Codeは基準となる経路ですが、唯一の選択肢ではありません。

Step 2:AI Toolkitはどう導入する?

Shopify AI Toolkitは、GraphQLスキーマ・開発者ドキュメント・ストアのリアルタイム操作をAIアシスタントに公開するツール群です。Claude Codeで有効にすると、手作業で行っていたAPI作業の多くを肩代わりする専用ツールが使えるようになります。

推奨はプラグインによる導入です。1回のインストールで一式がそろい、Shopifyが新機能を出すたびに自動で更新されます。

プラグインの導入手順(推奨):

1. Claude CodeでShopifyのマーケットプレイスを有効にします。

/plugin marketplace add Shopify/shopify-ai-toolkit

2. プラグインをインストールします。

/plugin install shopify-plugin@shopify-ai-toolkit

Dev MCPサーバーに直接接続する場合は、代わりに次のコマンドを使います。

claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest

3. 新しいツールが正しく登録されるよう、Claude Codeを再読み込みします。

再読み込みが終わると、Dev MCPサーバーからShopify開発向けに次のツールが使えます。

ツール

できること

search_dev_docs

Claudeの中からShopifyの開発者ドキュメントを検索する

introspect_admin_schema

クエリを実行する前に、現行のGraphQL Admin APIスキーマを取得する

fetch_docs_by_path

パスを指定して特定のドキュメントページを取得する

上の表はDev MCPサーバー経由の3つで、Toolkit全体には7つのツールがあります。プラグインで導入すれば、ストアでの実行機能を含む7つすべてが使えます。

これらのツールが有効なら、Claudeは現行スキーマの照会・最新ドキュメントの取得・変更の事前検証までをこなします。ツールがなければ、手元にあるのは固定されたコンテキストだけです。それがストアのいまのAPIの状態と一致していることを、祈るしかありません。

Shopify AI Toolkitは、MCPを実装したものの一つです。MCPを含むAIエージェント接続の最新動向は、AIエージェント接続トレンド2026で確認できます。

Step 3:Shopifyストアの認証はどう通す?

Claude Codeで初めてストアにつながる操作(connect storeやlist themesなど)を実行すると、OAuthのブラウザ画面が開きます。フローを最後まで進めれば、Claudeはストアへのアクセスを認可されます。認可はセッションをまたいで保持されるため、次回以降は認証し直さずに作業を再開できます。

OAuthが運用に合わない場合、Shopify CLIはTheme Accessパスワードやカスタムアプリのアクセストークンによる認証にも対応しています。

コミュニティ製のMCPサーバー(GeLi2001のshopify-mcpなど)で高度な操作をするには、必要なAPIスコープを付与したShopifyのアクセストークンが要ります。トークンはshpat_...の形式で、Shopify Partnerのダッシュボードまたはストアの管理画面から発行します。

守っておきたいセキュリティの習慣は次の3つです。

  • OAuthは、自分が管理するマシンの信頼できるブラウザでのみ完了させましょう。

  • アクセストークンは、Slack・メール・バージョン管理に載せないでください。

  • アプリのアクセス権限は定期的に棚卸しし、不要なものは取り消しましょう。パスワードのローテーションと同じ扱いです。

この3つは、どれも担当者が手作業で守るルールです。使う人やトークンの数が増えるほど、この運用をどう回すかが課題になります。この点は、後半のガバナンスの節で改めて取り上げます。

Step 4:変更はどこで安全に試す?

Claude Codeは一括変更をすばやく実行します。本番では頼もしい性質ですが、試行錯誤の段階ではリスクにもなります。最初は必ず、開発ストアかバックアップテーマで作業してください。

変更作業を始める前に、公開中のテーマをバックアップします。

shopify theme pull --theme {live-id} --path ./.backup-{timestamp}

バックアップは、バージョン管理のブランチにコミットしておきます。問題が起きても、きれいな状態に戻せる地点と、何が変わったかを正確に示す差分が手元に残ります。

開発ストアかバックアップテーマで作業し、その間もバージョン管理は止めずに回し続けます。プレビューでの確認と本番への反映は、Step 6で扱います。

Step 5:スキーマと変更はどう検証する?

Shopify AI Toolkitで特に役立つのが、プログラムからのスキーマのイントロスペクションです。GraphQLでいうイントロスペクションとは、クエリを書く前にAPI自身へ問い合わせて、現在の構造を把握することを指します。Admin APIのフィールドは非推奨になることがあります。古いスキーマに合わせて書いたクエリは、エラーを出さずに失敗したり、想定外のデータを返したりします。

流れは次のとおりです。

  • Admin APIのGraphQLクエリを組み立てる前に、introspect_admin_schemaを呼び出します。非推奨になったフィールドや名前が変わったフィールドを使わずに済みます。

  • 商品の一括更新やテーマ編集のコードは、実行前にClaudeのsearch_dev_docsツールで検証します。

  • Shopify組み込みのリンターを実行します。

    shopify theme check

Claude Codeは、リンターの出力を読み取って指摘された問題を修正できます。たとえばloading="lazy"属性のない画像が指摘されれば、該当するファイルすべてに自動で修正を当てます。

スキーマのイントロスペクションとリンターを組み合わせれば、本番ストアで実行時エラーとして表に出るはずだった問題の大半を、事前に拾えます。

Step 6:本番ストアへはどう反映する?

ここまでで、変更は開発テーマでテストされ、リンターの検証も通っています。本番に出す前の最後の工程が、プレビューURLを使った関係者のレビューです。

shopify theme share

このコマンドで、訪問者向けのプレビューリンクが作成されます。Shopifyのドキュメントによると、このリンク(URL)の有効期間は2日間です。管理者権限を持つレビュアー向けのマーチャントプレビューリンクは、30日間有効です。関係者は、本番に触れずに実際のストアフロントを確認できます。クライアント・マーチャンダイジングの責任者・QA担当など、承認が必要な相手に共有してください。レビューを通過してから、本番に反映します。

shopify theme push --theme {live-id}

反映中はログを見ておきます。想定外のエラーが出ても、Claude Codeがその場で出力の読み解きを手伝ってくれます。

本番反映前のチェックリスト:

  • テーマのバックアップをバージョン管理にコミットした

  • shopify theme checkのリンターを通過した

  • プレビューURLを関係者が確認し、承認した

  • 一括変更の結果を1件ずつ確認した

  • ロールバックの手順を確認した

Claude Codeは、40件以上の商品説明の書き換えといった一括操作を数秒で終えます。大きな操作を実行したら、その直後に結果を確かめてください。

安定して運用し続けるためのコツは?

  • 変更は小さく区切る:「商品ページを全部更新して」のような曖昧な指示は避けます。「商品ページの背景色を#F5F5F5に変更して」のように具体的に頼めば、Claudeは範囲の決まったタスクに取り組めて、結果も検証しやすくなります。

  • すべてをバージョン管理する:AIを使ったツールは動きが速いものです。Gitのブランチで差分の履歴とロールバックの手段を確保しておけば、その速さが負債に変わるのを防げます。

  • コミュニティ製MCPサーバーが何を足すかを把握する:GeLi2001のshopify-mcpなどのサーバーは、コレクション・下書き注文・一括操作を扱うエージェント用のツールをToolkitに追加します。ツールの数は更新のたびに変わるため、最新の数はリポジトリで直接確認してください。こうしたサーバーには、適切なスコープを付けたAPIトークンが必要です。トークンを発行する前に、必要なスコープを確認しておきましょう。

  • Toolkitの更新に追従する:Shopify AI Toolkitは活発に開発が続いています。プラグインで導入していれば、更新は自動です。エージェントスキルやMCPで直接導入した場合は、新しいプロジェクトを始める前に手動で更新を取り込み、スキーマのずれ(スキーマドリフト)を防いでください。

  • 連携の手順を文書化する:どのタスクにどのMCPツールを使っているか、それぞれに必要なAPIスコープ、ロールバックの手順を記録しておきます。新しいメンバーを迎えるときや、数か月後に障害を調べるときに効いてきます。

ただ、ここまでの工夫はどれも、担当者一人ひとりの規律に頼ったものです。扱うシステムや関わる人が増えたとき、それだけで足りるでしょうか。

AIのShopifyアクセスをどう統制する?

Shopify AI Toolkitは、Claudeとストアをつなぐという役割をしっかり果たします。一方で、より広いIT上の課題には答えていません。複数のシステムにまたがるリアルタイムの業務データへのAIのアクセスを、システムごとに個別の連携を作らずに、規模が大きくなってもどう統制するかという課題です。

CData Connect AIは、ClaudeなどのAIアシスタントを、Shopifyを含む数百の業務データソースにつなぐマネージドMCPプラットフォームです。接続はノーコードで設定でき、AIからのアクセスはすべてConnect AIを経由します。具体的には、次の3点で個別のトークン運用を置き換えます。

  • 認証の一元化:コネクタごとにAPIトークンやスコープを管理する代わりに、認証をConnect AIに集約します。Step 3で見たトークンの発行・共有・棚卸しを、担当者ごとにばらばらに抱える状態から離れられます。

  • アクセス制御:AIがどのデータにアクセスできるかを、Connect AI側のアクセス制御で強制します。

  • 監査ログ:AIとデータのやり取りをすべて記録し、コンプライアンス部門が求める監査証跡を残します。

ShopifyとあわせてERP・CRM・マーケティング基盤でもClaudeを使うチームにとって、Connect AIは公式のToolkitにない企業向けの統制レイヤーになります。データパイプラインを組まずにリアルタイムデータへアクセスでき、監査証跡も手に入ります。権限設計やリスク対策を全社の方針として固めたい場合は、エンタープライズMCPガバナンス完全ガイドも参考になります。

Connect AIを使ってShopifyとClaudeを接続する具体的な手順は、ナレッジベースの記事で紹介しています。

よくある質問

ShopifyをClaudeに接続するには何が必要?

Node.js(v18以降)・Shopify CLI・Claude Code(または対応するIDEプラグイン)が必要で、エージェント側でShopify AI Toolkitを有効にします。ストアに安全にアクセスするため、ブラウザでのOAuth認証も必要です。

Claudeでストアを安全に更新するには?

Claudeで変更を試すときは、必ずバックアップテーマか開発テーマを使います。本番に反映する前にtheme shareでプレビューし、AIが生成した変更を1件ずつ確認すれば、本番での思わぬ不具合を防げます。

開発者でなくてもClaudeでShopifyストアを改善できる?

できます。初期設定には技術的な作業が要りますが、その後は自然言語のプロンプトを使い、ストアの監査やコンテンツ更新といった作業をコーディングなしで自動化できます。

ClaudeをShopifyで使うときの制約は?

Claudeが得意なのはプロトタイピング・監査・テーマ編集で、本番アプリのパッケージ化や公開には向きません。課金のように完全には自動化されていない機能もあり、人による確認が必要です。

Claude Code以外にShopifyと連携できるツールは?

CursorなどのIDE拡張機能、Gemini CLI、VS Codeのプラグインがあります。いずれもShopify AI Toolkitを使い、AIによるストア管理を行えます。

Shopify AI ToolkitとCData Connect AIはどう使い分ける?

Shopify AI Toolkitは、Claude Codeなどから自分のShopifyストアに接続し、テーマ編集・一括更新・スキーマ確認を行う開発者向けのツールです。CData Connect AIは、Shopifyを含む数百の業務データソースへのAIのアクセスを、認証の一元化・アクセス制御・監査ログで統制するマネージドMCPプラットフォームです。複数のシステムや担当者にまたがってAIを使う場合はConnect AIが向いています。

ShopifyのAIチャットボット(接客用)とは何が違う?

本記事で扱うのは、店頭で顧客の質問に答える接客用のAIチャットボットではありません。運営・開発側の担当者がClaudeからストアを操作し、テーマの監査や商品データの一括更新、スキーマの確認を進めるための接続方法です。

ShopifyのデータをClaudeで安全に使う

CData Connect AIは、接続・セキュリティ・ガバナンスをまとめて引き受けます。Shopifyを含む業務データソースへのAIのアクセスを、トークンの個別管理に頼らず、認証の一元化・アクセス制御・監査ログで統制できます。

14日間の無料トライアルを始めて、Claudeで最初のリアルタイムクエリを実行してみてください。

ShopifyのデータをClaudeで安全に使う

個別のアクセストークン運用に頼らず、ShopifyへのAIアクセスを統制したい方へ。CData Connect AIは認証の一元化・アクセス制御・監査ログを備えたマネージドMCPプラットフォームです。

無料トライアルをスタート