Scout を連携する

Scout には、FactVerse Web、プラットフォーム MCP、REST API の三つのアクセス方法があります。Web は人による調査とレビュー、MCP は AI クライアントから管理対象ツールを使う場合、REST API はアプリケーション連携と自動化に適しています。

連携方法を選ぶ

方法	適した用途	認証
FactVerse Web	タスク作成、根拠レビュー、承認、公開	プラットフォームへのユーザーログイン
プラットフォーム MCP	外部 AI クライアントからタスクを読み、許可済みツールを実行	プラットフォーム MCP 認証情報と `X-API-Key`
REST API	Scout 操作を業務システムや自動化へ接続	導入環境が提供するプラットフォーム認証情報

すべての方法で同じテナント、タスク、権限、監査記録を使用します。正確なリクエスト項目は、導入環境が返すツール定義または API 仕様を参照してください。

前提条件と入力情報

FactVerse ホストと対象テナント
有効化された Scout とプラットフォーム MCP
有効なアカウント、用途、最小権限に関連付けられたプラットフォーム認証情報
業務上の問いと設備またはデータセット範囲
許可済みサービス応答から取得したタスク ID とリソース ID

最初に読み取り専用アクセスで機能とタスクを一覧し、意図したテナントへ接続していることを確認します。

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

リモート MCP Streamable HTTP とカスタムリクエストヘッダーに対応するクライアントを使用します。Scout エンドポイントは次のとおりです。

https://your-factverse-host/mcp/scout/

テナント管理者にプラットフォーム MCP 認証情報の発行を依頼します。初回確認には用途 READ、スコープ scout.read を使用します。
クライアントにリモート MCP サービスを追加します。プライベート導入では顧客環境のプラットフォームアドレスを入力します。
保護された設定へ X-API-Key ヘッダーを追加し、プラットフォーム MCP 認証情報を値に設定します。
接続後にツール一覧を更新し、scout_capabilities、scout_mission_list、scout_mission_get の順に呼び出します。
返されたタスク、設備、ソース選択肢、テナント情報を確認します。

ツール	用途
`scout_capabilities`	利用可能なフロー、業務目標、許可済みソース選択肢を表示
`scout_mission_list`	現在のテナントで参照できる Scout タスクをページ単位で一覧
`scout_mission_get`	選択タスクの段階、阻害要因、次の操作、根拠参照を表示

ツール入力にはクライアントが表示する定義を使用します。タスク一覧が空の場合は、現在の検索範囲に参照可能なタスクがありません。Web でタスクを作成するか、管理者にアクセス権限の確認を依頼します。

認証情報の用途を割り当てる

作業責任	認証情報の用途	Scout スコープ
タスクと根拠を表示	`READ`	`scout.read`
タスク作成、調査、検証	`OPERATOR`	`scout.read`、`scout.write`
公開根拠をレビュー	`APPROVER`	`scout.read`、`scout.approve`
承認済み公開または対応する復元を実行	`DEPLOYER`	`scout.read`、`scout.deploy`

プラットフォームは、アカウント状態と関連するデータ、MDM、モデル、DFS 権限も確認します。公開で職務分離が必要な場合は、承認者と公開担当者へ別々のアクセスを設定します。

例：設備シグナルを調査する

AI クライアントへ次のように依頼できます。

このモーターについて、直近一週間の振動、温度、バッテリーデータを調査してください。実設備、X/Y/Z 方向、測定種別、単位を確認し、対応付け候補を出す前に根拠と確認事項を示してください。

scout_capabilities で利用可能なフローと業務目標を確認します。
scout_mission_list でタスクを探し、scout_mission_get で範囲と現在の段階を確認します。
ツール定義に従って許可済みソースを調査し、候補の根拠を確認します。
設備マニュアル、設置記録、フィールド担当者の確認を追加します。
適切なロールで候補レビュー、検証、承認、公開を完了します。
指定期間の実際の読値とアプリケーション結果を確認します。

例：業務データの受領をレビューする

公開済みの業務目標に対して、この許可済みデータを確認してください。データセットを特定し、フィールドの意味と ID キーを提案し、重複レコードと関係を調べ、領域レビューが必要な定義を一覧してください。

機能応答から業務目標とソースを選択し、棚卸し、プロファイル、フィールドと MDM の判断、ドライラン、承認、公開を進めます。定期的なデータは有効版と比較してから処理します。詳細は次回データの受領を参照してください。

REST API エンドポイント

次のパスは FactVerse ホストからの相対パスです。リソース ID は、現在のテナントに対する許可済み応答から取得します。

メソッドとパス	用途
`GET /api/v1/scout/missions`	タスク一覧
`GET /api/v1/scout/missions/{missionId}`	タスクを取得
`POST /api/v1/scout/missions/{missionId}/discovery`	探索を開始
`GET /api/v1/scout/missions/{missionId}/semantic-model-proposals/options`	モデルドラフト、設備、属性、互換クラスの選択肢を取得
`POST /api/v1/scout/missions/{missionId}/semantic-model-proposals`	モデル提案をレビューへ提出
`POST /api/v1/scout/missions/{missionId}/semantic-model-proposals/{id}/review`	モデル提案の判断を記録
`POST /api/v1/scout/missions/{missionId}/semantic-model-proposals/{id}/apply-to-draft`	承認済み提案をモデルドラフトへ適用
`POST /api/v1/scout/missions/{missionId}/semantic-execution/dry-runs`	モデルと参照の公開計画を検証

モデル関連 API には、対応するモデル、MDM、DFS 権限も必要です。ドラフトへ変更を適用した後、独立した公開承認と実行フローを進めます。

再試行とエラーを処理する

Idempotency-Key が必要な API では、同じ論理リクエストと内容に同じキーを使用します。タイムアウト後は操作状態を取得し、サービスが対応するべき等操作だけを再試行します。

応答	処理
401	プラットフォーム認証を更新または復旧
403	テナント、モジュール、操作、関連データ権限を確認
404	現在のテナントから返されたリソース ID で再照会
409	最新版を取得し、再検証・再レビュー
429	応答に従って待機
タイムアウトまたはサービスエラー	既存操作を照会し、リクエスト追跡情報を保存

クライアント認証情報を更新する

適切なアカウント、用途、スコープを持つ新しい認証情報を発行します。
scout_capabilities と scout_mission_list で読み取りアクセスを検証します。
保護された X-API-Key 設定を更新し、クライアントを再接続します。
古い認証情報を失効し、新旧それぞれのアクセス結果を確認します。
認証情報のラベル、所有者、用途、更新日を記録します。

プラットフォーム MCP 認証情報とモデルプロバイダー認証情報は別々に管理します。漏えいや担当者変更が発生した場合は、顧客のセキュリティ手順に従ってアクセスを速やかに失効してください。

連携方法を選ぶ​

前提条件と入力情報​

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

認証情報の用途を割り当てる​

例：設備シグナルを調査する​

例：業務データの受領をレビューする​

REST API エンドポイント​

再試行とエラーを処理する​

クライアント認証情報を更新する​