ACMP MCP Server

[!NOTE] English: MCP server for Aagon ACMP's Public API, with a built-in four-eyes approval gate for write/execute/delete actions. Runs as a single Windows EXE on the ACMP server and works with any MCP client. Docs are in German because ACMP's user base is mostly DACH; issues in English are welcome.

Un servidor MCP para la API pública de ACMP (Aagon Client Management Platform). Haces preguntas en lenguaje natural, por ejemplo: „¿Qué equipos llevan más de 30 días sin conexión?“, y la IA obtiene la respuesta directamente de ACMP.

De un vistazo

• Cualquier cliente MCP: Claude, ChatGPT/Codex, GitHub Copilot, Gemini, Cursor …
• Amplia cobertura: Clientes, contenedores, trabajos/comandos de cliente, tickets, activos, inventario, vulnerabilidades y datos maestros.
• Aprobación de cuatro ojos: Leer se ejecuta de inmediato. Todo lo que modifica, ejecuta o elimina algo solo se ejecuta cuando una persona lo aprueba en la página de aprobación; en acciones críticas, dos personas distintas.
• Por operador: clave de API propia y, opcionalmente, identidad ACMP propia. ACMP verifica entonces los permisos reales de la persona.
• Un solo EXE, sin nube: se ejecuta directamente en el servidor ACMP. Sin IIS, sin SDK de .NET.
• Opcional: crear, aprobar y clasificar comandos de cliente, así como mantener el kiosco, directamente en la base de datos de ACMP. Desactivado por defecto.
• Plantillas listas: En la ACMP CTL (Community Template Library) hay plantillas de comandos de cliente con cada paso en texto plano. acmp_lib_install las crea como borrador en tu consola.

Compatibilidad

Inicio rápido

A) Configurar desde tu IA

En el servidor ACMP, clona el repositorio o descomprímelo como ZIP. Inicia allí un agente de IA que pueda ejecutar comandos (Claude Code, Codex CLI, GitHub Copilot en modo agente, Gemini CLI, Cursor o similar) e introduce:

Richte diesen ACMP-MCP-Server auf diesem Rechner ein. Folge AGENTS.md Schritt für Schritt,
erkläre mir jeden Admin-Schritt, bevor ich ihn ausführe, und frag mich nie nach Passwörtern
oder API-Keys im Chat.

AGENTS.md contiene el proceso completo: verificación, instalación, configuración inicial, habilitación en la red local, conexión de clientes y resolución de problemas. La mayoría de los agentes leen el archivo por sí mismos. Para Claude Code (CLAUDE.md), Gemini CLI (GEMINI.md) y GitHub Copilot (.github/copilot-instructions.md) se incluyen referencias.

B) Manualmente: el asistente en la terminal

Abre PowerShell en el servidor ACMP, cambia al repositorio e inicia. Si faltan derechos de administrador, el script se reinicia solo tras una consulta de Windows (UAC):

.\install.ps1

Al final, el asistente muestra tu clave de API y los enlaces a la página de aprobación, al panel de control y a la incorporación; si lo deseas, copia la clave al portapapeles. Después pregunta por tu cliente de IA y muestra la configuración lista para él.

cd C:\ProgramData\AcmpMcp
.\add-user.ps1

Conectar cliente

Cualquier cliente MCP que admita Streamable HTTP con cabecera propia se conecta directamente:

Por ejemplo, Claude Code:

claude mcp add --transport http acmp http://<HOST>:8765/ --header "Authorization: Bearer <KEY>" --scope user

Claude Desktop: instala acmp-mcp-<version>.mcpb desde las versiones con doble clic; luego introduce la dirección del servidor y la clave de API en la configuración de la extensión.

Configuraciones listas para todos los clientes habituales están en docs/CLIENTS.md. Los clientes que solo admiten servidores locales (stdio) se conectan mediante el puente mcp-remote.

Funcionamiento

