トラブルシューティング
Nodaro MCP でよくある問題の解決方法です。サーバー URL の誤り、ログインの失敗、表示されないツールから、ジョブやアップロードの失敗、client_not_allowed などのエラーコードまで扱います。
このページでは、Nodaro MCP サーバーでよくある問題と、その解決方法を紹介します。接続とログインのエラー、表示されないツール、失敗したジョブや止まっているように見えるジョブ、アップロード、ツールが返すエラーコードを扱います。いま起きている症状に合うセクションから確認してください。
接続とログイン
コネクタを追加すると、クライアントに OAuth エラーが表示される
- URL が
https://mcp.nodaro.ai/mcpと完全に一致し、末尾にスラッシュがないことを確認します。 - お使いのネットワークで、
mcp.nodaro.aiの名前解決ができることを確認します。 - ディスカバリードキュメントを確認します。次のコマンドは、ステータス
200で JSON を返すはずです。
curl https://mcp.nodaro.ai/.well-known/oauth-protected-resource同じホストは /.well-known/oauth-authorization-server も提供しています。こちらも、ステータス 200 で JSON を返すはずです。
ログインが完了しない、または URL が間違っている
サーバーが応答するのは https://mcp.nodaro.ai/mcp だけです。よくある次の 2 つの間違いでは、ログインが Nodaro に届く前に失敗します。
https://api.nodaro.ai/mcp:このドメインは存在しないため、名前解決の段階で接続が失敗します。https://app.nodaro.ai/mcp:MCP について説明する Web ページで、サーバーではありません。ここにPOSTすると、エラーコードwrong_mcp_hostとともに405が返ります。このエラーには、正しい URL が示されています。
Claude では、コネクタの URL を編集できません。問題のあるコネクタを削除し、https://mcp.nodaro.ai/mcp で追加し直してください。
同意画面に、クライアント名についてのオレンジ色の警告が表示される
これは想定どおりの動作です。自身を登録するクライアントは、「Claude」のような名前を自分で決めており、Nodaro はその名前を検証しません。この警告は、許可をクリックする前に、アクセスを求めているアプリが、いま設定しているアプリと同じものかを確認するよう促しています。
登録が「Client not allowed」(クライアントが許可されていません)で失敗する
クライアントが、受け付け対象のクライアントの一覧にない名前で登録されました。次のいずれかの方法で解決できます。
- Claude、ChatGPT、Cursor、Cline、Continue、Goose など、サポートされているクライアントを使います。
- app.nodaro.ai/settings/developer-apps で開発者アプリを登録し、そのクライアント ID とシークレットを使います。独自のクライアントを参照してください。
- 自分のインスタンスでは、クライアント名を
MCP_DCR_ALLOWLISTに追加するか、MCP_DYNAMIC_REGISTRATION=openを設定するよう、管理者に依頼します。セルフホスティング環境での MCP を参照してください。
「このデプロイは、設定したクライアントからの MCP 接続だけを受け付けます」
一部のデプロイは、自分で設定した MCP クライアントにだけ接続を許可します。その管理者は、それらのクライアントを MCP_ALLOWED_CLIENT_IDS に列挙します。そうしたデプロイでは、ほかのクライアントは、どこで試みても止められます。
| 場所 | 返されるもの |
|---|---|
登録(POST /v1/oauth/register) | 403 dcr_disabled |
サインイン(GET /v1/oauth/authorize) | ブラウザーが error=unauthorized_client を付けてクライアントのコールバックに戻ります。同意画面は表示されません。 |
| 同意ページ | 403 mcp_client_not_allowed。ページにはメッセージが表示され、許可ボタンは表示されません。 |
| コードの交換 | 400 unauthorized_client |
| ほかのクライアントのトークン、サインイン中のセッション、個人用 API トークンを使った MCP エンドポイント | 403 mcp_client_not_allowed |
| クライアントを確認できない間の MCP エンドポイント | 503 mcp_client_check_failed。もう一度試してください。 |
クライアント側で変更するものはありません。そうしたデプロイでは、デプロイが提供するアプリから接続してください。
しばらくすると、アシスタントが動かなくなった
アクセスの有効期間は 90 日で、リフレッシュトークンはありません。有効期限が切れると、呼び出しは 401 を返します。クライアントからもう一度ログインするか、コネクタを削除して追加し直してください。
開始していない実行に「MCP 経由」と表示される
接続済みの MCP クライアントが、あなたの代わりに開始した実行です。設定 › 接続済みアプリ(app.nodaro.ai/settings/connected-apps)を開きます。ここには、アカウントにアクセスできるすべてのアプリと AI アシスタントが、それぞれを接続した日、最後に使われた日とともに一覧表示されます。
- 自身を登録したアシスタントは、「AI アシスタント(MCP)— 名前はアシスタントが設定したものです」と表示されます。Nodaro はその名前を検証していません。
- 心当たりのないアプリを削除するには、アクセスを取り消すをクリックし、確認します。そのアプリのアクセスはすぐに無効になり、トークンも使えなくなります。
ツールが表示されない
クライアントは接続済みだが、ツールが表示されない、または一部しか表示されない
許可していない権限が必要なツールは、ツールの一覧にまったく含まれません。コネクタを削除してから追加し直し、同意画面ですべての権限を許可してください。また、一部のツールには複数の権限が必要です。
- スタジオの生成ツールには、
workflows:writeとworkflows:executeの両方が必要です。どちらか一方だけでは、これらのツールは 1 つも表示されません。 - ワークスペースのツールには、
workspaces:readとworkspaces:writeが必要です。ワークスペース機能ができる前に承認した接続には、これらの権限がありません。権限を得るには、接続し直してください。
どのツールにどの権限が必要かは、権限に記載しています。
ドキュメントにあるツールが、一覧にまったくない
一部のツールは、Nodaro Cloud にしかありません。たとえば、パイプライン、スタジオプロダクション、Recast、ワークスペースのツール、start_film_director、create_explainer、plan_edit、voice_changer_pro、pro_3d_render、クレジットのツールです。ワークスペースのツールには組織機能が有効になっていることも必要で、pro_3d_render はそのレンダリングエンジンを利用できる間だけ表示されます。Nodaro Cloud にしかないツールを参照してください。
デプロイでツールが表示されない、または node_not_available が返される
デプロイは、Nodaro Cloud より少ないノード、モデル、機能を提供する場合があります。そのとき、ツールの一覧は、デプロイがあなたのアカウントに提供するものに従います。ツールが一覧に表示されるのは、そのツールに必要なものがすべてあなたに提供されている場合だけです。古いツールの一覧を保持しているクライアントは、そうしたツールを呼び出すことがあります。その呼び出しは、何かが実行または請求される前に、403 node_not_available、model_not_available、link_imports_disabled、world_not_available のいずれかで拒否されます。クライアントにツールを再読み込みさせるか、必要なものを提供するようデプロイの管理者に依頼してください。デプロイでの変更は、約 1 分以内に一覧に反映されます。
ジョブと結果
生成が失敗した
アシスタントに、ジョブ ID を指定して get_job または diagnose_run を呼び出すよう頼みます。確認するのは retryable と guidance です。retryable が false の場合、同じリクエストをそのまま送っても再び失敗するため、設定か入力を変更してください。suggestedProvider がある場合は、同じプロンプトとリファレンスを、そのモデルで実行します。詳しくは、ジョブが失敗した場合を参照してください。失敗したジョブのために確保されたクレジットは返還されます。ただし、後処理での失敗は例外です。
ジョブが pending_review と表示される
このデプロイ環境では、人が確認するために結果を保留しています。ジョブは失敗したのではなく、まだ処理中です。状態の確認を続け、再実行はしないでください。重複したジョブも、同じように保留されます。
wait_for_job が timeout を返す
これはエラーではありません。待機は最長 120 秒で終わり、その時点でジョブがまだ実行中だったということです。もう一度 wait_for_job を呼び出すか、5〜10 秒ごとに get_job でポーリングしてください。動画は通常 2〜10 分かかります。
残高不足による拒否で、デプロイの管理者に依頼するよう表示される
一部のデプロイは、ユーザーの残高を自分で管理しています。たとえば、セルフサービスでの購入がない場合や、外部のウォレットを使う場合です。そこでは、残高不足で拒否されたツールは、デプロイが残高を管理していること、そしてユーザーが管理者に追加を依頼できることを伝えます。そうしたデプロイでは、接続したクライアントから何も購入できません。check_balance は、ユーザーの残りの残高を、デプロイに独自の単位があればその単位で表示します。読み取れなかった金額は 0 ではなく、常に null になります。
結果のカードが表示されない
カードを表示するには、Web 版の Claude など、MCP Apps を表示できるクライアントが必要です。その他のクライアントでは、get_job でジョブを確認するようアシスタントに頼んでください。結果は必ずライブラリに保存されます。
タイムアウトの後、実行が 2 回課金された
run_workflow、run_app、run_component とプロダクション用のツールに client_request_id を渡し、再試行するときは同じ値を使ってください。すると Nodaro は、2 つ目の実行を開始して課金する代わりに、1 つ目の実行を返します。
アップロード
Web 版の Claude で prepare_image_upload が失敗する
署名付き URL によるアップロードには、Cursor、Cline、Claude Desktop、Claude Code など、シェルからストレージのホストにアクセスできるクライアントが必要です。Web 版と Android 版の Claude では、upload_image_widget を使うか、ブラウザーで開くリンクを返す request_image_upload を使ってください。アップロードツールを参照してください。
呼び出しが link_imports_disabled を返す
Request failed (403 link_imports_disabled): Importing media from a link to another site is turned off on this deployment. Upload the file instead.デプロイはほかのサイトからメディアをインポートせず、呼び出しの引数のいずれかが、ほかのサイトへのリンクになっています。リンクは、画像、クリップ、サウンドの URL、リファレンス、ページのほか、アプリの入力、プラン、ワークフローのノードの中のリンクの場合もあります。呼び出しは、何かが実行または請求される前に拒否されました。続けるには、次のようにします。
request_image_upload、request_video_upload、request_audio_upload、またはアップロードウィジェットで、ファイルをアップロードします。クライアント自身がファイルをアップロードできる場合は、prepare_*_uploadツールを使います。- リンクがあった場所に、アップロードが返した
public_url、またはファイルのアセット ID を渡します。
デプロイが作成した結果、アセット ID、ジョブ ID、キャラクター、オブジェクト、ロケーションの ID は、常に受け付けられます。デプロイ自身のストレージへのリンクも、デプロイが渡したとおりに書かれていない場合は拒否されます。たとえば、ホストが大文字の場合や、スペース、バックスラッシュ、.. を含む場合です。リンクは、結果やアップロードが返したとおりに渡してください。プロンプトの中のリンクはテキストとして扱われ、拒否されることはありません。
ワークフロー
update_workflow_json で、ワークフローが変更されたと表示される
ワークフローを読み込んだ後に、誰かがそのワークフローを変更しました。get_workflow_json でもう一度読み込み、新しいバージョンを指定して、変更をもう一度送ってください。
送った設定と、保存された設定が違う
モデルは、すべてのアスペクト比、解像度、品質に対応しているわけではありません。Nodaro は、対応していない値を対応している値に変更するか削除し、変更の一つひとつを adjustments に記載します。元の値をもう一度送るのではなく、list_models を使って、その値に対応したモデルを選んでください。
映画ディレクターのキャンバスが空のまま
映画ディレクターのスキルは、あなたがステージを承認した後に、そのステージのノードを一度に追加します。ノードを追加したと Claude が伝えるまで待ってから、画面を更新してください。そのほかの解決方法は、映画ディレクターにあります。
エラーコード
| コード | ツール | 意味 | 対処 |
|---|---|---|---|
wrong_mcp_host | サーバー | クライアントが app.nodaro.ai/mcp の Web ページを呼び出した | https://mcp.nodaro.ai/mcp を使う |
client_not_allowed | 登録 | クライアント名が受け付けられない | サポートされているクライアントか、開発者アプリを使う |
too_many_open_registrations | 登録 | open モードで、1 つのクライアントの未使用の登録が多すぎる | 既存の登録を使うか、しばらく待つ |
dcr_disabled | 登録 | インスタンスで自己登録がオフになっている、または設定したクライアントだけを受け付けている | 管理者から受け取ったクライアント ID とシークレット、またはデプロイ自身のアプリを使う |
mcp_client_not_allowed | サインインとサーバー | デプロイが、設定した MCP クライアントだけを受け付けている | デプロイが提供するアプリから接続する |
node_not_available、model_not_available、world_not_available | すべてのツール | デプロイが、そのノード、モデル、Studio をあなたのアカウントに提供していない | クライアントのツールを再読み込みするか、デプロイの管理者に依頼する |
link_imports_disabled | リンクを含むすべてのツール | デプロイが、ほかのサイトへのリンクからメディアをインポートしない | ファイルをアップロードし、アップロードが返したものを渡す |
voice_not_found | 音声ツール | ボイス ID が存在しない | 標準ボイスの名前か、自分でクローンしたボイスを使う |
advanced_mode_unsupported | プロンプトとテキストのツール | Gemini でも Claude でもないモデルで advanced_mode が使われた | Gemini か Claude のモデルを選ぶか、詳細モードをオフにする |
advanced_mode_unavailable | プロンプトとテキストのツール | モデル自体のプロバイダーが、現在、詳細モードのリクエストを受け付けられない。クレジットは課金されないか、返還される | 詳細モードをオフにしてモデルを実行するか、あとでもう一度試す |
locked_field | run_app | inputOverrides で、出力の送り先を変更しようとした | 送り先は、アプリの定義のままにする |
portrait_required | generate_character | キャラクターに承認済みのポートレートがない | 先に approve_portrait でポートレートを承認する |
main_image_required | ロケーション、オブジェクト、クリーチャーのツール | 承認済みのメイン画像がない | 先にメイン画像を承認する |
candidate_object_mismatch、candidate_creature_mismatch | 承認ツール | 候補が、別のオブジェクトやクリーチャーのために作られたものである | そのオブジェクトやクリーチャー用に作られた候補を承認する |
scene_overlap | resolve_shot_sequence | 2 つのシーンのリビールが、同じ時間帯に重なっている | 各シーンのキューを、次のシーンのキューより前に置く |
not_available | スタジオプロダクションのツール | デプロイ環境が、スタジオプロダクションを提供していない | 再試行しない。その環境では、この機能を使えない |
studio_preview_unavailable | edit_studio_production | デプロイ環境で、バッチをプレビューできない | 何も送信されていない。プレビューなしでバッチを適用するかを、ユーザーと決める |
not_finished | import_studio_production | プランのジョブがまだ実行中 | ジョブの完了を待ってからインポートする |
cloud_only_feature | combine_videos | セルフホスティング環境で smart_cut が使われた | smart_cut を使わずにクリップをつなぐ |
payer_balance_jwt_only | check_balance、credit_transactions | デプロイ環境の共有請求アカウントは、接続したクライアントからは読み取れない | アプリで残高を確認する |
よくある質問
クライアントでは Nodaro が接続済みと表示されるのに、ツールが 1 つも表示されないのはなぜですか?
同意画面で許可した権限が、ツールに必要な権限を満たしていません。コネクタを削除してから追加し直し、すべての権限を許可してください。
Nodaro MCP サーバーには、どの URL を使えばよいですか?
https://mcp.nodaro.ai/mcp をそのまま使い、末尾にスラッシュを付けないでください。api.nodaro.ai は存在しません。また、app.nodaro.ai/mcp は Web ページで、サーバーではありません。
client_not_allowed はどういう意味ですか?
クライアントが、受け付け対象のクライアントの一覧にない名前で登録されたことを示します。サポートされているクライアントを使うか、Nodaro の設定で開発者アプリを登録し、そのクライアント ID とシークレットを使ってください。
数か月たつと、アシスタントが動かなくなりました。なぜですか?
MCP クライアントからのアクセスの有効期間は 90 日で、リフレッシュトークンはありません。クライアントからもう一度ログインするか、コネクタを削除して追加し直してください。
自分で開始していない実行に「MCP 経由」と表示されています。どうすればよいですか?
接続済みのクライアントが、あなたの代わりに開始した実行です。app.nodaro.ai/settings/connected-apps の「設定 › 接続済みアプリ」を開いて、アカウントにアクセスできるすべてのアプリとアシスタントを確認し、心当たりのないもののアクセスを取り消してください。取り消すと、そのアクセスはすぐに無効になります。
link_imports_disabled はどういう意味ですか?
接続しているデプロイは、ほかのサイトへのリンクからメディアをインポートしません。アップロードツールでファイルをアップロードし、リンクの代わりに、返された public_url またはアセット ID を渡してください。何も実行されず、請求もされていません。
関連ページ
クライアントを接続
ジョブ
独自のクライアント
Nodaro MCP
最終更新