Harubase

サポート

トラブルシューティング

接続・データ取得で問題が起きた時の確認ポイントをまとめました。該当しない場合は FAQ もあわせてご確認ください。

接続できない（ツール一覧に出ない）

症状: Claude Desktop / Cursor / Claude Code で harubase ツールが表示されない

考えられる原因

  • 設定 JSON の構文エラー（カンマ・括弧の対応漏れ）
  • クライアントを再起動していない
  • クライアントのバージョンが MCP 非対応の古さ
  • Bearer トークンに余分な空白・改行が混入している

対処法

  • JSON を整形ツールで検証する
  • クライアントを完全終了 → 再起動
  • Cursor は v0.45 以上、Claude Desktop は最新版にアップデート
  • MCP 接続画面からトークンを再発行して、コピーし直す

401 Unauthorized エラー

症状: ツールは見えるが呼び出すと 401 を返す

考えられる原因

  • トークンが古い（再発行や強制ローテーション後）
  • プラン上限に達してアクセスが制限されている
  • Authorization ヘッダの書式間違い

対処法

  • MCP 接続画面から最新トークンを取得し、設定ファイル / Cursor 設定を更新
  • 請求 / プラン画面で利用状況を確認、必要ならアップグレード
  • "Authorization": "Bearer <token>" の形式と「Bearer 」（半角空白あり）の有無を確認

データが返らない / 空配列が返る

症状: ツール呼び出しは成功するが結果が空

考えられる原因

  • 指定した期間に配信実績がない
  • 対象アカウントが OAuth 連携の途中状態（setup: プレフィックス）
  • Yahoo の場合、アカウントが Deactivated（停止）状態
  • アカウントを連携していない、または別のクライアントに紐づいている

対処法

  • 別の期間を試す（last_30d など）
  • 設定 → 広告アカウント連携 で接続状態を確認、setup 状態なら再認証を完了させる
  • Yahoo の管理画面でアカウントの状態を確認
  • 正しいクライアントでログインしているか確認

応答が極端に遅い・タイムアウト

症状: 30 秒以上待っても返ってこない、エラーになる

考えられる原因

  • Yahoo レポートは API 仕様上 60〜90 秒かかることがある
  • 対象期間が長すぎる（半年など）
  • 複数アカウント × 大量データを一度に取ろうとしている

対処法

  • もう一度同じ質問を投げる（同セッションなら 5 分以内はキャッシュで瞬時に返ります）
  • 期間を 30 日以内に絞る
  • 1 アカウントずつ取得するように指示する

Yahoo クリエイティブが取得できない

症状: yahoo_get_all_creatives で 0 件と返る

考えられる原因

  • アカウントに広告（Ad）が登録されていない、または配信されていない
  • Yahoo 側で Deactivated（停止）になっている
  • ディスプレイ広告（display:）アカウントを連携していない

対処法

  • yahoo_list_accounts で連携アカウントを確認
  • Yahoo の管理画面で広告（Ad）が登録されているか確認
  • 再認証を行う、または別のアカウント ID で連携し直す

OAuth 連携が完了しない

症状: 広告アカウント一覧に "Yahoo! Ads（設定中）" のままのアカウントがある

考えられる原因

  • Yahoo の場合、MCC アカウント ID の入力ステップで離脱した
  • OAuth コールバック中にエラーが発生した

対処法

  • 設定 → 広告アカウント連携 から該当アカウントを削除し、最初から連携をやり直す
  • MCC アカウント ID は Yahoo 広告管理画面の右上「アカウント情報」から確認可能

それでも解決しない場合

サポートにご連絡ください。エラーメッセージと、お試しいただいた手順を添えていただけるとスムーズです。