トラブルシューティング

接続の確認

具体的な問題をトラブルシューティングする前に、Pressoが正しく接続され、データソースにアクセスできる状態かを確認しましょう。

簡易接続テスト

データソースからの応答が必要なシンプルな質問を投げてみます。

Shopifyの商品を3件だけ表示して

商品データが返ってくれば、Shopifyの接続は正常です。使用している各データソースについて、同様のシンプルなクエリで確認しましょう。

昨日のGA4のセッション数を見せて

Google Adsのキャンペーンを3件だけ表示して

昨日のMeta Adsアカウントのサマリーを見せて

MCPサーバーの状態を確認

PressoはClaude Code内でMCPサーバーとして動作しています。何も反応しない場合は、MCPサーバーが設定済みで稼働しているかを確認してください。

1. Claude CodeのMCP設定ファイル（通常は~/.claude/またはプロジェクトの.mcp.json）を開きます
2. Presso MCPサーバーのエントリが存在し、正しく設定されていることを確認します
3. Claude Codeを再起動してMCP接続を再初期化します

Pressoが応答しない

症状: 質問してもClaude CodeがPressoのツールを使わない、または実データではなく一般的な知識で回答される。

考えられる原因と対策

MCPサーバーが起動していない。 Claude CodeにPresso MCPサーバーが設定され、有効になっている必要があります。MCP設定を確認し、必要に応じてClaude Codeを再起動してください。

質問が一般的すぎる。 ECデータに関する質問であることが明確でないと、Claude Codeはデータを取得せず一般知識で回答することがあります。データソースを明示しましょう。

Shopifyのデータを使って、昨日の売上を見せて

ネットワーク接続の問題。 Pressoがデータソースにアクセスするにはインターネット接続が必要です。ネットワークを確認して再試行してください。

MCP接続がタイムアウトした。 長時間アイドル状態が続くと、接続の再確立が必要になる場合があります。Claude Codeを再起動するか、新しいセッションを開始してください。

データが返ってこない

症状: Pressoが接続してクエリを実行するが、空の結果が返ってくる、またはデータがないと表示される。

考えられる原因と対策

指定した期間にデータがない。 データソースの接続前やストアの開設前の期間を指定すると、データは存在しません。直近の期間を試してみてください。

過去7日間の注文を見せて

データソースが未接続。 まだ接続していないデータソースに対してクエリしている可能性があります。presso.nowでどのインテグレーションが有効かを確認してください。

権限が不足している。 OAuthトークンに、リクエストしたデータにアクセスするために必要なスコープがない場合があります。データソースを再接続して、必要な権限をすべて付与してください。

フィルターが厳しすぎる。 存在しない特定の商品、キャンペーン、顧客でフィルタリングすると、結果は返ってきません。クエリの条件を広げてみましょう。

こう聞くより: 「商品SKU-XYZ-999の注文を見せて」
こう聞こう: 「過去7日間の全注文を見せて」

そのデータソースにその指標がない。 すべてのデータソースがすべての指標を持っているわけではありません。たとえば、Search Consoleには売上データはなく、Shopifyにはインプレッションデータはありません。適切なデータソースに適切なデータを聞いているか確認しましょう。

認証エラー

症状: 認証関連のエラー、無効なトークン、期限切れの認証情報、認可の失敗に関するエラーが表示される。

考えられる原因と対策

OAuthトークンの有効期限切れ。 OAuthトークンには有効期限があります。期限が切れるとPressoはデータにアクセスできなくなります。該当するデータソースを再接続してください。

1. presso.nowのアカウント設定に移動します
2. 認証エラーが出ているデータソースを見つけます
3. 「切断」をクリックして接続を解除します
4. 「接続」をクリックしてOAuthフローを再度実行します

ソースプラットフォーム側で権限が変更された。 Shopify管理画面、Googleアカウント、Meta Business Managerで権限が変更されると、既存のPressoトークンが無効になることがあります。データソースを再接続して、現在の権限で新しいトークンを生成してください。

複数アカウントまたは誤ったアカウントの接続。 Shopifyストア、Googleアカウント、Metaビジネスアカウントを複数お持ちの場合、誤ったアカウントを接続してしまっている可能性があります。一度切断してから再接続し、OAuthフローで正しいアカウントを選択してください。

データソースプラットフォーム自体の障害。 まれに、ソースプラットフォーム（Shopify、Google、Meta）自体がAPI障害を起こしていることがあります。各プラットフォームのステータスページを確認してください。

• Shopify Status
• Google Workspace Status
• Meta Platform Status

レスポンスが遅い

症状: クエリの結果が返ってくるまでに時間がかかる、またはタイムアウトする。

考えられる原因と対策

一度に大量のデータをリクエストしている。 12か月分の日次データや、大規模カタログの全商品リストを要求すると時間がかかります。リクエストを絞りましょう。

こう聞くより: 「過去1年間の日次売上を見せて」
こう聞こう: 「過去3か月間の週次売上を見せて」

こう聞くより: 「全商品を在庫付きで一覧にして」
こう聞こう: 「売上トップ20商品の在庫レベルを見せて」

複数プラットフォームへの同時クエリ。 クロスプラットフォームクエリは複数のAPI呼び出しを必要とします。速度を優先する場合は、プラットフォームごとに分けて聞きましょう。

