MCP トラブルシューティング 100項目レビュー
提出された dsdx_mcp_troubleshooting_100.md の TS-001..100 全項目(原本 SHA-256: 555449d90bb25e49f79c538bb859639329983f9cd2a17d499fa8d6d91e22b847)を、コードベースおよび隔離実行結果と全数照合しました。記載された100項目すべてが実際の再現不具合ではないため、実不具合の修正・既存実装済み機能・前提の不一致・追加機能要望・仕様競合を明確に区分して整理しています。
基準仕様は DS2-SPEC-V1.1・ds2/v1(新規ST条件拡張は DS2-SPEC-V2.0・ds2/v2)です。修正SHA・実行 buildCommit・UIハッシュ・試験コマンド・失敗履歴・画面キャプチャはデプロイ引継ぎ Work Item #27 に紐付けます。自動回帰試験と外部モデル・実機PLC・ユーザー検収は別個であり、未実行項目は NOT_RUN として記録します。
主な修正および検証範囲
- 閉じられていないブロックや後続トークン、静的診断エラー、空の
source、存在しない Work ID が渡された際に、現在のアクティブモデルや先頭 Work へ暗黙フォールバックしていた境界を遮断しました。 - 文書IDのパーセントデコード・Unicode NFC正規化、CAS競合時の復旧案内、実アセンブリのビルドメタデータ、監査チェーンの再検証を補強しました。
- SILS では仮想ビット(
virtualBits)のみを往復させ、実機PLC接続やデプロイ成功を装いません。Python DSD サイドカーのタイムアウト・標準エラー(stderr)・内蔵サンプルフォールバック境界も分離しました。 - HTTP
Origin検証、CORSOPTIONSプリフライト、リクエスト追跡ID、プロキシバッファリング・キャッシュ抑止ヘッダ、ソケットピア単位のレート・同時実行上限を強化しました。 - 公式サンプル選択、入力中の下書きを保持する文書パネル、8変異検査(
M1..M8)詳細表、APIキー不要の決定論デモと一般AIリクエストの境界を整理しました。 - URL読み取り専用のWeb AI向けに公式文書バンドル(
/ai-start,/ai-start.txt)と PLAY ソース確認経路(/play#source)を案内します。文書の閲覧自体はコンパイル証明書や実機検収の証拠ではありません。
項目別判定(TS-001..TS-100)
項目 · 判定 · 確認結果および処理範囲
TS-001 · 修正済 · APIキーなしの明示的な単一作業時間・関係追加/削除・最適化要求は決定論変換してコンパイル・実行検証します。それ以外の自由自然言語要求には対応範囲とAI接続経路を案内します。
TS-002 · 修正済 · 定型DEMOおよび明示的な時間・関係・最適化のキー不要処理範囲を入力欄と設定画面に明記し、任意の複合自然言語要求をキーなしで生成したとは主張しません。
TS-003 · 修正済 · 時間・相互排他・最適化・検証・PLC・公式サンプルの即時実行に対応し、存在しない対象や曖昧な複合要求は拒否して既存の正本ソースを保持します。
TS-004 · 修正・検証済 · プロンプトコピー直後の段階にキー不要DEMO選択ボタンを追加し、未送信の入力内容とサーバープロジェクトをそのまま保持します。
TS-005 · 部分改善 · includeExamples 応答の公式サンプルを選択・コンパイルします。G-01..06 全文書と画面ボタンの1対1対応完了とは主張しません。
TS-006 · 追加機能 · 直接編集エディタのリアルタイムLint・フォーマット・QuickFixは別途追加機能として管理します。
TS-007 · 前提不一致 · DEMOの17設備すべてが全アクティブSCAN Workと自動カメラ追従に常時結線されるべきという前提は現在の基本Studio契約と異なります。
TS-008 · 部分改善 · 同一スコープ内の宣言位置および生成ST行へ移動し、接続された因果エッジを強調します。3Dは明示的な正規化Work結線かつ同一 project/workspace のみを選択し、配列や曖昧な対象は推測しません。
TS-009 · 既存実装 · キー不要の決定論最適化および候補レビューは動作しており、実機昇格や自由自然言語生成とは区別されます。
TS-010 · 追加機能 · 固定圧縮率を示す個別DSDサンプルセレクタは追加機能項目です。
TS-011 · 修正済 · ソースSHAに束縛されたST・PLCopen(PLCOPEN_TC6_NUMERIC/1)/XG5000 XML(LS_XG5000_XGI_COMPACT/1, ls-xg5000-profile.json)・64-pt 3部スロット(EXPORT-E422_ADDRESS_COLLISION 検査)・シンボルCSV・AAS(SequenceControlData システム単位 Edges · CommandWork/StatusWork)・showcase-html (digital_twin_showcase.html 7タブV3ブリッジ, CSP sandbox/nosniff) プレビュー/コピー/ダウンロード・マニフェストZIPを提供し、並行エクスポート要求が来ても原本を変更しません。
TS-012 · 境界明示 · PLAYの候補/DEMOはアクティブ正本と分離されます。任意のMCP demo-session ヘッダのみでサーバー変更を隔離する機能はなく、Webツール実行器では変更・物理制御ツールを無効化しています。
TS-013 · 修正済 · 公開ツールと入力スキーマを動的表示し、読み取り専用クエリを実行します(リクエスト/レスポンス/cURL/経過時間/キャンセル/復旧を表示し、変更・物理ツールは無効)。
TS-014 · 既存実装 · stable/experimental バッジと実際の応答チャネルフィールドを併記し、色だけで区別しません。
TS-015 · 部分改善 · 検証トレースの全記録スキャンを基準に再生/一時停止/+1/+10/先頭/倍速を提供し、Going 時間はサーバーの elapsed_ms を使用します(実機PLC計測波形や未検証3D動作は捏造しません)。
TS-016 · 既存実装 · ループバックSILS・Virtual Kit (PLC_SILS, VIRTUAL_MEMORY) のみを明示接続し、virtualBits の読み書き往復および DsSilsBaseline 比較省略時 INCONCLUSIVE 判定を検証しました。実機PLC通信は NOT_RUN です。
TS-017 · 修正・検証済 · サーバーが返す変異ごとの KILLED/SURVIVED/NOT_RUN 判定、検出スキャン表、生JSONを併せて表示します。
TS-018 · 検証済 · 390px モバイル画面でのパネル切替、公式文書モーダル、入力保持を実クリックとキャプチャで確認しました。
TS-019 · 追加機能 · ヘッダのデモ一括初期化ボタンはオプションUI機能として管理します。
TS-020 · 修正・検証済 · 編集中の入力欄を壊さない公式文書パネルとエラー案内・再試行・15秒タイムアウト・遅延応答破棄を追加しました。
TS-021 · 前提不一致 · 正本ツール名は dsdx.optimize.propose(キー不要・決定論)であり、optimize.propose 単独名は未登録です。
TS-022 · 部分改善 · dsdx.propose はキー不要の決定論変換ツールとして engineMode/requiresAiKey/editKind を返し、自由自然言語の自動編集は装いません。
TS-023 · 前提不一致 · dsdx.agent.plan は外部AIキーなしで決定論提案とクリティカルパス情報を返します。
TS-024 · 前提不一致 · dsdx.agent.apply は明示された source を隔離サンドボックスで評価し、アクティブプロジェクトの指紋を変更しません(dslText ではなく source を使用)。
TS-025 · 前提不一致 · dsdx.aas.promote は候補サンドボックス評価を共有し、source 引数を受け取ります(dslText/proposalId は契約外)。
TS-026 · 追加機能 · MCPクライアントサンプリング(sampling/createMessage)は任意交渉機能であり、決定論MCP分析には不要です。
TS-027 · 前提不一致 · キー不要の決定論MCP呼び出しでLLMキーエラーは発生しません。対象外の自然言語目標は偽装完了せず明示的に拒否します。
TS-028 · 前提不一致 · 不正な dslText・projectId 引数はLLMキー要求ではなく有効フィールドを案内する HOST-E422_UNKNOWN_ARGUMENT を返します。
TS-029 · 部分改善 · 明示された2つのスカラWork間の関係・相互排他の追加/削除を実装し、曖昧な対象・配列・別スコープは拒否します。
TS-030 · 前提不一致 · 外部MCP分析ツールはサーバー側LLM推論なしで実行されます。Studioの直接AI提案のみが設定済みプロバイダを使用します。
TS-031 · 修正・検証済 · 実稼働Pythonサイドカー結果と内蔵サンプルフォールバックを明確に区別し、タイムアウト・異常終了・不正JSONを隠蔽しません。
TS-032 · 検証済 · dsdx.project.migrate はキー不要で migratedSource・canonicalText・ソースハッシュを返すルールベース言語移行ツールです。
TS-033 · 判定保留(NOT_RUN) · レポート生成はLLM呼び出しなしでテンプレート・ランタイム・コード生成を束ねますが、固定RT計測(10,000 / 2,000スキャン)を伴うため読み取り専用監査では NOT_RUN としました。
TS-034 · 追加機能 · 全公開ツールにMCPアノテーションを付与し、任意3Dエンジンや物理ハードウェアツールは一律 Zero-Key Ready ではなく実際の設定状態を返します。
TS-035 · 前提不一致 · source 省略時にアクティブモデルを暗黙コンパイルするとソース束縛証明原則に反するため、dsdx.compile は明示 source を必須とし、読み取り専用初回呼び出しには dsdx.start {} を用います。
TS-036 · 検証済 · dsdx.work.inspect {} は省略時に先頭Workを返し、存在しないWork ID指定は明示エラーで拒否します(TS-090)。
TS-037 · 前提不一致 · dsdx.catalog.lookup {} は現在プロジェクトの発番識別子一覧を返し、3D設備カタログ(dsdx.scene.catalog / dsdx.library.search)とは役割が異なります。
TS-038 · 追加機能 · dsdx.scene.catalog は3Dエンジン未設定時にAIキーエラーではなく SCENE-E503_ENGINE_NOT_CONFIGURED を返します。
TS-039 · 検証済 · dsdx.telemetry.subscribe はストリーミング待機なしで有限スナップショット {projectName, scan, time_ms, topics} を即時返却し、実機接続証拠としては扱いません。
TS-040 · 追加機能 · 未知のジョブID照会/キャンセルは偽装成功ではなく HOST-E404_JOB_NOT_FOUND を返します。
TS-041 · 追加機能 · 登録ツール名はドット表記の正本および docs_search/docs_read であり、propose/validate 単独名は登録しません。
TS-042 · 修正・検証済 · 28種の正本Host演算とレジストリから動的生成される公開MCPツール一覧を明確に区別しました。
TS-043 · 案内改善・互換維持 · docs_search/docs_read を優先案内しつつ dsdx.docs.search/dsdx.docs.read 別名を維持し、未登録の docs.search は案内しません。
TS-044 · 追加機能 · lint/validate/model.validate が同一静的解析器の互換別名であることをスキーマ説明に明記しました。
TS-045 · 追加機能 · plan・optimize・apply は決定論提案パイプラインを共有し、apply はサンドボックス評価であってアクティブプロジェクト変更ではないことを明示しました。
TS-046 · 検証済 · dsdx.project.get と dsdx.project.inspect は summary/delta/full ビューに対応しています。
TS-047 · 検証済 · dsdx.artifact.export はマニフェストを返し、個別ファイル取得は dsdx.artifact.get で正確なファイル名を指定します。
TS-048 · 修正・検証済 · JSON-RPC id は要求値をそのまま返し、各実行には別個のUUIDベースHost request_id を付与します。
TS-049 · 検証済 · initialize は 2024-11-05・2025-03-26・2025-06-18・2025-11-25 のプロトコル交渉に対応し、不正型は -32602 で拒否します。
TS-050 · 検証済 · POST /mcp は application/json・*/*・application/json, text/event-stream の Accept ヘッダを受け付け、HTTP 200 JSONで応答します。
TS-051 · 検証済 · id のない有効な notifications/initialized 通知は stdio では無応答、HTTP では 202 Accepted 空ボディで処理します。
TS-052 · 前提不一致 · MCP 2025-06-18 以降の仕様ではJSON-RPCバッチ配列が廃止されたため、配列要求には -32600 を返します。
TS-053 · 検証済 · GET /mcp に Accept: text/event-stream のみを送った場合は 405 Allow: POST を返し、通常のブラウザ/文書参照 GET にはインラインガイドを返します。
TS-054 · 修正・検証済 · 許可 Origin を DSDX_PUBLIC_ORIGIN・実リスナー・DSDX_MCP_ALLOWED_ORIGINS で検証して OPTIONS プリフライトを処理し、偽装 Origin/Host を拒否します。
TS-055 · 検証済 · 不正なDSL構文や封印済みSDF変更試行はHTTP 500ではなくHTTP 200ツール応答(isError: true)とドメイン診断コードを返します。
TS-056 · 追加機能 · 全公開ツールスキーマにプロパティ説明と必須フィールドが定義されています。
TS-057 · 検証済 · 公開ツール仕様に readOnlyHint/destructiveHint/idempotentHint を含めています(物理安全認証を代替するものではありません)。
TS-058 · 追加機能 · resources/list は許可された正本リソースを返し、prompts/list は公開プロンプトがないため空一覧({ "prompts": [] })を、prompts/get は -32602 を返します。
TS-059 · 検証済 · scene.render は summary/delta/full とスキャン範囲に対応し、artifact.export は inlineContent: false マニフェストモードに対応しています。
TS-060 · 修正・検証済 · MCP応答に Cache-Control: no-cache と X-Accel-Buffering: no ヘッダを追加しました。
TS-061 · 契約階層の区分 · contracts/host.schema.json はHost交換スキーマであり、JSON-RPCエンベロープや tools/list 入力スキーマとは階層が異なります。
TS-062 · 修正・検証済 · 全Host演算応答に実行アセンブリの buildCommit/specVersion/languageVersion を格納して返します。
TS-063 · 修正・検証済 · パーセントエンコードおよびUnicode NFD文書ID照会時の404を修正し、1回デコードとNFC正規化後に固定カタログと照合します(パストラバーサル遮断は維持)。
TS-064 · 検証済 · 文書節照会は完全一致・前方一致・部分一致・行範囲に対応し、不一致時は SECTION_NOT_FOUND と有効見出し一覧を返します。
TS-065 · 検証済 · SDFの直接編集試行は HOST-E403_SDF_READONLY_SEALED で拒否し、.ds2 正本編集経路を案内します。
TS-066 · 修正・検証済 · CASリビジョン競合時は expectedRevision・actualRevision・復旧演算(dsdx.project.get)を返し、自動上書きを行いません。
TS-067 · 修正・検証済 · 存在しない audit.append 起票APIの記述を是正し、実Issue ID/URLなしで自動起票完了と表示しません。
TS-068 · 前提是正 · 公開イシューガイド(/issue-guide)を優先案内し、社内GitLab接続にはネットワーク/アカウント権限が必要な場合がある旨を明記しました。
TS-069 · 修正・検証済 · 静的診断応答に code・specCode・severity・位置・fixHint・診断文書URLを含め、安全な機械修正がない場合は quickFix = null を維持します。
TS-070 · 検証済 · コンパイル済みSDFは L0..L5 と platformSeal.sealDigest を含み、スキーマ検証をエラー0件で通過します。
TS-071 · 未再現 · トークン化文書検索が韓国語・英語の本文を正常検索できることを確認しました。
TS-072 · 検証済 · マイルストーン文書4種すべてが docs_read で正常取得されます。
TS-073 · 仕様変更が必要 · 静的診断コードは DS2-E001..E029 と specCode/fixHint が正本であり、6大実行不変式番号へ恣意的に割り当てません。
TS-074 · 前提不一致 · 未定義の将来予約語を理由に有効な ds2 識別子を警告・拒否しません。
TS-075 · 範囲明示 · /healthz のアセンブリ・コミット・チャネルは実ランタイム値であり、DSDサイドカー呼び出しは実実行・タイムアウト・サンプルフォールバックを区別して記録します。
TS-076 · 検証済 · 別文で記述したOR合流と1文で記述したAND合流の差異をCore/IRゴールデンテストおよびセルフテストで検証済みです。
TS-077 · 仕様競合 · 逆方向矢印表記は文法上拒否し、オペランドを勝手に反転せず順方向演算子の fixHint を案内します。
TS-078 · 前提是正 · 正規フォーマッタ(sdfToDs2Text)は意味保存正規化ツールであり、コメント・空白を保持するユーザー編集原文は source に別途保持されます。
TS-079 · 既存実装 · firstDivergence は実測された scan・timeMs・workId・irPhase・stPhase・irOutput・stOutput を返します。
TS-080 · 仕様競合 · 応答時間短縮のために8大変異(M1..M8)の一部を省略して PASS と表示することはありません。未実行変異は NOT_RUN とします。
TS-081 · 検証済 · IEC-SYM-2 60字以内の TypedPlcIr シンボル表(ls_xg5000_symbols.csv・compact ST/TSV)および .xgwx 可読名(LsXgiHumanReadable)出力、上限超過時の XGI_IDENTIFIER_LENGTH INFO 通知、電装 I/O 日程 CSV 別の短縮正規化を実装済みです(実機PLCツール取込検収は NOT_RUN)。
TS-082 · 前提是正 · flow.layout は宣言Work順で座標配置するため、循環ループで無限再帰に陥りません。
TS-083 · 検証済 · dsdx.compile 照会はアクティブプロジェクトを変更せず、3D設備配置は個別のCAS保護シーンリビジョンで保存されます。
TS-084 · 範囲明示 · 内蔵AASリポジトリはプロセス内不変マップで動作し、外部分散2PCトランザクションとは主張しません。
TS-085 · 検証済 · Work IDは正規パスSHAに基づくため、同一ソースを複数回コンパイルしても同一IDが生成されます。
TS-086 · 前提不一致 · ペア単位の相互排他(`<\ · >`)三角構造自体を静的デッドロックと断定せず、実際の初期トークンとスキャントレースで判定します。
TS-087 · 前提不一致 · sim.step は保存済みトレースのスキャン照会ツールであり、未定義の steps 一括実行引数は拒否します。
TS-088 · 検証済 · ワークスペース台帳(ledger.json)の正本 .ds2 ソースを再パース・展開して復元するため、過去のバイナリIRに依存しません。
TS-089 · 追加機能 · 大規模フロークラスタの折りたたみ・ページネーションはノードを省略しない別UI拡張項目です。
TS-090 · 修正・検証済 · 存在しないWork ID照会時に先頭Workを返していた不具合を修正して明示エラーで拒否し、不正DSLや空 source がアクティブモデルに置換されないよう遮断しました。
TS-091 · 修正・検証済 · Python DSDサイドカーの stdout/stderr 同時ドレインと3秒タイムアウト・プロセスツリー整理を適用し、サンプルフォールバックと実データ分析完了を区別します。
TS-092 · 前提是正 · dsd.preselect はリクエスト本体のインラインJSON引数(tags・tagsJson・coilRungs・traceJson)をサイドカーで解析して userDataAnalyzed = true(dataScope = REQUEST_COMPONENTS_WITH_REFERENCE_BENCHMARKS)を返し、任意ファイルパスやCSVアップロード引数は拒否します。
TS-093 · 修正・検証済 · 実通信なしで任意エンドポイントを connected と表示していた不具合を修正し、ループバックSILSのみ許可して virtualBits 読み書き値を保持します。
TS-094 · 修正・検証済 · 渡された sealDigest と7種コマンド演算の printable ASCII idempotency_key (HOST-E428_PRECONDITION_REQUIRED) を照合しサーバー検証を通過した場合のみ bundlePrepared = true とし、deployed = false / physicalAcceptance = NOT_RUN 境界を維持します。
TS-095 · 修正・検証済 · 監査ログ保持窓(250件)内の各ダイジェストと前リンクを再計算して chainIntegrityVerified を返し、保持窓超過後も単調増加インデックスを維持します。
TS-096 · 修正・検証済 · ソケットピア基準のHTTPリクエスト量・同時実行上限を適用して X-Forwarded-For 等による回避を防ぎ、超過時は 429 と Retry-After を返します。
TS-097 · 前提是正 · 運用手順の説明が自動イシュー起票・担当者割当APIの実行と誤解されないよう文言を明確化しました。
TS-098 · 範囲明示 · リリースゲート結果は当該ソースSHA・ビルド・試験条件に束縛された成果物として記録し、/healthz に未実行ゲート PASS 定数を埋め込みません。
TS-099 · 検証済 · 28種の正本Host演算、互換ツール別名、公開読取専用10種 (compat 未認証HTTP・キーレス DS Studio Desktop --local-agent 73種) / 所有者認証・ローカル --stdio 全体89種MCPツール構成を initialize・tools/list・/llms.txt 回帰試験で検証しています。
TS-100 · 仕様競合 · /healthz 呼び出しでワークスペースを変更したり1秒以内の全体検証を強制したりせず、隔離E2Eおよび Gate 1~4 で検証します。
運用設定とレート上限
MCPのブラウザ許可 Origin は DSDX_PUBLIC_ORIGIN・実リスナーアドレス・DSDX_MCP_ALLOWED_ORIGINS のみで判定します。リクエストの Host・X-Forwarded-*・任意セッション値は信頼基準とせず、Origin ヘッダを持たない一般的なデスクトップ・CLI MCPクライアントはそのまま利用できます。
HTTP既定上限はソケットピアあたり毎分6,000件、ピア同時8件、全体同時32件(最大1,024ピアスロット)であり、DSDX_MCP_REQUESTS_PER_MINUTE・DSDX_MCP_MAX_CONCURRENT_PER_PEER・DSDX_MCP_MAX_CONCURRENT 環境変数で調整できます。リバースプロキシ配下ではユーザー単位の認証クォータをプロキシ層で別途設定します。
後続機能キュー
自由自然言語20種のキー不要自動変換、50パターン生成器、エディタリアルタイムLint/QuickFix、配列・重複宣言・実機モーションを含む3D自動ハイライト、大規模フロークラスタ折りたたみ、任意MCP sampling/prompts、実機PLC・外部AAS分散トランザクション連携は別機能拡張キューで管理します。仕様外のキーワード・演算子の追加や未実行検証の PASS 表記は行いません。
再現可能な回帰試験スイート
tests/host_troubleshooting.py: 入力・原本・封印ダイジェスト・文書照会・SILS・監査チェーン・DSDタイムアウトおよびフォールバック境界の検証tests/mcp_http_guards.py: stdioおよび隔離HTTP環境でのOrigin偽装遮断、プリフライト、429上限、同時実行解放、DSD応答順序の検証tests/mcp_entry_bootstrap.py: 互換ツールスキーマおよびdsdx.startエントリツールの検証tests/studio_official_docs.py: キーなしHostとブラウザでの公式サンプル選択、文書パネル、変異検査表、入力保持の検証tests/studio_playback_browser.py,tests/studio_source_map.cjs: スキャン移動・再生およびスコープ別DSL/STソース位置移動の検証tests/mcp_playground_browser.py: ツールスキーマ表示、実HTTP読み取り、明示ソース受け渡し、エラー復旧、アクティブプロジェクト保持の検証