ホームへ戻る

GitHub Repo

Difyコミュニティ、失敗したツール呼び出しが成功として記録されるのを防ぐMCPエラー処理の修正を提案

Difyコミュニティは11月12日、MCPツールが`isError`フラグを返した場合でもワークフローが成功と見なし、エラー処理ポリシーをスキップする可能性があると報告した。修正提案にはユニットテストが追加されているが、まだマージされておらず、本番環境への影響範囲は確認されていない。

The original uploader was Ggia at Greek Wikipedia. · CC BY-SA 2.5 · Image source
zh-Hant

Difyコミュニティは11月12日、MCPツールが明示的にisError: trueを返しても、通常のツール出力に変換されてしまう問題を報告し、修正を提案した。報告された環境は、ソースコードから構築したセルフホスト版で、バージョンは1.19.0、ブランチはf8fc371のコミットとされている。この情報だけでは、すべてのデプロイ済みバージョンが影響を受けるとは判断できない。問題報告

問題は、プロトコルの結果とワークフローの状態をつなぐ部分にある。MCP仕様では、JSON-RPCレベルのエラーとツール実行時のエラーが区別されている。API呼び出しの失敗や入力データ、ビジネスロジックに関するエラーは、通常の結果オブジェクト内のisErrorで示すことができ、エラーの説明はcontentに格納される。そのため、形式が正常なレスポンスを受け取っても、ツールの実行が成功したとは限らない。MCPツール仕様

報告者はモックサーバーのレスポンスを使って問題を再現した。データベースツールが接続拒否とエラーフラグを返した後も、MCPTool._invokeは例外を送出せず、テキストメッセージを生成したという。報告によると、この動作ではツールノードが成功として記録され、失敗分岐、再試行、デフォルト値の各ポリシーが実行されない。エージェントも、その呼び出しを通常の観察結果として記録する。エラーテキスト自体は残るものの、フロー制御では明確な失敗シグナルが失われる。再現の詳細

修正提案ではフラグを確認してToolInvokeErrorを送出し、プラグインや組み込みツールと共通のエラー処理経路を利用する。サーバーからのテキストは保持されるため、エージェントが呼び出しを修正できる可能性がある。テキスト内容がない場合は、ツール名を使ってエラーメッセージを生成する。使用量情報は例外を送出する前に記録される。提案者によると、追加されたテストはテキストを含むエラー結果と、非テキスト内容のみのエラー結果を対象としており、元のブランチでは失敗し、修正適用後は成功した。修正提案

確認時点で、この提案はオープンのままコードオーナーのレビュー待ちであり、正式な修正には至っていない。エンジニアリングチームは、明示的なエラーフラグを返すテストツールを使い、ノードの状態とエラー分岐が想定どおりに動作するかを事前に確認できる。今後はマージとリリースに加え、実際のMCPサービスとの統合検証が焦点となる。現時点の証拠は主にモックレスポンスとユニットテストに基づいており、本番環境でのインシデント規模を定量化するには不十分だ。

出典

  1. Dify issue #46107:MCP 錯誤結果被視為成功
  2. Dify PR #46108:依 isError 標記拋出工具錯誤
  3. Model Context Protocol:Tools 與錯誤處理規範