Servidor MCP para la API de MSPbots Fleet Platform: una consola multiinquilino sobre fleetdm: inventario de hosts, scripts bajo demanda y consultas osquery guardadas, expuestos a clientes MCP.
Sigue el mismo diseño que el servicio hermano mspbots-agent-mcp:
sin estado, sin credenciales almacenadas, autenticación por cabecera en cada petición a través del
Model Context Protocol (transporte Streamable HTTP/SSE).
Este MCP envuelve un producto interno de MSPbots (gestión de flotas de dispositivos), no una integración de terceros. Usos típicos:
"¿Qué hosts tiene este inquilino y cuáles están sin conexión?" →
mspbotsfleet_list_hosts
"Etiqueta este portátil como Producción" → mspbotsfleet_set_host_labels
"Esta máquina parece desactualizada, fuerza una actualización" → mspbotsfleet_refetch_host
"Ejecuta nuestro script de recopilación de registros en ese servidor" → mspbotsfleet_run_script
"¿Cuál es el uso de disco en todos los hosts Windows ahora mismo?" → crea una
consulta guardada con mspbotsfleet_create_query y luego
mspbotsfleet_run_query
"Acaba de inscribirse un lote de portátiles nuevos, reclama los que declaramos" →
mspbotsfleet_claim_hosts
"Vamos a dar de baja este dispositivo, deja de rastrearlo como nuestro (pero déjalo en
Fleet)" → mspbotsfleet_release_host
Related MCP server: OpsLevel MCP
Todas las herramientas obtienen las credenciales de las cabeceras de la petición (X-MSP-Token / X-MSP-Tenant-Id / X-MSP-Host);
no es necesario pasar el token en los parámetros de la herramienta.
Los hosts no se pueden crear a través de la API: aparecen automáticamente cuando la máquina instala fleetd y se registra,
y luego se reclama la propiedad según los identificadores declarados por el inquilino
(nombre de host/número de serie/UUID); ver mspbotsfleet_claim_hosts.
Herramienta | Función | Parámetros |
| Lista los hosts del inquilino actual (búsqueda difusa + filtro de estado + paginación) |
|
| Obtiene el detalle del host + etiquetas manuales |
|
| Lista los scripts ejecutables en ese host |
|
| Reemplaza por completo las etiquetas manuales del host |
|
| Solicita que el host actualice sus atributos en el próximo check-in (asíncrono) |
|
| Elimina el host de Fleet y libera la propiedad (si fleetd no está desinstalado, se volverá a registrar) |
|
| Declara identificadores y reclama los hosts sin propietario que coincidan (idempotente; se puede repetir para reintentar los no coincidentes) |
|
| Abandona la propiedad de un host por parte del inquilino actual, sin eliminar el host en sí (idempotente) |
|
La lista de hosts se obtiene completa y luego se filtra/ordena/ pagina en memoria; los datos de Fleet se cachean durante 15 segundos, la información de propiedad se consulta en la base de datos en tiempo real sin caché.
claim_hostsdevuelve{claimed, waiting, rejected}:waitingson los declarados pero que aún no aparecen en Fleet,rejectedson los identificadores que ya han sido declarados por otro inquilino.
Herramienta | Función | Parámetros |
| Lista los scripts del inquilino actual |
|
| Obtiene el detalle del script (incluido el contenido) |
|
| Crea un script (el nombre de archivo debe terminar en |
|
| Reemplaza el contenido del script (el nombre de archivo no se puede cambiar) |
|
| Elimina el script (afecta a todos los hosts) |
|
| Ejecuta el script en el host |
|
| Consulta el resultado de la ejecución ( |
|
create_script/update_scriptsolo devuelven{id, name}; el resto de campos, como las marcas de tiempo, requieren consultarmspbotsfleet_get_script/mspbotsfleet_list_scripts.
Herramienta | Función | Parámetros |
| Lista las consultas del inquilino actual |
|
| Obtiene el detalle de la consulta (incluido el SQL) |
|
| Crea una consulta guardada (solo se permite un único |
|
| Actualiza la consulta (parcial, solo envía los campos a modificar) |
|
| Elimina la consulta y sus datos de informes |
|
| Ejecuta la consulta en tiempo real en los hosts y espera el resultado (≤45s) |
|
Reglas de validación de SQL: solo se permite un único
SELECToWITH … SELECT; se elimina automáticamente el punto y coma final; si aparece;en el cuerpo, se rechaza directamente. Estas validaciones las realiza el backend; este servicio no las repite.
docker compose up --buildEl servidor se inicia en http://localhost:8080.
uv sync
python -m mspbots_fleet_mcpcurl http://localhost:8080/health
# {"status": "ok"}No se requieren credenciales para el endpoint de estado.
Cada petición a /mcp debe incluir las siguientes cabeceras HTTP (proporcionadas por el
llamante MCP, de forma coherente con mspbots-agent-mcp / ticketqa-mcp):
Cabecera | Tipo | ¿Obligatoria? | Descripción del campo | Ejemplo |
| string | Obligatoria | Credencial de acceso emitida por Fleet Platform (token de portador JWT). Este servicio la reenvía tal cual como |
|
| string | Obligatoria | Identificador del inquilino. Al reenviarse a la API descendente se renombra a la cabecera |
|
| string | Obligatoria | Host donde se encuentra la API de Fleet. |
|
Si falta cualquiera de las tres cabeceras, se devuelve 401 Unauthorized.
La API de Fleet descendente devuelve 403 para fallos de autenticación (token ausente/firma incorrecta/roles insuficientes), no 401; el 401 solo ocurre en esta capa de servicio (cabeceras de puerta de enlace ausentes).
Variable | Por defecto | Descripción |
|
| Puerto de escucha |
|
| Host de escucha |
POST http://localhost:8080/mcpConecta tu cliente MCP con:
Transporte: http (Streamable HTTP / SSE)
Cabeceras: X-MSP-Token, X-MSP-Tenant-Id, X-MSP-Host (todas obligatorias)
curl -X POST http://localhost:8080/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "X-MSP-Token: <token>" \
-H "X-MSP-Tenant-Id: <tenant-id>" \
-H "X-MSP-Host: https://agent.mspbots.ai" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": { "name": "mspbotsfleet_list_hosts", "arguments": { "status": "online", "per_page": 10 } }
}'⚠️ Este repositorio es público; no incluyas tokens reales, identificadores de inquilino ni otra información sensible en ningún archivo confirmado. Los
<token>/<tenant-id>anteriores son solo marcadores de posición.
This server cannot be deployed
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Host any HTTP API as a standard MCP server; auto-distribute to 12+ mainstream agent platforms.
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
