注: この記事は英語から AI を使用して翻訳されており、若干の不正確な表現が含まれる場合があります。

この記事では、Optmyzr MCP 連携に関するよくある質問とトラブルシューティングの手順を説明します。設定方法については、Optmyzr Sidekick MCP - ユーザーガイドをご覧ください。

よくある質問

Claude を MCP 経由で Optmyzr に接続した場合、トークンの使用量はどのように計算されますか？

MCP は、処理の負荷を Claude から Optmyzr のインフラストラクチャに移します。そのため、使用量は Claude のトークン消費ではなく、Optmyzr のトークン消費として表示されます。

LLM のコストは、次の 2 種類のトークンに分けられます。

入力トークン：モデルに渡されるすべての情報（プロンプト、添付データ、エージェントの場合は呼び出しごとに送信されるシステム指示）。
出力トークン：モデルが生成するすべての情報（内部の推論や実行ステップ、および最終的な回答）。

MCP を使用しない場合、LLM で PPC データを分析すると入力トークンが直接増え、コンテキストウィンドウが埋まります。また、多くの場合 LLM は処理前にデータを分割する必要があり、この分割処理も出力トークンとしてカウントされます。

MCP を使用すると、Claude が生データに直接触れることはありません。Claude は Optmyzr MCP サーバーを呼び出し、サーバーがクエリを実行して、整理・フィルタリングされた結果を返します。そのため、データセットがプロンプトに入ることはなく、入力トークンは低く抑えられます。さらに、Optmyzr のルールエンジンは大規模なデータセットを AI ではなくロジックで処理するため、Claude がその作業で出力トークンを消費することもありません。

複数の Optmyzr アカウントを Claude に接続できますか？

はい。ただし、Claude では同じ MCP サーバー URL を 2 つの異なるコネクタに登録することはできません。2 つ目の Optmyzr アカウントを接続するには、少しだけ異なる URL を使用してください。

標準の URL の末尾に identifier パラメータを追加します。

https://tools.optmyzr.com/OptmyzrMcp?identifier=YourLabel

identifier の値は任意です。2 つの URL を区別するためだけに使用されます。

注：1 つのチャットで有効にする Optmyzr コネクタは 1 つだけにしてください。2 つが同時に有効になっていると、Claude はどのアカウントを指しているのか判断できず、両方のアカウントに対してリクエストを実行する可能性があります。

同じチャットで 2 つのコネクタを使用する場合は、プロンプトで使用するコネクタを指定してください。例：「Optmyzr MCP (ClientOne) コネクタを使用して、先週の費用を表示してください。」

Optmyzr MCP が承認なしにアカウントを変更することはありますか？

いいえ。AI クライアントにアカウントの変更を依頼すると、Optmyzr MCP は変更をすぐに適用するのではなく、Change Request を作成します。変更が反映される前に、何が変更されるのかを正確に確認でき、そのまま適用するか、チームメンバーにレビューを依頼するかを選択できます。すべての Change Request は、Optmyzr の「Change Reviews」に記録されます。

詳しくは、Change Requests - ユーザーガイドをご覧ください。

Claude で作成したレポートを Optmyzr に戻すことはできますか？

いいえ。レポートに関しては、データは Optmyzr から AI クライアントへの一方向にのみ流れます。

MCP を通じて、Claude や ChatGPT は接続されたアカウントのデータ、パフォーマンス指標、競合インサイト、最適化の提案を取得し、その会話の中で自由に分析、セグメント化、表示できます。ただし、その結果をレポートとして Optmyzr に書き戻すことはできません。Optmyzr のレポートは Optmyzr 内の Report Builder で作成するもので、MCP がレポートを作成・変更することはありません。

これはレポートに限った制限であり、MCP 全体に当てはまるものではありません。MCP ではアラートの作成・編集や、キーワード変更をレビュー用に準備することができます（利用可能な MCP 機能を参照）。

トラブルシューティング

Claude で Optmyzr MCP コネクタが有効になっているのに、ツールが表示されない、または結果が返されません。どうすればよいですか？

これは、Claude 上の MCP コネクタ名が長い、または複雑な場合に発生することがあります。Claude は MCP サーバーに接続すると、利用可能なツールを一覧表示するための最初のリクエストを送信します。しかし、コネクタ名が長い、または複雑だと、接続が有効に見えていても、その後のツールの読み込みがエラー表示なしに失敗することがあります。

解決方法：

Claude の設定を開き、MCP コネクタに移動します。

Optmyzr コネクタの名前を「Optmyzr MCP」など、短くシンプルな名前に変更します。

再接続を求められた場合は、コネクタを再接続します。

名前を変更すると、ツールが読み込まれ、正常に動作するようになります。

注：この問題は、同じ Claude アカウントで 2 つの MCP コネクタキーを設定している場合に最も発生しやすくなります。すべてのコネクタ名を短くしておくことで、この問題が起こる可能性を減らせます。

ChatGPT で Optmyzr MCP に接続し、アカウント一覧は表示されますが、実際のデータを取得できません。Google 広告の OAuth の有効期限が切れている可能性があると表示されます。どういうことですか？

これはほとんどの場合、設定時には接続できたように見えても、ChatGPT との OAuth 認証が実際には完了していないことを意味します。Optmyzr 側で Google 広告の OAuth の有効期限が切れているわけではありません。

確認と解決の手順：

Optmyzr アカウントの Authorized Applications に移動します。ChatGPT の OAuth フローが正常に完了していれば、この一覧に「ChatGPT」が表示されます。表示されていない場合は OAuth フローが完了していないため、ChatGPT 側で接続をやり直してください。
ChatGPT で OAuth を完了したら、クエリを実行する前に、ChatGPT のプラグイン／コネクタ一覧に「Optmyzr」が表示されていることを確認します。まだ表示されない場合はページを更新してください。OAuth 接続が完全に完了すると表示されます。
クエリを実行する際は、「Optmyzr」プラグイン／MCP を明示的に選択し、リクエストが確実にそこを経由するようにします。

期間を指定して品質スコアをリクエストしましたが、品質スコアの列が空欄です。

過去の品質スコアは、Google からリアルタイムで取得するのではなく、Optmyzr が記録しているスナップショットから取得されます。指定した期間が Optmyzr の記録期間外の場合、品質スコアの列は空欄になり、回答には利用可能な期間が示されます。その期間内の日付範囲で再度お試しください。キーワード単位の要素（推定クリック率、広告の関連性、ランディングページの利便性）は Google からリアルタイムで取得されるため、常に利用できます。

ChatGPT を Optmyzr MCP に接続していますが、リクエストが失敗し続けます。どうすればよいですか？

MCP 接続で関数の呼び出しに失敗し、「Unknown tool」や「cached tool list is stale」などのエラーが返される場合、ChatGPT が最初に接続したときに保存した Optmyzr ツールの一覧をまだ使用している可能性があります。

Optmyzr MCP は定期的に更新されますが、利用可能なツールが変更されても、AI クライアントに自動で通知されるわけではありません。そのため、古いツールを使用しようとし続けることがあります。