ドキュメント

MCP で AI クライアントを接続する

このページの内容

MCP を介して AI クライアントをワークベンチに接続し、カメラの操作を任せることなく、ワークフローを一度に 1 つの変更ずつ反復改善します。

MCP で追加される機能

MCP (Model Context Protocol) を使うと、AI クライアントがワークベンチのサポート対象ツールを呼び出せます。ワークフローの確認、候補の提案、実験の証拠の読み取りなどが可能です。これは同じタスクサービスを操作するための 2 つ目の手段です。カメラドライバー、新しい画像エンジン、本番運用向けの認定が追加されるわけではありません。

質問	レビュー済みプレビューでの回答
クライアントはどこで動作しますか。	Windows ワークステーション上です。クライアントがローカルのタスクサービスを自分で起動し、標準入出力を介して通信します。
カメラを変更しますか。	それだけでは変更しません。ワークフローの読み取り、オフライン実験の実行、カメラ設定の書き込みは、それぞれ別の操作です。カメラ側の調整には、引き続きサポート対象のデバイスワークフローと、その検証手順が必要です。
インターネット接続は必要ですか。	いいえ。リモート MCP アクセスは、認証を伴う別の構成です。権限、セキュリティ、データを参照してください。

接続する前に

インストールと設定の手順に従って Windows ワークベンチをインストールして起動し、オフラインのワークフローを 1 つ実行して、通常の結果がどのようなものかを把握しておきます。
ワークステーションの外に出してよい情報を決めておきます。クライアントは、受け取ったツールの結果 (画像サンプルを含む) を、自身のプロバイダーに転送します。
期待される答えを付けたラベル付きサンプルセットを用意します。開発用の画像は、凍結した検証セットとは分けて保管します。
最初にデモ (シミュレーション) サービスへ接続する計画にします。

クライアント構成をエクスポートする

デスクトップアプリケーションでチューニングウィンドウを開き、MCP 構成のエクスポートを使用します。
クライアントの形式を選択します。Claude 用は JSON、Codex 用は TOML です。
通常のサービスとデモ (シミュレーション) サービスのどちらかを選択します。
テキストをコピーするか、保存します。推奨ファイル名は deyivision-mcp です。

エクスポートされるエントリの名前は deyivision です。このエントリには、インストール済みタスクサービスのフルパス、--mcp 引数 (デモサービスの場合はさらに --simulation)、および 3 つの環境変数 DEYIVISION_TUNING_INSTANCE、DEYIVISION_TUNING_DESKTOP_INSTANCE、DEYIVISION_TUNING_DATA が含まれます。トークン、カメラの認証情報、その他の環境変数が含まれることは一切ありません。デモ用のエントリでは、そのサービスが独自のデータを保持するため、データフォルダーを省略します。

クライアントに登録する

deyivision エントリを、クライアントの MCP 構成にマージします。Claude の場合は JSON ファイルの mcpServers オブジェクト、Codex の場合は TOML ファイルです。このファイルの場所はクライアントとそのバージョンによって異なるため、クライアント自身のドキュメントに従ってください。
クライアントを再起動して、エントリを読み込ませます。
クライアントに DeYiVision のツールを一覧表示するよう依頼します。何も表示されない場合は、ワークベンチ側を変更する前に、パスとクライアントのログを確認します。
ワークベンチを移動または再インストールした場合、インスタンスを変更した場合、またはデータルートを変更した場合は、再度エクスポートします。エントリには絶対パスが保存されているためです。

最初の接続を確認する

まずデモサービスから始めます。ツール呼び出しが成功すれば、クライアントがサービスを起動して通信できることは確認できます。ただし、カメラや実際の画像検査は行われません。また、デモサービスはデバイスモードのデータとは別にデータを保持します。デモサービスをデバイスモードのデータフォルダーに向けないでください。2 つのサービスが同じタスク台帳を巡って競合します。

通常のサービスへ切り替えるのは、デモサービスの呼び出しが動作してからにします。ツールの一覧が表示されても、カメラが接続されている証拠にはなりません。カメラ接続と画像取得を参照してください。

変更は一度に 1 つずつ反復する

