Model Context Protocol(MCP)

AI クライアントから認可済み Guance ツールを呼び出す

Guance OWL MCP Server は、対応する Guance ツールを Model Context Protocol で提供します。MCP 対応クライアントは設定した認証情報の範囲でオブザーバビリティコンテキストを照会・操作でき、権限、ツール選択、結論の責任はエンジニアが保持します。

Guance MCP Server の役割

対応する Guance 機能を、認可済みクライアント向けの構造化 MCP ツールにする

Server は標準ツールインターフェースを提供しますが、無制限のプラットフォームアクセスを許可するものでも、Agent の結論を自動的に正しくするものでもありません。ツール表示は API Key 権限に従い、書き込みツールはリソースを変更できます。ツール、入力、返却された証拠、承認境界をワークフローごとに確認してください。

文書化された MCP Transport に対応するクライアントを接続

クライアントで Endpoint、認証、ツール承認を設定します。クライアント固有の項目と機能は異なるため、Guance と各クライアントの最新ドキュメントを確認してください。

Trae
Cursor
Windsurf
Claude Desktop
VS Code
Codex

MCP 連携で統制すべきこと

現在のコンテキストがない:アシスタントは会話文だけで実システムの状態を検証できません。

認証情報が広すぎる:過剰な権限は、目的外のデータや操作を公開する可能性があります。

ツール利用が不透明:選択したツール、パラメーター、結果が見えなければ、結論を検証できません。

書き込みリスク:Agent が承認なく管理ツールを実行すると、ワークスペースのリソースが変更されます。

Guance が提供するツール経路

構造化ツール:MCP は対応クライアントが確認できる説明と入力 Schema を提供します。

認証情報の境界:Guance のツール表示と結果は設定した API Key 権限に従います。

証拠の経路:クエリ結果をモデルの説明から分離して確認できます。

承認制御:書き込みツールや機密性の高いワークフローには実行前の確認を要求できます。

接続から証拠に基づく調査まで

関連する AI とオブザーバビリティ機能

Guance MCP Server のよくある質問

Guance MCP Server とは何ですか?

Guance OWL MCP Server は、Model Context Protocol を通じて対応する AI クライアントへ Guance ツールを公開し、構造化ツール呼び出しでオブザーバビリティコンテキストや対応操作を要求できるようにします。

データアクセスと書き込み操作はどのように制御されますか?

表示されるツール、アクセス可能なリソース、実行結果は設定した API Key 権限に従います。書き込みツールはワークスペースを変更できるため、Guance は Agent や MCP クライアントのワークフローに手動確認または承認を設けることを推奨しています。

MCP Server と OWL CLI はどう使い分けますか?

MCP 対応 AI クライアントが Guance ツールを直接探索・呼び出す場合は MCP Server、ターミナル、スクリプト、コマンド指向 Agent ワークフローでは OWL CLI を使います。どちらも同じツール指向 Guance 機能層を利用します。

導入ガイド

AI クライアントを権限管理されたオブザーバビリティコンテキストへ