Nexo Agent Server

Plano de control MCP durable para conectar redes de agentes orquestadores bajo un mismo objetivo. Un corte de red no borra trabajo: los mensajes viven en un ledger, cada nodo conserva un cursor y confirma el procesamiento con ACK.

Capacidades

• MCP Streamable HTTP para Claude Code, Codex y clientes compatibles.
• Identidad criptográfica individual por orquestador.
• Objetivo central versionado y criterios de aceptación.
• Topología padre/hijo, heartbeat, capacidades, tarea y progreso.
• Mensajes ordenados, reintentos idempotentes y cambio de canal con drenaje.
• Tokens rotables; sólo se persiste su SHA-256.

Instalación rápida en Windows

Descarga el ZIP de la última release, extráelo y ejecuta:

Set-ExecutionPolicy -Scope Process Bypass
.\scripts\install-windows.ps1 -PublicUrl "https://nexo.tu-red.local"
.\scripts\new-network.ps1 -Project "mi-red" -Coordinator "coordinador" -Objective "Construir el producto acordado sin perder mensajes"

Guarda el token del coordinador. Para crear la identidad de la otra PC:

.\scripts\new-agent.ps1 -Project "mi-red" -Coordinator "coordinador" -Agent "claude-pc-2" -Parent "coordinador" -Capability code,test

Entrega ese token junto con la URL a la PC remota y usa Nexo Agent Client.

Prueba inmediata en una LAN aislada

En la PC servidor, reemplaza la IP por la propia:

.\scripts\install-windows.ps1 -PublicUrl "http://192.168.1.15:8765" -AllowInsecure
powershell -File "$env:LOCALAPPDATA\NexoAgentServer\start-nexo-server.ps1"

Permite el puerto TCP 8765 en Windows Firewall sólo para el perfil privado. En la PC de Claude usa el cliente con la misma URL terminada en /mcp y su token individual. Este modo envía el bearer sin cifrar; úsalo únicamente para validar la LAN y luego cambia a HTTPS.

Servidor seguro

nexo-server --db C:\Nexo\nexo.sqlite3 serve --host 127.0.0.1 --port 8765 --public-url https://nexo.tu-red.local --allowed-host nexo.tu-red.local

Publica 127.0.0.1:8765 detrás de Caddy/NGINX con TLS. El endpoint MCP es /mcp y el chequeo público es /healthz. Para una prueba temporal:

nexo-server --db .\nexo.sqlite3 serve --host 0.0.0.0 --port 8765 --public-url http://192.168.1.15:8765 --allowed-host 192.168.1.15:8765 --insecure-http

Flujo de un agente

1. nexo_report obtiene el objetivo vigente y renueva presencia.
2. nexo_read_messages recupera trabajo desde el cursor.
3. El agente procesa y responde con nexo_send_message.
4. Sólo entonces llama nexo_ack.
5. Tras una reconexión repite desde el cursor; la idempotencia evita duplicados.

Estado

Versión inicial 0.1.1. La API y la base pueden evolucionar antes de 1.0. Consulta SECURITY.md antes de exponer el servicio.

Copyright © 2026 Hernán De Souza. Sin una licencia adicional, se reservan todos los derechos.