コンテンツにスキップ

チャット、MCP、およびWindows統合における安全な操作

WebチャットとMCPは同じ機能カタログとバージョン管理されたドメインサービスを使用します。読み書きは同じプロジェクト、役割、オブジェクト、バージョンチェックに従います。対応ドメインにはテストライブラリ、要件、計画、実行、結果、レビュー、リレーション、欠陥、添付ファイル、リリースおよび変更知識、管理、Wordのインポートまたはエクスポートが含まれます。

AIの回答やMCPプレビューはプロジェクトデータを変更しません。書き込みは準備され、レビューされ、明示的に確認され、監査されます。

準備、レビュー、コミット、および監査を行います。

  1. 準備: チャットまたはMCPは要求されたドメイン操作を具体的で権限チェック済みの準備に変換します。
  2. プレビュー: 対象、提案された変更、影響、警告、および関連する場合は期待されるオブジェクトバージョンをレビューします。
  3. 確定: 理解した変更のないプレビューのみを確認してください。有効期限切れまたはバージョン競合後は再起動してください。
  4. 監査: 結果、ディープリンク、監査記録をレビューします。冪等性により技術的な再試行が同じ変更を二重に適用することを防ぎます。

権限不足、古いバージョン、不明な機能、または無効な引数は部分的な更新を適用せずに失敗します。

最小権限でMCPを設定する

MCPはPOST /mcpでJSON-RPC 2.0を使用します。個人プロジェクトAPIキーはアクティブなプロジェクトユーザーの役割と権限で動作します。グローバル管理キーは別であり、グローバルキーがプロジェクトツールにアクセスするには明示的な追加承認が必要です。

  • 意図したMCP APIキー管理でキーを作成し、秘密をすぐにコピーしてください。再表示はできません。
  • 短い有効期限、最小限のスコープ、明確な目的を使用してください。
  • 暗黙のグローバルコンテキストに依存せず、プロジェクト固有のIDまたは承認されたプロジェクトパスを渡してください。
  • 操作を自動化する前に、ツールカタログと機能エクスプローラーを確認してください。
  • もはや必要ないか、漏洩の可能性があるキーを取り消してください。

MCPを通じた再利用可能なテストステップ

再利用可能なテストステップの場合、ztm_project_reusable_test_stepsはproject.reusable-test-step.read機能を使用します:

operation その他の引数 結果
list オプション includeArchived 現在の固定リビジョンおよびフィンガープリントを持つ許可されたブロック
detail blockID 内容、改訂履歴および許可された使用法
composition testCaseVariantID 現在のライブラリバリアントセクションおよびフィンガープリント

書き込みはztm_project_action_prepareおよびztm_project_action_commitを使用します。APIキーは正確な書き込み機能を許可している必要があり、一般的な書き込みアクセスは不十分です。これらのargumentsを提供してください:

機能 引数
project.reusable-test-step.save blockはID(作成時は空)、TestUnitID、Title、StepsRaw、ExpectedRaw、Note、ArchivedおよびexpectedFingerprint(作成時は空)を使用します。
project.reusable-test-step.composition.save testCaseVariantID、完全な順序のsections、およびexpectedFingerprint
project.reusable-test-step.composition.detach testCaseVariantID と expectedFingerprint

再利用可能なセクションにはBlockIDと明示的に選択されたRevisionが含まれます。ローカルセクションにはBlockIDがなく、StepsRawとオプションのExpectedRawが含まれます。生テキストはプロジェクトのHTMLまたはMarkdownモードに従います。構成を保存する際は変更されていないローカルセクションをすべて保持してください。意図的に空の期待結果は空のままです。

saveは新しい固定リビジョンを作成し、Archived: trueはブロックをアーカイブします。物理削除コマンドやすべての使用箇所の自動更新はありません。参照を解決済みの生テキストに置き換えて、1つのセクションをローカルコンテンツに変換します。detachコマンドは保存された構成全体を変換します。

