トラブルシューティングの前に
まず以下の基本事項を確認してください：
Octoparse MCPサーバーのURLが正しいこと
ご使用のAIクライアントが使用しようとしているMCPフローに対応していること
アカウントまたはワークスペースのプランがコネクター／アプリ／MCPサーバーを許可していること
認証が正常に完了していること
コネクターまたはサーバーが現在の環境で有効になっていること
要求したOctoparseの操作がご利用のプランおよびタスクの種類でサポートされていること
「MCPが動作しない」というケースの多くは、サーバー側の障害ではありません。
原因は主に、クライアントの設定、ワークスペースの権限、OAuth／認証、または現在の会話／セッションでのツールの表示の4つのいずれかです。
このパターンは、Anthropic、OpenAI、Microsoft、Gemini CLIがそれぞれのMCPまたはコネクターフローに関するドキュメントで示している内容と一致しています。
1. MCPまたはコネクターの設定が見つからない
これは通常、その機能がプラン、ワークスペース、または製品の操作環境によって制御されていることを意味します。
Claudeの場合、リモートMCPを使用したカスタムコネクターはコネクターフローから利用できます。AnthropicはClaudeおよびClaude Desktopのコネクター操作環境としてドキュメント化しています。（support.anthropic.com）
ChatGPTの場合、MCPを活用したアプリは開発者モードとワークスペースの管理設定に紐付けられています。OpenAIはワークスペース管理設定のもと、MCPを活用したアプリのビルドおよびテスト用に開発者モードをドキュメント化しています。（help.openai.com）
VS Codeの場合、MCPサポートは一般的なコネクターマーケットプレイスではなく、GitHub Copilot MCPサーバー設定で管理されます。（code.visualstudio.com）
対処方法
対応プランをご利用であることを確認する
管理者またはオーナーが先に機能を有効化する必要があるか確認する
そのクライアントの正しい製品エリアを確認する
2. コネクターまたはMCPサーバーが保存できない
セットアップが失敗する場合、原因は通常以下のいずれかです：
URLまたは設定フォーマットが間違っている
サポートされていない認証フロー
ワークスペースのポリシーによってセットアップがブロックされている
初期化中にプラットフォーム側でタイムアウトが発生している
Claudeの場合、リモートサーバーは設定 ＞ コネクターから追加します。Anthropicは、リモートサーバーのセットアップは以前のローカル設定パターンではなく、コネクターフローに従う必要があるとしています。(support.anthropic.com)
VS Codeの場合、MCP設定はワークスペースまたはユーザープロファイルのmcp.jsonに保存されます。設定の形式が正しくない場合や配置場所が誤っている場合は、読み込まれないことがあります。(code.visualstudio.com)
Gemini CLIの場合、MCPサーバーはmcpServersの下で定義されるため、JSONの記述が誤っているか設定のスコープが間違っていると読み込みに失敗することがあります。(github.com)
対処方法
サーバーURLまたは設定の構文を再確認する
コネクターまたはサーバーを最初から再追加する
クライアントの現在のセットアップフローに従っているか確認する
設定変更後にクライアントまたはセッションを再起動する
3. OAuthまたはサインインが失敗する
サインインしても連携が機能しない場合、最も一般的な原因は以下のとおりです：
誤ったアカウントが認証された
OAuthフローが正常に完了しなかった
クライアントが付与された接続情報を正しく保存しなかった
MCPサーバーが設定されていない認証設定を必要としている
AnthropicはリモートMCPカスタムコネクター向けのOAuthサポートをドキュメント化しており、MCP自体の認証ガイダンスでも、HTTPベースの制限付きサーバーにはOAuthを推奨しています。(support.anthropic.com)
対処方法
連携を切断して再接続する
同じブラウザセッションで認証フローを再実行する
正しいOctoparseアカウントを承認したか確認する
競合するセッションからサインアウト後に再試行する
OAuthについて
OAuthを使用することで、AIクライアントはOctoparseのパスワードを直接必要としません。アクセスは認証トークンと承認済み権限を通じて付与されます。(support.anthropic.com)
4. コネクターは追加されているが、ツールが表示されない
これは最もよくある問題の一つです。 通常、連携自体は存在しているものの、現在のチャット、セッション、またはツール対応の操作環境で有効になっていない状態です。
Claudeの場合、コネクターはアカウントに存在していても、現在の会話ではまだ有効になっていない場合があります。AnthropicはコネクターをClaudeのUIから追加した後に有効化する手順をドキュメント化しています。(support.anthropic.com)
VS Codeの場合、MCPサーバーは読み込まれていても、想定した場所に表示されないことがあります。MicrosoftのMCPドキュメントでは、エージェントモードやその他のツール対応の操作環境を含むCopilotワークフローでの使用について説明しています。(code.visualstudio.com)
Gemini CLIの場合、セッションがまだ設定変更を反映していないことが原因であることが多いです。(github.com)
対処方法
現在の会話でコネクターが有効になっているか確認する
エージェントモードやツール対応のチャット操作環境など、正しいモードを使用しているか確認する
設定変更後にクライアントまたはCLIセッションを再起動する
認証後にツール一覧が空の場合は再認証する
5. 自分では動作するが、チームメンバーでは動作しない
これは通常、Octoparseの問題ではなく、ワークスペースの権限の問題です。
Claude Team／Enterpriseの場合、Anthropicによるとオーナーが先にコネクターを追加する必要があり、その後各ユーザーが個別に接続・認証を行う必要があります。(support.anthropic.com)
ChatGPTの場合、管理者設定によって開発者モードとアプリの権限を制御できます。同じワークスペース内でも、あるユーザーはMCPを活用したアプリをテストできる一方、別のユーザーはできない場合があります。(help.openai.com)
VS Codeの場合、組織レベルの設定によって使用可能なMCPサーバーが制限されることもあります。(code.visualstudio.com)
対処方法
オーナーまたは管理者が先に連携を承認する必要があるか確認する
必要に応じて各ユーザーが自身の認証フローを完了しているか確認する
組織レベルのMCPまたはツールアクセスポリシーを確認する
6. Octoparseは接続されているが、アクションが失敗する
ツールは表示されているものの特定のアクションが失敗する場合、問題はMCP自体にないことが多いです。
よくある原因：
テンプレートが要求されたアクションに対応していない
タスクがローカル専用である
エクスポート形式が利用できない
アクションにご利用のプランにない機能またはクレジットが必要
リクエストが一度に多くの操作をしようとしている
対処方法
まずテンプレートの一覧表示やアカウント情報の確認など、小さなアクションからテストする
次にタスクの作成を試す
次にタスクの開始または停止を試す
最後にエクスポートを試す
これにより、問題の原因が認証、権限、プランの制限、またはタイムアウトのいずれにあるかを特定しやすくなります。
7. 7. リクエストに時間がかかりすぎて失敗する
これは通常、タイムアウトの問題です。
「テンプレートを検索して、タスクを作成し、実行して、待ってからCSVをエクスポートして」のような長いプロンプトは、短いステップごとのプロンプトに比べて失敗しやすい傾向があります。
より良いアプローチ
以下のような順番で操作してください：
テンプレートを検索する
タスクを作成する
タスクを開始する
ステータスを確認する
データをエクスポートする
これにより、ほぼすべてのクライアントでより安定した動作が期待できます。
8. デスクトップでは動作するが、モバイルでは動作しない
これは多くの場合、想定された動作です。
Anthropicによると、リモートMCPサーバーはClaudeおよびClaude Desktopでサポートされており、claude.aiを通じてすでにリモートサーバーが追加済みであれば、iOSおよびAndroidでも利用可能です。ただし、モバイルでの使用方法は初期セットアップと異なる場合があります。(support.anthropic.com)
対処方法
まずウェブまたはデスクトップでコネクターを追加・設定する
その後モバイルでテストする
すべてのモバイル環境が完全なMCPセットアップフローに対応しているとは限らないことに注意する
9. ローカルMCPとリモートMCPを混同している
これは多くの混乱を引き起こす原因です。
Claudeの場合、AnthropicはClaude Desktopのローカル MCPサーバーをリモートMCPコネクターとは別のワークフローとしてドキュメント化しています。両者の設定方法は異なります。(support.anthropic.com)
Gemini CLIおよびVS Codeの場合、サーバーのホスティング方法と定義方法によって、ローカルとリモートの両方のパターンが存在する場合があります。 (code.visualstudio.com)
対処方法
OctoparseがホストされたリモートMCPサーバーとして接続されているか確認する
意図的にローカルサーバーを自分で実行している場合を除き、ローカルサーバーのインストール手順に従わないようにする
10. セキュリティについて不安がある
その懸念は正当なものです。
MCPはAIクライアントにツール、リソース、プロンプト、アクションを提供できます。VS CodeはMCPサーバーがツール、リソース、プロンプト、インタラクティブなアプリを提供できることを明示しています。(code.visualstudio.com)
対処方法
信頼できるサーバーのみに接続する
要求された権限を十分に確認する
必要最小限のアクセス権を使用する
不要になったら接続を切断してアクセス権を取り消す
セキュリティに関する注意
Octoparseやその他のMCPサーバーは、信頼できる管理下にあるAIクライアントにのみ接続してください。リモートMCPサーバーは、付与された権限によっては強力なアクションを実行できる場合があります。
クライアント別トラブルシューティングのメモ
ChatGPT
ChatGPTのMCPフローは他のクライアントに比べてワークスペースと管理者の設定に敏感です。サーバーは正常でもアプリが表示されない・使用できない場合は以下を確認してください：
必要な場所で開発者モードが有効になっているか
アプリがワークスペースで利用可能か
ユーザーがアプリにアクセスできる権限を持っているか
現在のチャットコンテキストでアプリが有効になっているか
Claude
Claudeの仕組みはよりシンプルですが、Claude DesktopのローカルMCPセットアップとリモートカスタムコネクターを混同するユーザーが多いです。以下を確認してください：
コネクターが「コネクター」セクションで追加されているか
現在の会話で有効になっているか
オーナーが先に追加する必要があったか
正しいリモートセットアップの手順に従っているか
VS Code
VS Codeの問題のほとんどは、設定ファイルの場所、ワークスペースの信頼設定、組織のポリシー、または誤ったCopilotの操作環境の使用に起因します。以下を確認してください：
サーバーが正しい
mcp.jsonから読み込まれているかワークスペースの信頼設定が動作をブロックしていないか
組織のポリシーがMCPの使用を制限していないか
エージェントモードなど、ツール対応のCopilotの操作環境を使用しているか
Cursor
CursorはMCPをサポートしていますが、バージョンや機能に固有の問題が発生することがあります。以下を確認してください：
サーバーは接続されているがチャットに表示されていないか
アップデート後に問題が発生したか
Cursorを再起動してMCP設定を再読み込みすると解決するか
Gemini CLI
Gemini CLIは最も設定依存度が高いクライアントです。以下を確認してください：
mcpServersのJSONが有効か正しい設定スコープを編集したか
認証が正常に完了したか
変更後にCLIを再起動したか
トラブルシューティングチェックリスト
Octoparse MCPが動作しない場合は、以下の順番で確認してください：
URLまたは設定が正しいか
対応プランまたはワークスペースへのアクセス権があるか
OAuthまたは認証が正常に完了しているか
現在のチャットまたはセッションでコネクターまたはサーバーが有効になっているか
正しいクライアントモードまたはツール対応の操作環境を使用しているか
組織または管理者の権限によって使用がブロックされていないか
要求したOctoparseのアクションがご利用のプランでサポートされているか
プロンプトが長時間かかるステップを多数組み合わせていないか
より安定した使用のためのベストプラクティス
以下のような短く単一目的のプロンプトを使用してください：
Amazonの商品一覧向けのOctoparseテンプレートを検索して
このテンプレートからタスクを作成して
クラウドでタスクを開始して
最新のタスクステータスを確認して
最新の結果をCSV形式でエクスポートして
これによりタイムアウトのリスクが軽減され、トラブルシューティングも容易になります。
よくあるご質問
OctoparseのMCPがClaudeでは動作するのにChatGPTでは動作しないのはなぜですか？
両製品のセットアップと権限モデルが異なるためです。ChatGPTはワークスペースの管理者設定と開発者モードへの依存度が高い一方、Claudeはコネクターベースのフローを使用しています。(help.openai.com)
VS Codeではツールが表示されるのに、ウェブチャットクライアントでは表示されないのはなぜですか？
VS CodeはMCPをエージェントモードなどのツール対応の操作環境を含むCopilotワークフローにより直接紐付けています。コネクターが正しく設定されていても、他のクライアントでは期待した場所に表示されないことがあります。(code.visualstudio.com)
各プラットフォームでOctoparseを個別に認証する必要がありますか？
通常は必要です。同じOctoparseアカウントを使用する場合でも、各クライアントで独自のコネクターセットアップとOAuth認証セッションが必要になる場合があります。
OAuthを使用すると、AIクライアントがOctoparseのパスワードを見ることができますか？
いいえ。OAuthはクライアントがパスワードを直接扱うことなく、承認されたアクセス権を受け取る仕組みです。(support.anthropic.com)
長いプロンプトが失敗しやすいのはなぜですか？
複数ステップのリクエストはタイムアウトやツール実行の制限に達しやすいためです。ワークフローをより小さなアクションに分割することで、通常はより安定した動作が期待できます。