Claude/Cursorを使用してShopifyデータをクエリする方法（Shopify MCPサーバーの設定）

このガイド以外のQuery Streamsの機能を見る 無料で始める

サポート

+さらに

ライブデータ

エクスポートをオンデマンドSQLに置き換える

エクセル シーツ

BI＆AIアナリティクス

ノヴァに訊け、SQL＋チャートを手に入れろ

ノヴァとの出会い

データベースREST API

パートナーごとに1つのキー。認証情報は共有されません。

APIを構築する

+さらに

オートメーション

6つ以上のプラットフォームへのスケジュール同期

エクスペリエンス

+さらに

APIからSQLへ

コードを書かずにSQLでAPIに問い合わせる

エクスペリエンス

+さらに

AIデータベースMCP

Claude、Cursor、ChatGPT、Grokがあなたのデータと対話します

コネクトAI

Query Streamsは、安全なリアルタイムデータ統合プラットフォームであり、ファイアウォールの変更なしに単一のMCPキーを介して、アカウント内のすべてのデータベースとSaaS APIをClaude、Cursor、ChatGPT、およびGrokに統合します。 このガイドでは、 Shopify MCP パスを具体的に指定することで、Shopify 管理画面からレポートをエクスポートしたり、GraphQL Admin API 呼び出しをつなぎ合わせたりすることなく、AI ツールが注文、顧客、製品、在庫、フルフィルメント、返金に関する平易な英語の質問に答えることができます。ネットワーク エージェントは Shopify Admin API データをローカルの DuckDB キャッシュに取り込むため、LLM は生の REST エンベロープではなく、クリーンな SQL サーフェス (注文、line_items、顧客、製品、バリアント、トランザクション、フルフィルメント) を参照できます。また、読み取り専用の管理スコープであるため、これは公式の Shopify Storefront MCP の代替ではなく、分析 + 運用を補完するものです。 詳細についてはQueryStreams.comをご覧ください そして 無料で登録する AIツールにShopify管理者の実際の質問を投げかけてみましょう。

Query Streams Shopify MCPサーバーが提供するもの

オープンソース環境にある他の「Shopify MCP」サーバーは、AIツールをShopify管理画面のRESTまたはGraphQL APIに直接接続し、生のリソース取得をプッシュします。これは機能しますが、ShopifyプライベートアプリトークンをAIクライアントの設定にプッシュし、LLMがSQLではなくRESTエンベロープとGraphQL型を見つめることになり、AIツールのスコープがShopifyのみに限定され、AIが実際に何を要求したかの監査証跡が得られません。Query StreamsのShopify MCPサーバーは、より広範な問題を解決します。1つのキーですべてのコネクタが利用可能になり、完全な監査証跡が得られ、エージェントがShopify管理画面のデータをSQLサーフェスに正規化し、AIツールがShopifyの認証情報を保持することはありません。

ファイアウォールポートを開放せずに動作する方法

Query Streams Network Agent は、インターネットにアクセスできる任意のマシンに一度インストールされ (Shopify Admin API はどこからでもアクセス可能)、クラウドへの 1 つのアウトバウンド TLS リンクを確立します。Claude または Cursor が質問をすると、エージェントは Shopify Admin API を呼び出し、応答をローカルの DuckDB にキャッシュするため、AI はクリーンな SQL サーフェスを参照できます。 オーダー, 明細行, お客様, 製品, バリアント, 在庫レベル, 取引, 履行 — REST エンベロープの代わりに、受信データは一切公開されず、AI ツールは Shopify のプライベート アプリ トークン、ストア ドメイン、または API バージョンを一切認識しません。 発信専用接続の仕組み →

CursorまたはClaudeに与えるMCPキーはスコープ付きです（読む / 分析する / 実行する）、いつでも取り消し可能で、キーごとにレート制限が設けられています。AIツールは、以下のMCPツールを呼び出して処理を実行します。

スキーマインテリジェンスがQuery Streams MCPを他と差別化する理由

オープンソース環境におけるほとんどの「Shopify向けMCP」サーバーは、Shopifyが開発者向けに公開しているのと同じフィールドリファレンス、あるいはさらに悪いことに、生のデータをAIツールに渡します。 情報スキーマ キャッシュの内容。フィールド名。データ型。おそらく主キー。LLM は推測するしかない。 合計価格 STRING として保存され、キャストする必要があります ダブル 算術では、 財務状況 は列挙型です 保留中 / 承認済み / 部分的に支払い済み / 支払い済み / 一部返金 / 返金済み / 無効あるいは、 タグ これはカンマ区切りの文字列であり、リストに平坦化する必要があります。そのため、ほとんどのLLMがShopifyのスキーマに対して最初に書くSQLは間違っています。これはLLMが悪いからではなく、正しく動作するために必要なデータがないためです（「total_priceが文字列なのでSUMはnullです」といったエラーは、午後の時間を無駄にする原因となります）。

