Lo que solicita ChatGPT
Descubre equipos, conoce las operaciones permitidas, solicita una tarea y consulta el resultado. No ejecuta comandos en el equipo.
Descargar colección de IA ↓GUÍA OPERATIVA · CLIENTE IA + MCP + AGENTES
De una pregunta en ChatGPT
a una respuesta del equipo.
Conoce las responsabilidades de cada componente, cómo se autoriza una operación y por dónde viajan las tareas y sus resultados. Incluye colecciones Postman independientes para reproducir el papel de cada actor.
Identidades separadasHTTPS saliente desde LinuxTareas asíncronasAuditoría y permisos
01 · COMPONENTES
¿Quién se comunica con quién?
El usuario conversa con la IA. La IA invoca las herramientas del MCP, que aplica las reglas de acceso y coordina la tarea. El agente consulta las tareas desde su equipo.
Usuario e IAUsuario solicita información; ChatGPT u otra IA decide qué operación consultar y procesa la respuesta.
MCP CCSMAPI MCP que recibe la solicitud, controla y persiste estado, devuelve identificadores y resultados.
Control de accionesVerifica usuario, equipo, operación activa, permisos y caducidad.
Agente LinuxConsulta periódicamente al MCP por HTTPS saliente y valida la operación localmente.
Equipo / servidorEjecuta la operación permitida; el resultado regresa mediante el agente al MCP.
Aclaración importante: en la versión actual el MCP no abre una conexión ni envía un push al computador. El agente instalado realiza POST /api/v1/agent/pull en intervalos regulares. La respuesta del MCP a ese sondeo es la «señal» con la tarea. Del mismo modo, la IA consulta get_bridge_task para recuperar el resultado; no existe un envío espontáneo del MCP a ChatGPT.
02 · SECUENCIA DE IDA Y VUELTA
Ejemplo: «¿Cómo está la memoria de mi servidor?»
Sigue la secuencia para identificar qué llamadas son de la IA y cuáles hace realmente el agente instalado.
Usuario→IAPregunta en ChatGPT. La IA interpreta cuál equipo desea consultar.
IA→MCPDescubrir equipos y acciones.
list_my_linux_servers y list_linux_commands.IA→MCPSolicitar tarea.
run_linux_command(system.memory) para el agent_id.MCP→Control y BDVerificar y guardar. Permisos y operación; crear tarea
queued con un task_id.MCP→IARespuesta inicial. Devuelve
task_id, todavía sin datos del equipo.Agente→MCPSondeo.
POST /api/v1/agent/pull; recibe 204 sin tarea, o 200 con tarea permitida.MCP→AgenteEntrega la tarea como respuesta HTTP al sondeo. Revalida permisos antes de asignarla.
Agente→EquipoEjecuta localmente. Verifica su lista de acciones permitidas; ejecuta
free -h sin shell.Equipo→AgenteTermina operación. Devuelve salida, errores y código de ejecución.
Agente→MCPEntrega resultado.
POST /api/v1/agent/tasks/{id}/result; MCP lo persiste.IA→MCPConsulta hasta finalizar.
get_bridge_task(task_id) retorna estado y salida final.IA→UsuarioRespuesta conversacional. Interpreta los datos de memoria y responde en ChatGPT.
Las peticiones de sondeo del agente y las consultas de estado de la IA pueden intercalarse. Todo resultado depende de que el agente esté instalado, activo y autorizado.
03 · AUTORIZACIÓN
Los controles que permiten o bloquean una tarea
| Plano | Qué valida | Credencial |
|---|---|---|
| Cliente IA | Identidad humana y permisos para ver equipos y solicitar acciones | user_token |
| MCP / Control de acciones | Operación global activa + equipo habilitado + operación asignada al equipo + usuario autorizado | Reglas en la base SQL |
| Agente Linux | ID de dispositivo, token propio, expiración y catálogo de comandos locales | agent_id + agent_token |
| Administrador | Alta y revocación de conexiones, operaciones, usuarios y tokens | Cuenta administrativa + admin_token en Postman |
04 · LABORATORIO
Colecciones Postman por responsabilidad
Cada colección representa a un actor distinto. Puedes importarlas separadamente y ejecutar el flujo de forma ordenada; no son intercambiables.
Lo que hace el agente instalado
Heartbeat, sondeo de tareas pendientes y envío del resultado. Postman simula estas peticiones, pero no ejecuta el programa Linux.
Descargar colección del agente ↓Lo que configura la institución
Registra equipos, administra operaciones, autoriza usuarios, habilita conexiones y rota credenciales.
Descargar colección administrativa ↓Estado público y seguridad
Comprueba la disponibilidad del MCP y rutas auxiliares, además de respuestas de rechazo cuando falta autorización.
Descargar colección de monitoreo ↓Importa también el entorno Postman local sin secretos. Las credenciales de IA, agente y administrador son independientes. Para consultar el diagrama de secuencia en GitHub, abre el documento técnico.
Persistencia de datos
El MCP guarda usuarios, equipos, permisos, tareas, resultados y auditoría en su base SQL. Para el laboratorio del PC PRINCIPAL se usa una base MySQL/MariaDB dedicada, independiente de las aplicaciones existentes. Una tarea en cola sigue registrada aunque ChatGPT cierre la conversación.
El equipo Linux y el navegador de ChatGPT no necesitan acceso directo a MySQL. La base solo la utiliza el servidor MCP, que controla el acceso y registra las operaciones.
05 · PRIMER SERVIDOR LINUX
Descubrimiento dinámico del MCP
El agente inicia la comunicación y localiza el MCP por su nombre DNS institucional. Primero consulta un manifiesto HTTPS sin token, luego realiza heartbeat y sondeo de tareas. No se necesita una IP fija por Linux; el firewall del piloto protege el segmento privado autorizado.
Ver descubrimiento y piloto Linux ↗