2026-08-01T11:10:44.797Z

MCPの観察性:5層の健康契約を締結する

MCPの承認,交渉状態,ツール発見,要求,外部効果,および検証された結果を,欠落した証拠を緑色に変えることなく関連付けます.

MCPの観察性:5層の健康契約を締結する
MCPの観測能力は,要求が返回されたよりも難しい質問に答えなければならない. モデルコンテキストプロトコルセッションごとに,ツール発見,呼び出し,外部効果,およびユーザの予想の結果を通じて承認と初期化から関連性のある証拠チェーンを保存する. 緑の tools/call 反応はその鎖の1つのリンクにすぎない. 合理的な欠陥は5層の健康契約です 1. Session: クライアントとサーバーはサポートされているプロトコルバージョンとこの実行が使う機能について交渉しましたか? 2. カタログ: クライアントは,現在のツールリストを全部読んで,リスト変更信号に反応したのでしょうか? 3. Request: JSON-RPC要求,進捗通知,キャンセル,応答,締め切りに参加できますか? 4. EEffect: ツールが外部システムを変更した場合,実際に起こったことの目的地証拠はありますか? 5. Ooutcome: 代理人が生産すべき遺物,状態変更,または決定が検証を通過したのか? この契約は プロトコル活動と有用な進歩を意図的に分離します また,運行者に needs auth , incompatible session , stale catalog , working , protocol error , tool failed , effect unknown , false success ,または healthy を経路するコンクリート状態を与えます. 1つのダッシュボード番号ではなく 1つの証拠チェーンから始めましょう mcp観測能力に関する最新の米国結果は,セッション,接続,ツール分析,輸送遅延,吞吐量,エラーを強調しています. 役に立ちます グラファナの現在のMCP 観察性ドキュメントは,セッション設定,接続安定性,プロトコル遵守,ツール性能,輸送信頼性をリストする. この信号が間違っているという違いはありません ギャップは,それらのいずれも,単独で,エージェントの意図された作業が目的地に到達したことを証明することはありません. 医療記録は,コンパクトで維持できます. ハッシュは識別子であり,ツールスケーマ,議論,プロンプト,トークン,または返品コンテンツをアップロードする許可ではありません. ホストに敏感な価値観を保ちなさい. 決定を証明するために必要な最小のフィールドを記録する. また,契約には優先順位規則があるべきです. 許可失敗はセッションの健康状態より先に来る. 互換性のないセッションはカタログのフレッシュさより先に来る. 解答されていないカタログは要求解釈より先に来る. 副作用の境界線での輸送タイムアウトは effect unknown になり,自動的な再試ではなくなる. 欠落したデリバリーのある成功した呼び出しは false success になり,健康ではありません. ツール遅延を測定する前にプロトコル状態を観察できるようにする MCP ライフサイクルの仕様は初期化を最初のクライアントとサーバーの相互作用にする. 協定のバージョンを合意し 能力交換し 正常な運用を開始します 同じ文書では,次回の通信は交渉されたバージョンと能力を尊重しなければならないと書かれています. 観測可能になるのは 要求されたバージョン,受け入れられたバージョン,能力セット,クライアントが notifications/initialized を送信した瞬間です HTTP トランスポートでは,権限は別途ゲートです. 現在のMCP許可の仕様は保護されたリソースの発見を定義し,クライアントが 401 Unauthorized の課題に対処することを要求します. サーバはアクセス可能で正しく,クライアントがトークンを欠いているとき, 範囲が間違っているとき, 権限サーバを発見できないとき. needs auth と書き換える. 輸送中断として書き換えるな. ツール発見は 完全性の証明が必要です 道具の仕様は tools/list がページ化され, listChanged を宣言するサーバーが notifications/tools/list changed を発射できると言います. だから we received one page は新しいカタログではありません. 記録: - ツールを広告した初期化機能 - nextCursor が残らないまで,すべてのページ化カーサー; - 名前と入力/出力スケーマの定例式ハッシュ; - 最後の成功したリフレッシュ時間 - tools/list changed の通知及びその後の更新. これは全てのスケーマを記録するよりも狭いものです クライアントはハッシュを本地的に計算し,ハッシュ,ツール数,ページ数,更新証拠のみを保持できます. 変更通知が到着し,更新が失敗した場合,セッションを stale catalog に分類します. サーバはピングに答えても モデルが 時代遅れのツール契約から選択しているかもしれません 長い電話は もう一つの罠です MCP 進展に関する通知は,アクティブリクエストの中でユニークで,要求が提供されたトークンを使用し,進捗値が増加し,通知が完了後停止しなければならない. その証拠は working を正当化できる. 作業の有用性が証明されず,期限を永遠に延長してはならない. 値が増加しない繰り返しメッセージ,間違った要求に添付されたトークン,または端末応答の後の進歩は不一致な証拠です. 2つの時計を使う - 有効な単調な進捗をリセットできる無効性ウィンドウ - 絶対的な最大期限が,リセットされない. この区別は 反対の2つの誤りを防ぐのです 合法的な長期労働が返還されていないため 合法的な長期労働を殺すことと 進歩の通知の無限の流れを健康として受け入れることです 成功するツール呼び出しは結果ではありません MCPはプロトコルエラーとツール実行エラーを区別する. ツールの仕様によると,不正な要求および未知のツールは JSON-RPCエラーを使用しますが,ビジネスまたは入力失敗は isError: true でツールの結果を返却することができます. protocol error のクライアント契約を修正し, tool failed の入力,許可,または下流依存性を調整する. 副作用が発生した後に 反応がないことが最も危険なケースです publish report を掛け算すると 交通不確実性について 目的地について何も語られていないため すぐに再確認すると 複製報告が作成されます effect unknown の呼び出しをマークし,安定した操作キーまたは目的のクエリを使用して調整し,最初の未遂が未遂であることを証明した後にのみ再試します. 普通の結果でも十分ではない. サーバーは約束されたファイルが欠席している間に isError: false を返却することができます リモートレコードはまだドラフトです. またはURLはプライベートです. 呼び出し前に選択した結果検証符を追加する:ファイルハッシュ,データベース行プラスバージョン,公開HTTP状態,テスト結果,または他の決定的な領収書. LLM判事は,結果が直接確認できない場合にのみ使用し,弱い証拠を標識する. これは,3つの異なる端末の状態を生み出します プロトコル結果 目的地効果 期待された結果 健康状態 --- --- --- --- タイムアウト 未知 未知 effect unknown 成功 確認された 失敗または失踪 false success 成功 確認された 確認された healthy 中間列が大事だ 代理人がユーザのタスクを完了したという誤った主張になるのを防ぐ. 契約を不都合なケースに対して再現する 付随するアーテファクトは,例示的な9つのケースの固定物と決定的な分類物です. 生産テレメトリは含まれていません 実行する: この設定は,1つの健全な輸出と8つの不都合な境界線をカバーします:許可の挑戦,サポートされていないプロトコルバージョン,和解されていないツールリスト変更,有効な進展のある長期間の呼び出し,不正な呼び出し,ツール実行エラー,可能の副作用後タイムアウト,そして欠落したデリバリーで成功. 分類者は,予想される各状態で1つのケースを返した. これは方法の偽造可能な部分です 証拠を変えれば 状態は予測可能に変化します tools/list changed が完全に更新された場合,古いカタログケースは前進する必要があります. タイムアウト通話が目的地領収書を受け取ったが,配達可能な検証が失敗した場合, effect unknown から false success に移動する必要があります. セッション,カタログ,要求,効果,および結果証拠が一致する場合にのみ healthy に到達します. 道具のビジネスセマンティックが正しいかどうかを検証しない. OAuthの発行者が信頼できることを証明したり,期限がどのくらいの期間か決めるものではありません. 部署特別のレビューです 欠落した証拠が 黙って緑化されないようにすることです 行動を起こす必要のある状態に関する警告 健康状態を同じチャンネルに 送ってはいけません - needs auth は,要求されるリソースと範囲を,決してトークン値ではない,証明書または権限所有者に渡します. - incompatible session はクライアントバージョン,サーバーバージョン,交渉可能な機能を集成所有者に提供します. - stale catalog は1つの制限された再発見試みを誘発し,繰り返し失敗は統合事故になります. - working は,進歩が有効であり,絶対的な期限が続く間,静かです. - protocol error は,クライアント実装者に方法,リクエスト識別子,および消毒されたエラークラスを入力します. - tool failed は,故障が逆転可能なことが知られている場合にのみ,ツールのリトライポリシーに従います. - effect unknown は副作用の境界線で自動的に再テストをブロックし,和解を開始します. - false success は,MCPが完成したにもかかわらず,結果事件を開きます. このルーティングは 等式を ステックと区別します. 特定の人に割り当てられた許可プロンプトは正当な等式であり,制限された要求内で進捗する進捗トークンは動作であり,リスト変更信号の後に変更されていないカタログはどちらもありません. 単一の高価値ツールと 真の結果検証装置から始めましょう 鎖を一週間捕まえ 知らない状態を全て調べ 覆い込み 関連のないイベントをベースにした完璧な全艦隊のダッシュボードは,セッション,効果,結果が端から端まで説明できるツールコールよりも有用性が低い. この契約が終わるとき MCPの観測能力はプロトコルと運用証拠を確立できるが,ワイヤからすべてのユーザの意図を推論することはできない. 有効な出力スケーマは形を証明する 真実ではなく 目的地領収書が 効果を示すのではなく 効果が賢明であることを証明する 単調な進捗信号は,サーバーが報告した動きを証明し,ユーザの目標に向かって有用な進捗ではない. これらの境界線には 適用のチェックと 時には人間の判断が必要である. Sidewisp は現在プライベートプレビュー段階です。 生産監視アダプターと回収システムは一般的には出荷されません. 本条の契約は,操作方法であり,検査可能な地元の遺物であり,Sidewispが既にMCPセッションを収集または修理していると主張するものではありません. 対象となる製品方向は,既存の実行時間とともに,健康証拠,不確実性,承認の境界線をより簡単に確認することです. MCP 統合を現在設計している場合は 5 層の記録を本地で保持し,内容を編集し,予想される結果が自己領収されるまで,実行を健康と呼んでないでください. この規則は プロトコルテレメトリを 別のグリーンチャートではなく 運用決定に変えるのです