最初の実行の前に、サンプルセットと期待される答えを固定します。
クライアントに、現在のワークフローのリビジョンとその最新の結果を確認するよう依頼します。リビジョン、ノードの設定、入力の ID、出力または判定、経過時間、および不一致があればその内容を記録します。
変更する候補は 1 つだけにします。サポート対象のノードまたはパラメータを 1 つだけ変更します。候補を送信すると提案が保存されますが、実行はされません。
同じ固定画像で候補を実行します。実行するとタスクの PC トライアルバジェットが消費されます。新しいカメラ露出やカメラパラメータの書き込みではありません。
証拠は自分で確認します。画像、出力、バージョン、失敗したケースを見てください。見た目がきれいな画像でも、誤った判定になることがあります。
候補を採用するか破棄してから、同じ手順を繰り返します。その間に人または別のクライアントがワークフローを変更した場合は、まず最新のリビジョンと担当者のレビューを読み取ります。古い下書きで現在のリビジョンを上書きしてはいけません。また、古くなったレビューのリビジョンに紐づく候補は拒否されます。

リビジョン、送信、実行の各操作については、ワークフローの作成と実行を参照してください。

人の管理下に残すもの

カメラへの書き込み。MCP クライアントであっても、ジョブと検査結果に記載された制御を迂回することはできません。カメラへの書き込みには、引き続き正しいデバイスとセッション、権限、適格な状態、記録されたベースライン、リードバックが必要です。
権限。モデルへのアクセスは本質的に読み取り専用ではありません。認証されたモデルが、書き込み可能なツールを持つ場合があります。クライアントを接続する前に、クライアントが到達できる範囲を決め、接続後はクライアントが行った操作を確認します。
結果が不明な場合。書き込みの結果が不確かな場合は、元のリクエスト受信記録を読み取ります。新しいリクエスト ID で書き込みを繰り返してはいけません。
受け入れ。保存済み画像に対するオフライン実験では、新しいフレームが現場のラインでどのように動作するかは証明できません。運用上の主張をする前に、サンプルと受け入れの限界値を取り決めてください。

データとプライバシー

クライアントは、ツールが返す内容 (画像サンプルを含む) を、選択したプロバイダーに送信します。事前に、受信者、データ権利、プロバイダーのポリシーを確認してください。リクエストレベルのストア設定は、すべての下流側当事者の保持を保証するものではありません。

エクスポートされた構成に含まれるのは、ローカルのパスとフォルダー名だけです。起動時の出力にはローカルアクセストークンが含まれることがあるため、サポートへのメッセージに貼り付けないでください。

トラブルシューティング

症状	確認と次のステップ
クライアントに DeYiVision のツールが表示されない	エントリがクライアントの実際の構成ファイルにマージされていることを確認し、クライアントを再起動して、コマンドがインストール済みタスクサービスの実行ファイルを指していることを確認します。ワークベンチを移動した場合は、再度エクスポートします。
サービスは起動するが、その後失敗する	インスタンスとデータの環境変数を、実行中のワークベンチと照合します。対応する組み合わせを使用し、デモサービスと通常のサービスで 1 つのデータフォルダーを共有することは絶対にしないでください。
動いていたが、再インストールや移動の後に動かなくなった	エントリには絶対パスが保存されています。構成を再度エクスポートし、古いエントリを置き換えます。
候補が古いという理由で拒否される	最新のワークフローリビジョンと担当者のレビューを読み取ってから、変更を改めて提案します。
書き込みの結果が不明	新しい操作が適切かどうかを判断する前に、元のリクエスト受信記録を読み取ります。

このガイドの制限事項

正確なツールの一覧とツール名は、接続先のサービスから取得されるもので、ビルドによって変わることがあります。クライアントに一覧表示を依頼して確認してください。エクスポートが対応するのは Claude (JSON) と Codex (TOML) の形式であり、クライアントの各バージョンでの動作は、ここでは認定していません。

2026 年 9 月 23 日に、隔離した Windows ビルドで実施したエンジニアリング確認では、リモート MCP クライアントを通じて元画像と処理済み画像を取得しました。どちらの実行も NoRead (0/1) を返しました。この確認で示されたのは、ワークフローの受け渡し、リビジョン管理、証拠の取得であり、バーコードの読み取り率、実際のカメラとの互換性、本番運用での安定性は確立していません。