🚀 Fleet MCP
Fleet MCPは、AIアシスタントがFleet Device Managementと対話して、デバイス管理、セキュリティ監視、コンプライアンス強制を行うためのModel Context Protocol (MCP)サーバーです。
🚀 クイックスタート
すぐに始めたいですか？これにより、読み取り専用アクセスとSELECTクエリ実行が有効になったfleet-mcpがセットアップされます。FLEET_SERVER_URLとFLEET_API_TOKENを自分のものに置き換えてください。
{
"mcpServers": {
"fleet": {
"command": "uvx",
"args": ["fleet-mcp", "run"],
"env": {
"FLEET_SERVER_URL": "https://your-fleet-instance.com",
"FLEET_API_TOKEN": "your-api-token",
"FLEET_READONLY": "true",
"FLEET_ALLOW_SELECT_QUERIES": "true"
}
}
}
}
詳細なツールのリストについては、以下の利用可能なツールセクションを参照してください。
✨ 主な機能
- ホスト管理：フリート全体のホストをリスト表示、検索、クエリ実行、管理します。
- ライブクエリ実行：ホストに対してosqueryクエリをリアルタイムで実行します。
- ポリシー管理：コンプライアンスポリシーを作成、更新、監視します。
- ソフトウェアインベントリ：デバイス全体のソフトウェアインストールと脆弱性を追跡します。
- チームとユーザー管理：ホストとユーザーをチームに編成します。
- osqueryテーブルの探索：osqueryテーブルの動的な探索とドキュメント化を行います。
- 読み取り専用モード：オプションのSELECTのみのクエリ実行で安全に探索できます。
- アクティビティ監視：Fleetのアクティビティと監査ログを追跡します。
💻 使用例
基本的な使用法
"List all teams in Fleet"
高度な使用法
"Run a query to find all processes listening on port 80"
📦 インストール
MCPクライアントの構成
Fleet MCPは、さまざまなMCP互換クライアントと統合できます。以下は、人気のあるクライアントの構成例です。
前提条件
任意のMCPクライアントを構成する前に、以下が必要です。
uv（推奨）またはpipをインストールする：
curl -LsSf https://astral.sh/uv/install.sh | sh
pip install fleet-mcp
- Fleet APIトークン：FleetインスタンスからAPIトークンを生成します。
オプション1)
- Fleet UIにログインします。
- 「My account」→「Get API token」に移動します。
- トークンをコピーして構成で使用します。
オプション2)
fleetctlでAPI専用ユーザーを作成します。
fleetctl user create --name Fleet-MCP --email <email> --password <password> --role admin --api-only
注意：このAPIトークンとFleetインスタンスのURL (https://your-fleet-instance.com) は、クライアントの構成で使用されます。
- クライアントを選択する：好みのAIアシスタントクライアントを選択し、以下の対応するセットアップ手順に従ってください。
Claude Desktopにインストールする
構成ファイルの場所
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：
%APPDATA%\Claude\claude_desktop_config.json
- Linux：
~/.config/Claude/claude_desktop_config.json
構成
{
"mcpServers": {
"fleet": {
"command": "uvx",
"args": ["fleet-mcp", "run"],
"env": {
"FLEET_SERVER_URL": "https://your-fleet-instance.com",
"FLEET_API_TOKEN": "your-api-token",
"FLEET_READONLY": "true",
"FLEET_ALLOW_SELECT_QUERIES": "true"
}
}
}
}
注意：パッケージをグローバルにインストールした場合は、uvxをfleet-mcpに置き換えてください。セキュリティを強化するには、--configフラグを使用してTOMLファイルを参照し、トークンを埋め込まないでください（セキュリティのベストプラクティスを参照）。
Cursorにインストールする
「Settings」→「Cursor Settings」→「MCP」→「Add new global MCP server」に移動します。
~/.cursor/mcp.jsonにグローバルにインストールするか、プロジェクトごとに.cursor/mcp.jsonにインストールします。詳細については、Cursor MCP docsを参照してください。
{
"mcpServers": {
"fleet": {
"command": "uvx",
"args": ["fleet-mcp", "run"],
"env": {
"FLEET_SERVER_URL": "https://your-fleet-instance.com",
"FLEET_API_TOKEN": "your-api-token",
"FLEET_READONLY": "true",
"FLEET_ALLOW_SELECT_QUERIES": "true"
}
}
}
}
Cline (VS Code拡張機能)にインストールする
構成の場所：~/.cline/mcp_settings.json (macOS/Linux) または %USERPROFILE%\.cline\mcp_settings.json (Windows)
または、VS Codeの設定で「Cline: MCP Settings」を検索し、JSONを編集します。
{
"mcpServers": {
"fleet": {
"command": "uvx",
"args": ["fleet-mcp", "run"],
"env": {
"FLEET_SERVER_URL": "https://your-fleet-instance.com",
"FLEET_API_TOKEN": "your-api-token",
"FLEET_READONLY": "true",
"FLEET_ALLOW_SELECT_QUERIES": "true"
}
}
}
}
Continue (VS Code拡張機能)にインストールする
構成の場所：~/.continue/config.json
{
"mcpServers": [
{
"name": "fleet",
"command": "uvx",
"args": ["fleet-mcp", "run"],
"env": {
"FLEET_SERVER_URL": "https://your-fleet-instance.com",
"FLEET_API_TOKEN": "your-api-token",
"FLEET_READONLY": "true",
"FLEET_ALLOW_SELECT_QUERIES": "true"
}
}
]
}
Zed Editorにインストールする
構成の場所：~/.config/zed/settings.json (macOS/Linux) または %APPDATA%\Zed\settings.json (Windows)
{
"context_servers": {
"fleet": {
"command": {
"path": "uvx",
"args": ["fleet-mcp", "run"]
},
"settings": {
"env": {
"FLEET_SERVER_URL": "https://your-fleet-instance.com",
"FLEET_API_TOKEN": "your-api-token",
"FLEET_READONLY": "true",
"FLEET_ALLOW_SELECT_QUERIES": "true"
}
}
}
}
}
Windsurfにインストールする
詳細については、Windsurf MCP docsを参照してください。
{
"mcpServers": {
"fleet": {
"command": "uvx",
"args": ["fleet-mcp", "run"],
"env": {
"FLEET_SERVER_URL": "https://your-fleet-instance.com",
"FLEET_API_TOKEN": "your-api-token",
"FLEET_READONLY": "true",
"FLEET_ALLOW_SELECT_QUERIES": "true"
}
}
}
}
VS Codeにインストールする
詳細については、VS Code MCP docsを参照してください。
"mcp": {
"servers": {
"fleet": {
"type": "stdio",
"command": "uvx",
"args": ["fleet-mcp", "run"],
"env": {
"FLEET_SERVER_URL": "https://your-fleet-instance.com",
"FLEET_API_TOKEN": "your-api-token",
"FLEET_READONLY": "true",
"FLEET_ALLOW_SELECT_QUERIES": "true"
}
}
}
}
Sourcegraph Codyにインストールする
構成の場所：~/Library/Application Support/Cody/mcp_settings.json (macOS)、%APPDATA%\Cody\mcp_settings.json (Windows)、または ~/.config/Cody/mcp_settings.json (Linux)
{
"mcpServers": {
"fleet": {
"command": "uvx",
"args": ["fleet-mcp", "run"],
"env": {
"FLEET_SERVER_URL": "https://your-fleet-instance.com",
"FLEET_API_TOKEN": "your-api-token",
"FLEET_READONLY": "true",
"FLEET_ALLOW_SELECT_QUERIES": "true"
}
}
}
}
Augment Codeにインストールする
UIを使用する場合：ハンバーガーメニュー → 設定 → ツール → + MCPを追加 → uvx fleet-mcp run を入力 → 名前: "Fleet" → 追加
手動で構成する場合：設定 → 詳細設定 → settings.jsonを編集
"augment.advanced": {
"mcpServers": [
{
"name": "fleet",
"command": "uvx",
"args": ["fleet-mcp", "run"],
"env": {
"FLEET_SERVER_URL": "https://your-fleet-instance.com",
"FLEET_API_TOKEN": "your-api-token",
"FLEET_READONLY": "true",
"FLEET_ALLOW_SELECT_QUERIES": "true"
}
}
]
}
LM Studioにインストールする
「Program」→「Install」→「Edit mcp.json」に移動します。詳細については、LM Studio MCP Supportを参照してください。
{
"mcpServers": {
"fleet": {
"command": "uvx",
"args": ["fleet-mcp", "run"],
"env": {
"FLEET_SERVER_URL": "https://your-fleet-instance.com",
"FLEET_API_TOKEN": "your-api-token",
"FLEET_READONLY": "true",
"FLEET_ALLOW_SELECT_QUERIES": "true"
}
}
}
}
汎用MCPクライアントの構成
他のMCP互換クライアントの場合は、この一般的なパターンを使用します。
{
"mcpServers": {
"fleet": {
"command": "uvx",
"args": ["fleet-mcp", "run"],
"env": {
"FLEET_SERVER_URL": "https://your-fleet-instance.com",
"FLEET_API_TOKEN": "your-api-token",
"FLEET_READONLY": "true",
"FLEET_ALLOW_SELECT_QUERIES": "true"
}
}
}
}
%20--%3e%3cdefs%3e%3cstyle%3e%20.st0%20{%20fill:%20%23061b40;%20}%20.st1%20{%20fill:%20%23306af1;%20}%20.st2%20{%20fill:%20%235ce5cf;%20}%20%3c/style%3e%3c/defs%3e%3cg%3e%3cpath%20class='st0'%20d='M55,10.5h9v3h-9v9h12V7.5h-12v3ZM64,19.5h-6v-3h6v3Z'/%3e%3cpolygon%20class='st0'%20points='69%2016.5%2078%2016.5%2078%2019.5%2069%2019.5%2069%2022.5%2081%2022.5%2081%2013.5%2072%2013.5%2072%2010.5%2081%2010.5%2081%207.5%2069%207.5%2069%2016.5'/%3e%3cpolygon%20class='st0'%20points='95%2010.5%2095%207.5%2083%207.5%2083%2022.5%2095%2022.5%2095%2019.5%2086%2019.5%2086%2016.5%2095%2016.5%2095%2013.5%2086%2013.5%2086%2010.5%2095%2010.5'/%3e%3cpath%20class='st0'%20d='M40,1.5v21h11.6l1.4-1.4v-7.6h0c0,0-1.4-1.5-1.4-1.5l1.4-1.4V2.9l-1.4-1.4h-11.6ZM50,19.5h-7v-6h7v6ZM50,10.5h-7v-6h7v6Z'/%3e%3c/g%3e%3cpath%20class='st1'%20d='M23.1,24L14.7,4.8l-4.9,11.2h3.8l-1.8,4H3.3L12.1,0H2C.9,0,0,.9,0,2v20c0,1.1.9,2,2,2h21.1Z'/%3e%3cpath%20class='st2'%20d='M34,0h-16.8l10.6,24h6.2c1.1,0,2-.9,2-2V2C36,.9,35.1,0,34,0ZM32.5,20h-4V4h4v16Z'/%3e%3c/svg%3e)
