Nexian MCP Hub

Nexian MCP Hub es una plataforma de integración MSP multiinquilino que permite a cada inquilino conectar sistemas de terceros y exponer herramientas normalizadas y seguras para IA a través de un único servidor MCP remoto.

Estructura del monorepo

• apps/web: Aplicación de administración y usuario final en Next.js

• apps/api: API de backend para autenticación, gestión de inquilinos, conectores, devoluciones de llamada OAuth y API de auditoría

• apps/mcp: Servidor MCP remoto con puntos finales HTTP protegidos por token de portador (bearer token)

• packages/core: Tipos de dominio compartidos, primitivas de seguridad, modelos MCP, ayudantes de validación

• packages/connectors: Adaptadores de proveedores e implementaciones de herramientas normalizadas

• prisma: Esquema de Postgres y modelos listos para inicialización (seed)

• docker: Activos de contenedor locales

• docs: Notas sobre arquitectura, despliegue y seguridad

Configuración local

1. Instala Node.js 22+ y pnpm.

2. Copia .env.example a .env y rellena las credenciales del proveedor.

3. Inicia la infraestructura:

docker compose up -d

4. Instala las dependencias:

pnpm install

5. Genera el cliente Prisma y ejecuta las migraciones:

pnpm db:generate
pnpm db:migrate

6. Inicia la pila:

pnpm dev

Despliegue en Vercel

Despliega la aplicación Next.js apps/web como el proyecto de Vercel.

Configuración recomendada para Vercel:

• Directorio raíz: apps/web

• Comando de instalación: pnpm install

• Comando de compilación: pnpm build

• Directorio de salida: dejar vacío para la autodetección de Next.js

Variables de entorno a configurar en Vercel:

• NEXT_PUBLIC_API_URL

• NEXT_PUBLIC_MCP_URL

• API_URL

• APP_URL

Este repositorio mantiene apps/api y apps/mcp como servicios de Node separados. Para producción, despliégalos en un host de contenedores y apunta el frontend de Vercel hacia ellos mediante variables de entorno.

Despliegue en Railway

Utiliza Railway para la división del backend:

• apps/api en Railway

• apps/mcp en Railway

• apps/web en Vercel

La guía de configuración práctica se encuentra en:

• docs/railway-vercel-deploy.md

Relaciones importantes de las variables de entorno en producción:

• APP_URL debe ser tu URL web de Vercel

• API_URL debe ser tu URL de API de Railway

• MCP_URL debe ser tu URL de MCP de Railway

• HALOPSA_REDIRECT_URI debe apuntar a la URL de devolución de llamada de la API de Railway

• NEXT_PUBLIC_API_URL en Vercel debe apuntar a la URL de la API de Railway

• NEXT_PUBLIC_MCP_URL en Vercel debe apuntar a la URL del punto final MCP de Railway

• SESSION_SECRET debe coincidir entre los servicios de API y MCP

Arquitectura del producto

• Los usuarios web se autentican en la plataforma y actúan dentro de un espacio de trabajo de inquilino.

• Las cuentas conectadas se almacenan por inquilino y usuario, con tokens de acceso y actualización cifrados en reposo.

• La API gestiona el manejo de devoluciones de llamada OAuth, la actualización de tokens, las comprobaciones de políticas, el registro de auditoría y el ciclo de vida del conector.

• El servidor MCP valida Authorization: Bearer <token> en cada solicitud HTTP y enruta cada llamada de herramienta a través de políticas conscientes del inquilino.

• La lógica específica del proveedor permanece dentro de los adaptadores; solo se exponen externamente herramientas normalizadas.

Alcance del conector de la versión 1

• HaloPSA

• Microsoft 365 / SharePoint

• HubSpot como CRM

• IT Glue como documentación / KB

Medidas de seguridad (Guardrails)

• Herramientas de solo lectura primero

• Escrituras seguras solo para flujos de trabajo de bajo riesgo, como la creación de borradores de tickets y notas internas

• Sin escrituras destructivas en la v1

• Todas las invocaciones de herramientas generan eventos de auditoría

Próximos hitos de implementación

1. Conectar la autenticación real y la persistencia en los esqueletos del módulo de API.

2. Añadir migraciones de Prisma y arranque del cliente de base de datos.

3. Reemplazar los marcadores de posición de los conectores con SDK de proveedores en vivo o integraciones REST.

4. Añadir pruebas de integración para OAuth, actualización de tokens y ejecución de herramientas MCP.