まず: 「先月のGoogle AdsのROASを見せて」
次に: 「同じ期間のMeta AdsのROASを見せて」

ソースプラットフォームのAPIが遅い。 基盤となるプラットフォームのAPIが高負荷で遅くなっていることがあります。これはPressoの管理外です。数分後に再試行してください。

大規模なShopifyストア。 商品や注文が数万件あるストアでは、一覧取得の処理が遅くなることがあります。フィルターとリミットを使ってデータセットを絞りましょう。

「全注文を見せて」ではなく「直近3日間の注文を見せて」

データが正しくない・想定と異なる

症状: Pressoが返す数値が、プラットフォームのダッシュボードに表示されるものと一致しない。

考えられる原因と対策

タイムゾーンの違い。 Pressoのクエリが、プラットフォームのダッシュボードと異なるタイムゾーンを使用している場合があります。「昨日」の売上が合わない場合、「昨日」の定義が異なっている可能性があります。正確さが重要なときはタイムゾーンを明示するか、具体的な日付範囲を指定しましょう。

2025年2月15日の売上を見せて（UTC）

データの反映遅延とキャッシュ。 プラットフォームによって、データが完全に処理されるまでに時間がかかるものがあります。

Pressoのデータとダッシュボードの数値がわずかに異なる場合は、ダッシュボード側がより最近に更新されていないか確認してください。

アトリビューションモデルの違い。 Google Ads、Meta Ads、GA4はそれぞれ異なるアトリビューションモデルを使用しているため、同じ期間でも異なるコンバージョン数を報告することがあります。これは想定される動作です。比較する際は：

先月のコンバージョン数を、Google Ads、Meta Ads、GA4のそれぞれの
報告値で見せて。各プラットフォームが使っているアトリビューションモデルも
併記して。

プラットフォームごとの指標定義の違い。 Shopifyの「売上」（注文合計金額）とGA4の「売上」（設定によって税金や送料を除く場合がある）は異なることがあります。数値が完全に一致しない場合は、各指標が何を含んでいるかPressoに確認を求めましょう。

Shopifyの売上とGA4の売上、それぞれに含まれるものは何？

返品とキャンセル。 Shopifyの売上には、その後返品された注文も含まれている場合があります。クエリのタイミングによっては、最近の返品が反映されていないことがあります。

先月のShopifyの純売上（返品差引後）を見せて

データソースの再接続方法

データソースが正常に動作しない場合は、以下の手順で再接続してください。

1. presso.nowにアクセスしてサインインします
2. アカウント設定またはインテグレーションページに移動します
3. 再接続したいデータソースを見つけます
4. 「切断」をクリックして現在の接続を解除します
5. 「接続」をクリックして新しいOAuthフローを開始します
6. 正しいアカウントを選択し、必要な権限を付与します
7. Claude Codeに戻り、シンプルなクエリで接続をテストします

再接続後、以前の会話コンテキストには新しい接続が反映されません。最良の結果を得るために、Claude Codeで新しいセッションを開始してください。

既知の制限事項

Pressoにできることと、できないことを理解しておくと、適切な期待値を設定できます。

データアクセス

• 読み取り専用。 Pressoはデータの取得と分析はできますが、データの変更はできません。注文の作成、在庫の更新、広告入札の変更、商品の編集はPresso経由ではできません。
• リアルタイムストリーミングなし。 Pressoは質問時にオンデマンドでデータを取得します。ライブダッシュボードやプッシュ通知は提供しません。
• APIレート制限あり。 各データソースにはAPIのレート制限があります。短時間に非常に多くのクエリを実行すると、一部がスロットリングされる場合があります。

クエリの範囲

• 過去データはプラットフォームに依存。 Shopifyはストアが存在する限り注文履歴を保持します。GA4のデータはプロパティの保持期間設定に依存します（デフォルトは14か月）。広告プラットフォームはそれぞれ異なります。
• 生のデータベースアクセスなし。 Pressoは各プラットフォームの公式APIを通じてデータを取得します。プラットフォーム固有のレポートでは利用できても、APIでは取得できない指標やディメンションがある場合があります。
• 複雑なカスタム計算。 Pressoは比較や基本的な計算は行えますが、高度な統計分析やカスタムアトリビューションモデルの構築には、専用の分析ツールが必要になる場合があります。

クロスプラットフォーム

• データの自動照合なし。 Shopifyの売上とGA4の売上は、アトリビューション、タイミング、定義の違いにより異なることがあります。Pressoは各プラットフォームが報告するデータをそのまま表示します。
• 統一された顧客IDなし。 Shopifyの顧客とGA4のユーザーは自動的には紐付けられません。プラットフォームを横断した顧客分析には固有の制限があります。

サポートを受ける

上記のトラブルシューティング手順を試しても問題が解決しない場合：

1. presso.nowのステータスページで既知のサービス障害がないか確認します
2. Claude Codeで新しいセッションを開始して、古くなったMCP接続をクリアします
3. 上記の手順に従って該当するデータソースを再接続します
4. **お問い合わせフォーム**からサポートにご連絡ください。以下の情報をお伝えください：
   • 問題の内容
   • 入力した質問
   • 表示されたエラーメッセージ
   • 影響を受けているデータソース
   • 問題が発生し始めた時期