flowchart TB
    KI["KI-Client<br/>Claude · Codex · Copilot · Gemini · Cursor"]
    subgraph SRV["ACMP-Server"]
        MCP["ACMP-MCP-Server<br/>(Windows-EXE)"]
        GATE{{"Freigabe-Seite"}}
        ACMP[("ACMP<br/>Public API über SICS/AESB")]
        DB[("ACMP-Datenbank")]
    end
    TEAM(["Freigeber im Browser"])
    KI -->|"MCP · HTTP + API-Key"| MCP
    MCP -->|"lesen: sofort"| ACMP
    MCP -->|"schreiben · ausführen · löschen"| GATE
    TEAM -->|"1 bzw. 2 Personen stimmen zu"| GATE
    GATE -->|"erst dann"| ACMP
    MCP -.->|"optional: DB-Reports, Writer"| DB

Así se ve la aprobación

Si la IA solicita un comando de escritura, ejecución o eliminación, llega como solicitud a la página de aprobación. No se ejecuta nada hasta que hayan aprobado suficientes personas distintas. Las imágenes muestran una instancia de demostración con datos ficticios.

Un ejemplo del proceso:

1. Escribes: „En PC-0815 el disco está lleno, limpia la carpeta temporal de Windows.“
2. La IA busca el equipo (acmp_get_client_id), verifica las unidades (acmp_low_disk_space) y presenta una solicitud de PowerShell (acmp_run_powershell).
3. En la página de aprobación, dos colegas ven el script en texto plano y hacen clic en „Aprobar“.
4. Solo entonces se ejecuta el script en el cliente y la IA informa del resultado.

Herramientas

118 herramientas en 10 áreas. Un clic en un área muestra todas las herramientas con su nivel de aprobación:

🟢 se ejecuta de inmediato (solo lectura) · 🟡 aprobación por 1 persona · 🔴 aprobación por 2 personas distintas

Los niveles son los valores estándar del código y se pueden ajustar por herramienta en /settings. Algunas herramientas requieren una función opcional: (DB) la conexión a la base de datos (db.connectionString, solo lectura), (PS) la plantilla de comando de cliente (runPowershell.clientCommandId), (CW) el CC-Writer (ccWriter), (KW) el Kiosk-Writer (kioskWriter). La lista actual la proporciona tools/list. Cada herramienta acepta opcionalmente format: "json".

Los prompts de ejemplo están en docs/USAGE.md. Los nuevos comandos nativos se añaden de forma declarativa en api-tools.json, los nuevos informes SQL en db-tools.json. Ambos no requieren recompilación.

Interfaz web

El inicio de sesión se realiza mediante un token propio por aprobador y es independiente de la clave de ACMP o MCP: una clave API filtrada no otorga, por tanto, derechos de aprobación.

Configuración

config.example.json está comentado (campos _hinweis). install.ps1 genera a partir de ello config.local.json.

Seguridad

[!WARNING] El servidor concede acceso completo a ACMP, incluida la ejecución de comandos en todos los dispositivos finales. Trata cada clave API como una contraseña de administrador.

• Sin TLS integrado. El servidor escucha por defecto solo en 127.0.0.1 y rechaza la operación en LAN sin API-Key. En la LAN, restringís los subredes de origen mediante el firewall. A través de límites de red, se coloca un proxy TLS o VPN delante.
• install.ps1 restringe la carpeta de instalación a administradores y SYSTEM, porque allí se almacenan las credenciales de acceso.
• Las contraseñas de los operadores nunca se guardan: acmp-token-setup.exe solo almacena un token cifrado con DPAPI (LocalMachine).
• /regresult (canal de retorno para acmp_read_registry) es accesible deliberadamente sin clave, porque el cliente no conoce la clave. Solo acepta resultados para tokens abiertos que no se pueden adivinar.
• Por favor, no informes vulnerabilidades de seguridad como un issue público, sino como se describe en SECURITY.md.

Documentación

Participar

Los issues y pull requests son bienvenidos. Por favor, en los issues no publiques logs con nombres de host, IPs, nombres de usuario, claves o tokens, sino que enmascáralos antes.

Licencia

MIT. No es un producto oficial de Aagon GmbH. ACMP y AESB son marcas de Aagon GmbH.