Query Streams MCP は、私たちが スキーマインテリジェンス（SI） — AI がキュレーションしたメタデータは、あなたの 実際 AIクライアントが要求する前にShopifyデータを取得します。ShopifyコネクタでSIが有効になっている場合、AIが呼び出すすべてのスキーマツール（qs_get_connector_schema, qs_get_table_schema, qs_profile_table, qs_get_relationships) は、キャッシュされたスキーマと、厳選された知識の 6 層を返します。LLM は推測を停止します。

これを具体的に示すために、AIクライアントが単一のデータから何を受け取るかを以下に示します。 qs_get_table_schema Shopifyコネクタに対する呼び出し オーダー テーブル — アナリティクスに関する質問の 80% を占める、Shopify の標準的なファクト テーブル — 最初はスキーマ インテリジェンスなし、次にスキーマ インテリジェンスありで比較します。

スキーマインテリジェンスが追加する6つのレイヤー

各レイヤーは、LLMが推測するであろう質問の種類に対応します。オプトイン方式のSIプロファイリング処理は、スキーマを変更したりストアに書き込んだりすることなく、Shopifyデータに対して実行され、新しいメタフィールド定義を追加すると段階的に更新されます。 スキーマインテリジェンスが追加する機能と、その最新性を維持する方法 →

同じプロンプトだが、SQLが異なる

その証拠は、AIツールが実際に書き出すSQLにある。同じカーソルセッション、同じクロードモデル、同じプロンプト―― 「過去12か月間の月ごとの売上高と平均注文額（AOV）を、支払い済みの注文のみを対象に、米ドルで教えてください。」 スキーマインテリジェンスがない場合、LLM は推測する必要があります。スキーマインテリジェンスがあれば、LLM は total_price がキャストが必要な STRING であること、financial_status 列挙値が '有料' ない 「完了」また、複数通貨対応の店舗には通貨フィルターが必要です。

Query Streams MCP と Shopify Storefront MCP の比較

Shopify は公式 MCP サーフェスを出荷しています。 ShopifyストアフロントMCPこれは、カタログ、商品、コレクション、顧客向けデータといったストアフロントAPIを公開することで、AIショッピングアシスタントが購入者の商品閲覧、おすすめ商品の提示、在庫状況の確認などを支援することを可能にします。購入者向けのAI体験に最適な設計となっています。 管理者データ、運用データ、財務データは表示されません。 Query Streams Shopify MCP はその逆で、Shopify の運用、分析、財務、およびカスタマー サポート部門向けの読み取り専用の管理 API サーフェスです。2 つの MCP サーバーは異なる問題解決を目的としており、その役割は以下のとおりです。

2つのMCPサーバーは問題なく共存しており、多くのShopify Plus加盟組織が両方を導入しています。 Shopify Storefront MCPを使用する 購入者向けのAIショッピング体験、つまり、買い物客がカタログを閲覧したり、商品のおすすめを取得したり、「この商品は私のサイズがありますか？」といった質問に答えたりするAIエージェント。 Shopify MCPのクエリストリームを使用する 運用、財務、サポート、分析といったチームと連携するAIツールは、注文、取引、履行、顧客生涯価値、在庫レベル、払い戻し、割引コード、ギフトカードなどのビジネスデータに加え、これらの情報も必要とします。対象ユーザーやスコープは異なりますが、どちらも読み取り専用であるため、競合するのではなく互いに補完し合います。

MCPが合わない場合は、Nova AIをお試しください。

JSON設定を完全にスキップする： Nova AIはQuery Streamsウェブポータルに組み込まれています。 そして、同じエージェント、読み取り専用の強制、スキーマインテリジェンスを使用して、追加したすべてのコネクタで、製品別の収益、フルフィルメントSLA、コホート維持率など、Shopify管理画面の同じ平易な英語の質問に答えます。MCPの配管作業は不要です。

Nova AIをご紹介します

前提条件

始める前に、以下のものを用意してください。

1. 無料のQuery Streamsアカウントは my.querystreams.com.
2. インターネットアクセス可能なマシンにインストールされたクエリ ストリーム ネットワーク エージェントについては、以下を参照してください。 クエリストリームエージェントをダウンロードしてくださいShopify Admin API はどこからでもアクセスできるため、エージェントは特定のネットワーク上に存在する必要はありません。
3. エージェントに対して構成された Shopify ストア コネクタ - 既存の APIコネクタのセットアップ プライベートアプリのペアリングに関するガイドです。エージェントはShopifyプライベートアプリトークンとストアドメインを保持しますが、AIツールはどちらにも一切アクセスしません。クエリ対象のストアごとにコネクタが分かれるため、複数ストアアカウントの場合はコネクタを1つずつ追加していくことになります。
4. MCP対応のAIクライアントであればどれでも使用できます。このガイドでは、Cursor、Claude Desktop、ChatGPT、Grokを例に説明しますが、Windsurf、Zed、Continue、Cline、VS Code Copilot、Codex、Gooseを使用する場合でも、設定ブロックは基本的に同じです。
5. 5分。

ステップ1：クエリストリームでMCPキーを生成する

