connectwise-asio-mcp

Servidor MCP de ConnectWise Asio — expone las ConnectWise Platform APIs (la "API actual" detrás de ConnectWise Asio, anteriormente SolarWinds MSP/RMM adyacente a N-central) como herramientas MCP.

Nota sobre el nombre: app.mspbots.ai llama a esta integración "ConnectWise Asio" (sys_integration.subject_code = CWASIO). Es un producto distinto de ConnectWise Command (Continuum), ConnectWise Manage (PSA) y ConnectWise Automate; cada uno tiene su propio servidor MCP en esta flota. La API subyacente se denomina oficialmente "ConnectWise Platform APIs" en su especificación OpenAPI (developer.connectwise.com — documento "REST API" en Products > ConnectWise Platform > Platform Vendors > APIs and Callbacks).

Descripción general

Este servidor implementa el Model Context Protocol (transporte Streamable HTTP/SSE) y envuelve las ConnectWise Platform APIs — 25 herramientas en 5 categorías (devices, companies_contacts, custom_fields, patching, automation), reducida a los 23 endpoints que MSPbots tiene realmente configurados más un CRUD central mínimo (ver la Lista de herramientas más abajo; originalmente una compilación de API completa con 107 operaciones en 24 categorías de tags). Sigue el Vendor MCP Service SOP de MSPbots: sin estado, sin credenciales almacenadas, autenticación por cabecera en cada solicitud.

La API subyacente se autentica mediante OAuth2 Client Credentials. Este servidor no realiza el intercambio de tokens por sí mismo — recibe un token de acceso bearer ya obtenido por solicitud (igual que otras integraciones con flujo OAuth, p. ej. Microsoft Graph, se gestionan en esta flota de MCP de MSPbots: el gateway genera/renueva el token a partir de client_id/client_secret/scope, y solo el token resultante llega a este servidor).

Related MCP server: mcp-connectwise-psa

Inicio rápido

Docker (recomendado)

docker compose up --build

El servidor se inicia en http://localhost:8080.

Local (uv)

uv sync
python -m connectwise_asio_mcp

Comprobación de salud

curl http://localhost:8080/health
# {"status": "ok"}

No se requiere ningún token para el endpoint de salud.

Parámetros de autorización (Autenticación)

Toda solicitud a /mcp debe incluir las siguientes cabeceras HTTP:

La ausencia de X-ConnectWise-Asio-Token devuelve 401 Unauthorized.

Variables de entorno

Endpoint MCP

POST http://localhost:8080/mcp

Conecte su cliente MCP con:

• Transporte: http (Streamable HTTP / SSE)

• Cabeceras: X-ConnectWise-Asio-Token: <access_token> (obligatoria), X-ConnectWise-Asio-Base-Url: <base_url> (opcional)

Lista de herramientas

25 herramientas, reducidas de una compilación original de API completa con 104 herramientas (2026-08-04). La configuración de integración almacenada por MSPbots para este proveedor llama a 23 endpoints en 6 categorías de recursos subyacentes (dispositivos/endpoints, empresas, sitios, campos personalizados, parcheado, automatización) — cada uno de esos 23 endpoints configurados (incluidas las variantes de ruta v1/v2 separadas, que aquí convergen en la misma herramienta) corresponde a una herramienta conservada más abajo, marcada con el nombre del endpoint que le corresponde. Todo lo demás de la compilación original de 104 herramientas (Tickets — la categoría más grande, con 24 herramientas; Política/Grupo de políticas/Paquete; Mapeo; Alertas e incidentes; Panel de copias de seguridad; Varios — 6 categorías, ~79 herramientas) se eliminó por no ser utilizado por MSPbots. Si más adelante se necesita alguna categoría eliminada, la especificación OpenAPI del proveedor (enlazada más abajo) sigue documentando sus operaciones exactas y se pueden volver a añadir de la misma manera en que se generaron las herramientas conservadas.

Brecha conocida arrastrada de la compilación original: MSPbots configuró dos endpoints — "ConnectWise Asio Suspension" (GET /v2/alerting/suspensions) y "ConnectWise Asio Suspension Details" (GET /v2/alerting/suspensions/{ruleid}) — que no tienen ninguna herramienta correspondiente en este servidor (la categoría alerting de la compilación original de 104 herramientas solo implementó operaciones de crear, actualizar, eliminar y publicar incidentes, nunca una lectura GET de suspensiones). Esto es anterior al recorte y no fue introducido por él; se señala aquí porque ahora es más visible con el menor número de herramientas. Ver Brechas conocidas más abajo.

Empresas y contactos (6)

Campos personalizados (6)

Dispositivos y endpoints (9)

Parcheo (3)

Automatización (1)

Ejemplo de prueba

Obtener una lista de empresas y luego sus sitios:

{
  "method": "tools/call",
  "params": { "name": "connectwise_asio_get_companies", "arguments": {} }
}

Equivalente curl contra el servidor en ejecución (endpoint MCP HTTP transmisible):

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "X-ConnectWise-Asio-Token: <access_token>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": { "name": "connectwise_asio_get_companies", "arguments": {} }
  }'

Una llamada parametrizada:

{
  "method": "tools/call",
  "params": {
    "name": "connectwise_asio_get_endpoint_cpu_usage",
    "arguments": { "endpoint_id": "abc-123" }
  }
}

Referencia de API

• Documentación oficial (ConnectWise Developer Network — requiere inicio de sesión): Products > ConnectWise Platform > Platform Vendors > APIs and Callbacks > REST API

• URLs base: NA https://openapi.service.itsupport247.net, EU https://openapi.service.euplatform.connectwise.com, AU https://openapi.service.auplatform.connectwise.com

Brechas conocidas / No verificado aún

• Reducido de 104 a 25 herramientas el 2026-08-04. La compilación original cubría la especificación completa de las APIs de ConnectWise Platform según una decisión de alcance anterior. Una decisión de alcance posterior la recortó a las categorías realmente utilizadas por MSPbots; consulte la sección Lista de herramientas anterior para ver el mapeo exacto de endpoint→herramienta y la lista completa de las 6 categorías eliminadas (~79 herramientas, incluida la categoría tickets de 24 herramientas, la más grande de la compilación original). Si se necesita una categoría eliminada más adelante, la especificación OpenAPI del proveedor (enlazada abajo) aún documenta sus operaciones exactas y se pueden volver a agregar de la misma manera que se generaron las herramientas conservadas.

• Los endpoints configurados por MSPbots "Suspension"/"Suspension Details" no tienen una herramienta correspondiente — esta brecha es anterior al recorte (la categoría alerting de la compilación original de 104 herramientas nunca implementó una operación de lectura GET-suspension, solo crear/actualizar/eliminar/post-incidente) y no fue introducida por él. Si realmente se necesitan datos de suspensión, esto debería agregarse desde la especificación OpenAPI del proveedor.

• Aún no se ha probado contra una cuenta real de ConnectWise Asio — solo se ha realizado verificación a nivel de protocolo (comprobación de salud, 401 con token faltante, tools/list que devuelve las 25 herramientas) hasta ahora.

• connectwise_asio_update_company_custom_fields y connectwise_asio_create_company toman un parámetro genérico body: dict en lugar de argumentos con nombre completamente aplanados — el docstring enumera los campos de nivel superior requeridos, pero las formas de los objetos anidados deben verificarse contra la API en vivo en el primer uso.