コミット前に古い内容と新しい内容を確認し、技術的リトライには同じidempotencyKeyを再利用し、返されたpreviewTokenのみをコミットします。フィンガープリントの競合後に再読み込みと再準備を行います。共有Runtimeサービスはソース読み取りとターゲット書き込みアクセスをチェックし、クイックテストを拒否します。既存の同期はskippedManagedContentを返し、保存された履歴コンテンツ:既存の実行で管理されたステップ/結果は固定されたままで、他の選択されたフィールドのみが同期される場合があります。

ローカルブリッジおよび制御されたローカルアクション

Zeta Test ローカルブリッジはサポートされるウェブワークフローを制御されたローカルWindows機能に接続します。ウェブサーバーは任意のローカルプロセスを起動できません。ChromeまたはEdgeはブラウザ拡張を通じてインストール済みのNative Messagingホストと通信し、マシンレベルのポリシーは名前付きかつ型指定されたアクションのみを許可します。

  1. 管理者はNative Hostとブラウザー拡張機能を展開し、意図したZTMウェブサイトのみを接続します。
  2. 顧客のITはLocal Bridgeポリシーで承認されたプロセスアクションを定義します。Webクライアントでは自由なコマンドラインおよびレガシーLuaは引き続きブロックされます。
  3. 外部ツールはztm-local-bridge:action-idのような構造化された参照を使用します。インストールされポリシー承認されたアクションのみが実行可能です。
  4. 管理機能を使用してステータス、バージョン、チェックサム、エンドポイント、および生成されたChromeまたはEdgeのポリシー値を検証してください。

拡張機能、Native Host、サイト関連付け、およびローカルポリシーは一つのセキュリティ境界として扱います。接続されたブリッジはプロジェクトやオブジェクトの権限を置き換えません。

テストケースのバージョン

ztm_project_test_case_versionsはテストケースのバージョンからproject.test-case-version.readまでを読み取ります。リスト、内容、比較、履歴ファイルおよびプレビューはWebクライアントと同じオブジェクト権限を適用します。復元は準備済みかつ明示的に確認されたproject.test-case-version.restore書き込み権限を使用し、引数とワークフローはREST 章にも記載されています。

読み取り専用品質レポート

ztm_library_health_read(project.library-health.read)は表示されているライブラリケースの説明付きレビュー指標を返します。ztm_test_stability_read(project.test-stability.read)は表示されている完了済み実行から結果の変更および失敗グループと結果証拠を返します。両者ともWebサービスを使用し、書き込み権限は不要です。可視性の境界、分析制限、変更された自動化証拠は明示的に維持されます。指標はビジネス判断の代替ではありません。フィルター、応答フィールド、REST例はAPI章に記載されています。

ztm_project_planning_tree_readはカスタム結果ステータスでフィルタリングされた計画ツリーを読み取ります。フィルター契約を参照してください。この読み取り操作は個人ビュー設定を変更しません。

project.presentation-settings.updateの機能にはブール値のsettings.showWindowsWebLinksが含まれます。これはデフォルトで有効です。現在の設定を読み取り、このフィールドを変更し、更新を準備して明示的に確認してください。このフィールドを省略した古いペイロードは現在の値を保持します。同じ契約はMCPおよびRESTを通じて適用され、プロジェクト管理権限、スコープチェック、古いプレビュー保護を含みます。

これはオプションのWindowsメニューおよびダイアログの項目を制御し、Webアクセス権限には影響しません。明示的なWebで開きます。リボンコマンドは引き続き利用可能です。他のクライアントによる変更後はWindowsでプロジェクトを再度開いてください。

他のテストツールからインポートする

現在の開発ビルドでは、他のツールからの移行のためにMCPツールztm_vendor_migration_previewおよびztm_vendor_migration_applyを使用してください。REST APIはそれらの共通パラメータ、書き込みアクセスおよびリトライ動作を説明しています。