クエリ ストリームにサインインして、 MCPページ （または最初にサインインしてください） my.querystreams.com そしてクリック MCP 左側のナビゲーションでクリックします。 キーを生成するキーに分かりやすい名前を付けます（例： カーソルラップトップ または クロード・デスクトップ)、そしてこのキーに適用したいスコープを選択します。

• 読む — AIはコネクタを閲覧し、スキーマを読み取ることができる。他のすべての機能には必須である。
• 分析する AIはテーブルのプロファイリングを行い、関係性（サンプル値、分布、意味タイプ）を検出できます。オプションですが、注文データの構造や金額列の意味（文字列で格納された価格、複数通貨、列挙型ステータスなど）を理解することが重要となるeコマース業務では強く推奨されます。
• 実行する — AIは実際にSQLを実行できる。これがなければ、AIはスキーマメタデータに対してのみ読み取り専用となる。

典型的な「クロードに私のShopify管理画面のデータを分析してもらう」ワークフローでは、3つのスコープすべてが適切です。チームメイトや信頼度の低いクライアントに渡すキーの場合は、 実行する そして閲覧のみを許可します。同じページからいつでも任意のキーを取り消すことができます。AIクライアントはそれを認識します。 MCP_KEY_REVOKED 次の呼び出し時に動作を停止し、すぐに通信を終了します。伝播遅延はありません。

キーを今すぐコピーしてください。Query Streams はキーを一度表示した後、ハッシュのみを保存します。キーを紛失した場合は、新しいキーを生成してください。キーは次のようになります。 qsmcp_ 続いて48個のランダムな文字があり、これはAIクライアントが送信するものです。 X-MCPキー リクエストヘッダー。

ステップ2：AIクライアントにQuery Streams MCPを追加する

構成は、MCP 対応クライアントすべてで同じ形状です。MCP サーバーのエントリは、 https://mcp.querystreams.com キーを X-MCPキー ヘッダー。下記からクライアントを選択してください。

カーソル ~/.cursor/mcp.json

// ~/.cursor/mcp.json を編集する
{
  「mcpServers」: {
    「クエリストリーム」: {
      「url」: 「https://mcp.querystreams.com」,
      「ヘッダー」: {
        「X-MCPキー」: "qsmcp_PASTE_KEY_HERE"
      }
    }
  }
}

クロード・デスクトップ claude_desktop_config.json

// 設定 → 開発者向け → 設定の編集
{
  「mcpServers」: {
    「クエリストリーム」: {
      「url」: 「https://mcp.querystreams.com」,
      「ヘッダー」: {
        「X-MCPキー」: "qsmcp_PASTE_KEY_HERE"
      }
    }
  }
}

チャットGPT アプリとコネクタ

// 設定 → アプリとコネクタ → MCP を追加
サーバーURL  https://mcp.querystreams.com
認証ヘッダー X-MCPキー
ヘッダー値 qsmcp_ここにキーを貼り付けてください

// ChatGPTの有料プランが必要です
// (プラス / プロ / チーム / エンタープライズ)

グロック リモート MCP ツール

// Grok → 設定 → ツール
{
  「mcp_servers」: [{
    "名前": 「クエリストリーム」,
    「url」: 「https://mcp.querystreams.com」,
    「auth_header」: 「X-MCPキー」,
    「認証値」: 「qsmcp_...」
  }]
}

AIクライアントを再起動してください。次回起動時に、上記にリストされている8つのクエリストリームMCPツールが検出され、ツールパレットに表示されます。CursorおよびClaude Desktopでは、次のように入力して確認できます。 「リストコネクタ」 — AIは電話すべき qs_list_connectors そして、設定したShopifyストア（複数ペアリングしている場合は、各ストアが個別のコネクタとして表示されます）と、その他設定済みのすべての情報を返します。

ステップ3：AIにShopifyに関する質問をする

SQL文を書く必要はありません。AIが書きます。質問をすると、AIが適切なMCPツールを選択し、エージェントがキャッシュされたShopify管理画面のデータに対してクエリを実行し、テキストと表形式で回答が返されます。まず試していただきたい3つの例文を以下に示します。

AIが初めてツールを呼び出す際、クライアントにツール呼び出しの承認を求める確認プロンプトが表示される場合があります。これはMCPの標準的な同意フローであり、Query Streamsが追加するものではありません。一度承認すれば、AIはその後の会話を自由に進めます。同意内容は、クライアントの設定でいつでも変更できます。

よくある質問

さあ始めましょう

関連ガイド： クエリストリームエージェントをダウンロードしてください | APIコネクタのセットアップ | すべてのMCPサーバーガイド | Nova AI テキストからSQLへの変換

カテゴリ: MCPサーバー

タグ: mcp、claude、カーソル、shopify、api-connector、eコマース、shopify-admin、shopify-storefront-mcp、マルチストア、読み取り専用mcp

メタディスクリプション：MCP経由でClaudeまたはCursorを使用してShopify管理画面のデータを照会できます。キャッシュされたSQLインターフェース、複数店舗対応、ファイアウォールの脆弱性なし。無料。