# MCP Orchestrator + Serena remoto — estudio de migración

## Objetivo
- Montar Serena remoto en `.16` como servicio de referencia.
- Gestionar conexiones MCP desde `cursor-mobile-bridge` con panel dedicado.
- Catalogar servidores MCP de `mcp.so` y generar perfiles de conexión.
- Preparar migración a otro Windows 11 + Docker con backup/restauración.

## Qué sí y qué no
- **Sí**: perfiles de conexión, inventario, snippets, auditoría, health checks, migración de configs y snapshots.
- **No**: start/stop/admin universal de servidores de terceros sin API propia. Para eso cada proveedor debe exponer su propia administración.

## Requisitos de sistema
- Windows 11 Pro
- CPU 4+ cores, recomendado 8+
- RAM mínima 16 GB, recomendado 32 GB
- SSD con 100+ GB libres
- Node.js 20 LTS o superior
- Python 3.13 + `uv`
- Docker Desktop con WSL2 o backend compatible
- Git, Tailscale, VS Code 1.101+

## Dependencias base
- `cursor-mobile-bridge`
- `Serena` (`uv tool install -p 3.13 serena-agent`)
- Docker Desktop
- Node.js runtime para bridge/panel
- Ollama si el flujo local lo requiere
- Tailscale para acceso remoto seguro

## Docker
- Red recomendada: una red bridge privada por stack.
- Volúmenes: separar datos, logs, secretos y cache.
- Contenedores típicos: bridge, Serena, utilidades MCP, bases de datos auxiliares.
- Mantener secretos fuera de imágenes; usar `.env` o secret store.

## Migración
1. Exportar configuración del bridge y del workspace.
2. Exportar perfiles MCP y listados curados.
3. Copiar `.serena/memories` y `project.yml` por proyecto.
4. Copiar logs útiles y snapshots de health.
5. Restaurar runtimes y Docker.
6. Levantar Serena remoto y validar endpoints.
7. Reindexar / rehidratación de catálogos y RAG.

## Validación
- Health del bridge.
- Health Serena remoto.
- Directory checks de `mcp.so`.
- Validación de snippets de conexión para clientes.
- Smoke tests de panel y rutas.
- Verificación de permisos y tokens.

## Soporte / operación
- Mantener inventario de servidores MCP en un JSON versionado.
- Registrar cambios de configuración y auditoría local.
- Usar backups antes de actualizar paneles o runtimes.
- Aplicar actualización automática por capas: bridge, panel, runtime, configs.

## Estructura funcional actual
- `MCP Lab`: panel dedicado en `cursor-mobile-bridge`
- `Serena remoto .16`: modelado y preparado para despliegue
- `mcp.so`: directorio consumido para discovery y catálogo
- `migrations`: snapshot de entorno y plan de restauración

## Siguiente paso recomendado
- Desplegar Serena como servicio dedicado en `.16` con health propio.
- Añadir perfiles editables y exportables para MCP clients.
- Conectar permisos, auditoría y notificaciones por servidor.