OctoWatch DLP について
OctoWatch DLP MCPは、SecOpsチームや管理者がOctoWatch DLP Cloudのデータを自然言語で調べるための、ローカルで動作する読み取り専用サーバーです。リスク、活動、生産性、ディレクトリ情報を扱いますが、書き込みやスクリーンショット・動画のバイナリ取得には対応しません。
主な機能
- 01リスクと異常の検索
- 02アイドル時間と生産性の集計
- 03アプリ・サイト・勤怠の確認
- 04監視記録と語句の検索
- 05ユーザー・グループ・在席状況の確認
活用シーン
- 01ユーザーとルール別にDLPリスクを集計
- 02長時間アイドルの従業員を特定
- 03監視記録から機密語句を検索
MCP 対応
MCPサーバーはローカルで動作し、OctoWatch DLP Cloud APIに接続して読み取り専用ツールをクライアントに提供します。stdioとStreamable HTTPに対応しています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
uvx octowatch-mcpOCTOWATCH_API_BASECloud API host (serverBase). Default: public cloud.OCTOWATCH_EMAILConsole operator email. Demo default works for try-out.OCTOWATCH_PASSWORDシークレットConsole password. Use a least-privilege operator for real tenants.OCTOWATCH_TOOLSETSTool filter: all | core | console (console includes core).ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
22掲載時のツール一覧 · 2 週間前に更新
このツールにパラメーターはありません。
詳細
OctoWatch DLP MCP サーバー
PyPI パッケージ:octowatch-mcp · 製品:octowatchdlp.com(「OctoWatch」という名前の他の製品とは関係ありません)。
従業員モニタリングとデータ損失防止を行う OctoWatch DLP Cloud 用の読み取り専用モデルコンテキストプロトコル(MCP)サーバーです。Cursor、Claude、または VS Code に、リスク、アイドル時間、生産性、モニタリングについて自然な言葉で質問できます。
- 製品:octowatchdlp.com
- 製品ドキュメント:octowatchdlp.com/docs/
- Web コンソール:app.octowatchdlp.com
- アプリ内 API カタログ:app.octowatchdlp.com/api/
Python MCP SDK v2(MCPServer)。SecOps とマネージャー向けに構築された、OctoWatch コンソールのオープンソースの補完ツールです。
目次: ステータス · 掲載先 · 前提条件 · 質問例 · セキュリティ · 制限事項 · クイックスタート · アカウント · ツール · 設定 · ドキュメント · 貢献
ステータス
アルファ版(v0.5.1)。API とツールの形式は変更される可能性があります。本番環境の設定では PyPI のバージョンを固定してください。
ツールの失敗時には MCP の is_error(ToolError)が返されます。すべてのツールで read_only_hint が設定されています。
どこで見つけられるか
MCP はローカルで実行されます(ExtrLabs がホストする MCP はありません)。カタログは PyPI / GitHub を参照します。Cloud へのログイン情報は環境変数で指定してください。
| チャネル | リンク |
|---|---|
| PyPI | octowatch-mcp |
| Official MCP Registry | io.github.extralabs/octowatch-mcp |
| GitHub | extralabs/octowatch-mcp-server |
| Cursor Marketplace | プラグインのマニフェスト .cursor-plugin — 公開フォーム(手動審査) |
| ディレクトリ | Glama · mcpservers.org · mcpfind.org · mcpmarket.com · PulseMCP · awesome-mcp-servers#13003(mcp.so は有料のため見送り) |
| cursor.directory | Open Plugins:ルートの .mcp.json + .cursor-plugin/plugin.json — これらが main に追加された後、再申請してください |
ディレクトリ / Marketplace の管理者向けメモ:docs/distribution.md。
前提条件
- Python 3.10+
- MCP 対応のホスト(Cursor、Claude Desktop、VS Code、…)
- Cloud API ホストへのネットワークアクセス(デフォルトは
https://cloud.octowatchdlp.com)
質問の例
- 「過去 1 日間の リスク は?」
- 「昨日、最も長くアイドル状態だったのは誰ですか?」
- 「Accounting の生産性の概要を教えてください」
- 「Emily の Monitoring のキーストロークを表示してください」
- 「先週のモニタリング全体からキーワード
invoiceを検索してください」 - 「ユーザーとグループを一覧表示してください」
簡単なシナリオ
| 目的 | 質問の例 |
|---|---|
| DLP / ポリシー違反 | 「今日のリスクをユーザーとルール別にまとめてください」 |
| アイドル時間(正式なアラートではありません) | 「昨日、2 時間以上アイドル状態だったのは誰ですか?」 |
| 上位のアプリ / サイト | 「過去 7 日間のグループ Accounting の上位アプリケーションを教えてください」 |
| キーワード検索 | 「過去 30 日間のモニタリングから confidential を検索してください」 |
| ディレクトリ | 「ユーザーとグループを一覧表示し、次に AliasID 4 の情報を表示してください」 |
セキュリティとプライバシー
デフォルトでは、公開されている demo アカウントを使用します。
本番環境のパスワードを MCP の設定や git に含めないでください。 環境変数を使用し、最小権限のコンソールオペレーターを利用してください。
書き込み機能はなく、スクリーンショット / 動画のバイナリダウンロードもありません。
モニタリングの応答には、従業員の機密データ(アクティビティ、キーストロークの抜粋、メールのメタデータ)が含まれる場合があります。ツールの出力は機密情報として取り扱ってください。ポリシー全文:SECURITY.md。
制限事項
- 読み取り専用 — コンソールの完全な代替ではありません(Web Console)
- スクリーンショット / 動画のバイナリダウンロードには対応していません(メタデータのみをストリーミング)
- 製品ドキュメントや REST カタログのミラーではありません — それらは引き続き docs と /api/ にあります
- アルファ版 — 1.0 まではマイナーバージョン間でも互換性のない変更が予想されます
クイックスタート(PyPI)
この README の上部にある Install バッジを使用してください(Cursor / VS Code、デモ用認証情報)。まず、CLI が利用可能であることを確認します。
pip install octowatch-mcp
または手動で設定します — Cursor / Claude 形式の mcpServers の例(デモ用認証情報):
{
"mcpServers": {
"octowatch": {
"command": "octowatch-mcp",
"env": {
"OCTOWATCH_API_BASE": "https://cloud.octowatchdlp.com",
"OCTOWATCH_EMAIL": "[email protected]",
"OCTOWATCH_PASSWORD": "demo"
}
}
}
}
すぐに使えるファイル:examples/cursor-mcp-pypi.json、examples/claude-desktop-pypi.json。ホストごとの手順:docs/hosts.md。
ホストを再起動し、次のように試してください:「OctoWatch を使って、誰としてログインしているか教えてください」 または 「過去 1 週間のリスクを一覧表示してください」。
デモ用認証情報は .env なしで利用できます。共有デモテナントに負荷をかけないでください(過剰なエージェントのループは避けてください)。
ソースから実行
git clone https://github.com/extralabs/octowatch-mcp-server.git
cd octowatch-mcp-server
python -m venv .venv
# Windows: .venv\Scripts\activate
# macOS/Linux: source .venv/bin/activate
pip install -e .
cp .env.example .env # optional
python -m octowatch_mcp
examples/cursor-mcp.json / examples/claude-desktop.json を使用し、cwd にクローン先のパスを設定してください(Windows の場合:D:\\path\\to\\octowatch-mcp-server)。
ChatGPT およびその他のホスト
現時点では、提供している単一の公開 ChatGPT JSON 設定はありません。ChatGPT などの製品では、ローカルの command stdio プロセスではなく、リモート MCP コネクターがよく使われます。
- ローカルのデスクトップエージェントには、上記の例を使って Cursor、Claude Desktop、または VS Code を使用することをおすすめします。
- ホストが HTTP 経由のカスタム MCP に対応している場合は、
octowatch-mcp --transport streamable-http(デフォルトでは localhost のみ)を実行し、ホストのドキュメントに従ってそのエンドポイントを登録できます。docs/hosts.md を参照してください。
アカウント(メールアドレス/パスワード)
OctoWatch Cloud へのログインには、引き続きコンソールへのログインが必要です。MCP はパスワードを保存しません。ホストからプロセス環境変数として渡してください。
| モード | 設定する内容 |
|---|---|
| デモ(お試し) | デフォルト/インストールバッジ:[email protected] / demo |
| ご自身のテナント | MCP の env(または Cursor プラグインの設定)に、ご自身の最小権限のオペレーターのメールアドレスとパスワードを設定します |
| 変数 | 意味 |
|---|---|
OCTOWATCH_EMAIL | コンソールのオペレーターのメールアドレス |
OCTOWATCH_PASSWORD | コンソールのパスワード(レジストリのメタデータでは isSecret) |
OCTOWATCH_API_BASE | デフォルトのパブリッククラウドを使用しない場合の Cloud API ホスト |
おすすめ: MCP ホストの JSON env ブロックに設定してください。examples/cursor-mcp-pypi-with-env.json / examples/claude-desktop-pypi-with-env.json。Cursor プラグインの変数については、.cursor-plugin/plugin.json を参照してください。
ソースからインストールする場合は、代わりに、プロセスの作業ディレクトリと同じ場所に .env.example をコピーして .env を作成してください。
実際のパスワードをコミットしないでください。Web Console で同じデータを確認してください。手順については、docs/hosts.md を参照してください。
コアツール
| ツール | Cloud 領域 | 備考 |
|---|---|---|
octowatch_whoami | 認証セッション | アカウント/ホスト(パスワードなし) |
list_users_groups | ディレクトリツリー | タイプ 0 はルート、1 はグループ、2 はユーザー |
list_risks | リスク + アナリティクス | デフォルトは mode=summary |
list_anomalies | アラート | 正式な逸脱(アイドル状態ではありません) |
get_idle_summary | 生産性 | InactiveTime 順にランク付け |
get_activity_summary | アクティビティ | 上位のアプリ/サイト |
get_timesheet | TimeSheet | 実労働時間と予定時間 |
get_productivity_summary | 生産性 + アナリティクス | ユーザーごとの集計 |
list_reports | レポート | スケジュール済みタスク + 処理中のタスク |
コンソール対応ツール
| ツール | Cloud 領域 | 備考 |
|---|---|---|
get_analytics | アナリティクス | view=overall|disciplina|activity|productivity |
get_dashboard | ダッシュボード | ウィジェット。blob は除外されます |
get_chrono | Chrono | タイムライン |
get_day_structure | 日の構成 | list または detail |
list_monitoring | モニタリング | 1 種類。デフォルトでは簡潔な形式 |
search_monitoring | ツール → 検索 | 種類をまたいだ filter_key |
get_activity_detail | アクティビティ期間 | 詳細表示 |
list_online | ライブ | プレゼンスのみ |
list_stream_meta | ストリーム | メタデータのみ |
list_directory | Edit Get* | ユーザー/グループ/コンピューターなど |
get_user_info | ユーザーカード | AliasID/コンピューター |
get_account_readonly | Account Get* | Set*/PIN なし |
list_api_coverage | (静的) | ギャップの概要 |
引数、ルーティング、シナリオの詳細については、docs/TOOLS.md を参照してください。
MCP のプロンプト/リソースについては、docs/MCP.md を参照してください。
設定
| 環境変数 | デフォルト | 意味 |
|---|---|---|
OCTOWATCH_API_BASE | https://cloud.octowatchdlp.com | API ホスト(serverBase) |
OCTOWATCH_EMAIL | [email protected] | コンソールのオペレーター |
OCTOWATCH_PASSWORD | demo | デフォルトではデモ専用 |
OCTOWATCH_DEFAULT_DAYS | 1 | ツールで日付/期間を省略した場合の遡及日数 |
OCTOWATCH_TOOLSETS | all | all | core | console(console には core が含まれます) |
octowatch-mcp # stdio (default)
octowatch-mcp --transport streamable-http # http://127.0.0.1:8000/mcp
期間とフィルター
period=today|yesterday|last_7_days|last_30_days、または date_from / date_to を使用してください。
- 日付のみの値は、暦日の全期間を対象とします(
date_to→23:59:59)。 - ほとんどの読み取りツールで、オプションの
user_id(AliasID)とgroup_idを指定できます。 - POST ボディの
TreeviewUsers:すべて →NodeType=-666666、グループ →NodeType=14、ユーザー →NodeType=1。
ドキュメント
| ドキュメント | 内容 |
|---|---|
| docs/README.md | ドキュメントの目次 |
| docs/hosts.md | ホスト別のインストールとログイン方法 |
| docs/TOOLS.md | ツールのリファレンスと使い分け |
| docs/MCP.md | プロトコル、リソース、プロンプト |
| docs/API.md | MCP のカバー範囲の監査(REST API 全体のミラーではありません) |
| docs/troubleshooting.md | よくあるエラー |
| docs/registry.md | 公式 MCP Registry(server.json) |
| docs/distribution.md | ディレクトリ、Marketplace、提供を延期しているホスト型チャネル |
製品とコンソール
ロードマップ
計画中(実施時期未定):ペイロード予算の最適化、クライアント側のレート制限、引数の補完、サーバーアイコン、オプションの MCP Apps UI、ツールルーティングの評価。Registry のメタデータ:docs/registry.md。プロトコルの範囲:docs/MCP.md。
コントリビューション
CONTRIBUTING.md を参照してください。変更履歴:CHANGELOG.md。課題:GitHub Issues。
ライセンス
MIT — LICENSE を参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。