Integración Vercel
KuaDashboard proporciona un panel completo de gestión de Vercel accesible desde la pestaña del proveedor Vercel. Administra proyectos, deployments, dominios, variables de entorno y funciones serverless sin salir del dashboard.
Autenticación
Las credenciales de Vercel pueden configurarse de dos formas:
| Método | Descripción |
|---|---|
| API Token | Genera un token en vercel.com/account/tokens y almacénalo con el Env Manager (icono de llave) |
| OAuth (solo Electron) | Haz clic en Connect with Vercel en el diálogo de agregar conexión para autorizar desde el navegador — sin copiar y pegar tokens |
Usando un API Token
- Abre el Env Manager (icono de llave en la barra de herramientas)
- Haz clic en Add Connection y selecciona Vercel como proveedor
- Ingresa tu
VERCEL_API_TOKEN - Opcionalmente agrega un
VERCEL_TEAM_IDsi el token pertenece a una cuenta de equipo de Vercel (formato:team_XXXXXXXXXXXX) - Dale un nombre al perfil y guarda
Usando OAuth (solo app Electron)
- Haz clic en Add Connection y selecciona Vercel
- Haz clic en Connect with Vercel — se abre la página de autorización de Vercel en tu navegador predeterminado
- Autoriza KuaDashboard — Vercel redirige a la página HTTPS de callback (
https://lnavarrocarter.github.io/kuadashboard/vercel-callback), que reenvía automáticamente el código de autorización a la app vía el deep-linkkua:// - El perfil se guarda automáticamente y queda seleccionado como activo
Nota: OAuth requiere que
VERCEL_OAUTH_CLIENT_IDyVERCEL_OAUTH_CLIENT_SECRETestén configurados en el entorno de la app. Estos están incluidos en la versión oficial.
Proyectos
La pestaña Projects muestra todos los proyectos de Vercel accesibles con el perfil activo.
| Columna | Descripción |
|---|---|
| Nombre | Nombre del proyecto — haz clic para navegar a sus deployments |
| Framework | Framework detectado (Next.js, Vite, etc.) |
| Último Deploy | Estado del deployment más reciente (READY, ERROR, BUILDING, etc.) |
| URL | URL de producción del último deployment |
| Repositorio | Repositorio Git vinculado |
| Actualizado | Fecha de última actividad |
Acciones por proyecto:
- Deployments — cambia a la pestaña Deployments filtrada por este proyecto
- Domains — cambia a la pestaña Domains filtrada por este proyecto
- Env Vars — cambia a la pestaña Env Vars filtrada por este proyecto
Deployments
Lista todos los deployments del proyecto seleccionado. Usa el filtro de destino para filtrar por entorno:
- All — todos los deployments
- Production — solo
target: production - Preview — solo
target: preview
| Columna | Descripción |
|---|---|
| Deployment | UID del deployment |
| Estado | READY / ERROR / BUILDING / QUEUED / CANCELED |
| Destino | production o preview |
| URL | URL del deployment |
| Creador | Email/usuario que lo disparó |
| Creado | Fecha de creación |
Acciones por deployment:
- Logs — abre el panel de logs de construcción en tiempo real (SSE streaming)
- Functions — ver las funciones serverless/edge de este deployment
- Redeploy — dispara un nuevo deployment con el mismo código fuente
- Promote — promueve un deployment de preview a producción (oculto para deployments de producción)
- Cancel — cancela un deployment en estado
BUILDINGoQUEUED
Logs de Build
Haz clic en Logs en cualquier deployment para abrir el panel de logs. Los logs se transmiten en tiempo real vía Server-Sent Events. El panel soporta:
- Auto-scroll — mantiene la vista anclada al último mensaje
- Limpiar — borra el buffer de logs actual
- Coloración por tipo de evento:
stdout(blanco),stderr(rojo),command(amarillo), estado de deployment (azul)
Inteligencia de runtime logs en KUA Applications
El stream de logs de build anterior es distinto de los runtime logs. En Señales → Logs, selecciona un proyecto de Vercel y elige Cachear para inteligencia de logs para ver, antes de confirmar, una estimación de hasta dos solicitudes a la API por sync (búsqueda del último deployment de producción y su solicitud de runtime logs). KUA solo lee runtime logs de ese deployment, respeta los límites de Vercel y Retry-After, y marca la respuesta como parcial si llega al límite de lectura de 2 MiB/5.000 eventos. Las entradas pasan por la misma caché local cifrada, el sanitizador y el analizador que los otros proveedores; la evidencia observada queda ligada al proyecto de KUA Application.
Dominios
Lista todos los dominios personalizados configurados en el proyecto seleccionado.
| Columna | Descripción |
|---|---|
| Dominio | Nombre completo del dominio |
| Dominio raíz | Dominio apex |
| Rama | Rama Git a la que está mapeado el dominio (si aplica) |
| Redirige a | URL de destino si el dominio es una redirección |
| Verificado | Si Vercel ha verificado los registros DNS |
Variables de Entorno
Lista todas las claves de variables de entorno del proyecto seleccionado. Los valores son intencionalmente nunca mostrados ni transmitidos — esto es una medida de seguridad para prevenir la exposición accidental de secretos.
| Columna | Descripción |
|---|---|
| Clave | Nombre de la variable |
| Tipo | plain, secret o sensitive |
| Destino | Entornos donde aplica (production / preview / development) |
Funciones
Lista las funciones serverless y edge incluidas en un deployment seleccionado.
| Columna | Descripción |
|---|---|
| Función | Ruta del archivo dentro del deployment |
| Tipo | lambda (serverless Node.js) o edge |
| Modo | Modo de ejecución reportado por Vercel |
Selecciona un deployment en la pestaña Deployments primero — la pestaña Functions muestra las funciones del deployment actualmente seleccionado.
Resumen
Overview es la primera entrada de la barra lateral y la vista con la que abre Vercel. Resume la cuenta o el team del perfil activo a partir de un solo análisis:
- Salud: saludable, requiere atención (proyectos pausados, dominios sin verificar o datos que no se pudieron leer) o producción fallando (un proyecto cuyo último deploy a producción falló).
- Proyectos (pausados, con Git), Producción (sanos, fallidos, construyendo, sin producción), Tasa de fallos reciente (últimos 10 deployments por proyecto) y Dominios (sin verificar).
- Proyectos por último deployment: framework, Node.js, estado de producción, último deploy, fallos recientes y dominios de cada proyecto; el nombre lo deja como proyecto activo. Las variables de entorno se cuentan por tipo.
El análisis se comparte con el Advisor y queda en caché 15 minutos; Analizar de nuevo fuerza uno nuevo.
Advisor
El Advisor, dentro del Resumen, revisa cada proyecto de la cuenta o el team contra buenas prácticas. Requiere el plan Pro o Team; en Free muestra cuántos hallazgos hay.
| Categoría | Chequeos |
|---|---|
| Seguridad | Credenciales en variables de tipo Plain · secretos de producción compartidos con todas las previews · secretos de producción que no son Sensitive · previews sin Deployment Protection · Git Fork Protection apagado |
| Infraestructura | Último deploy a producción fallido · dominios sin verificar · proyectos pausados · proyectos sin deployment de producción |
| Arquitectura | Proyectos que despliegan directo a producción, sin previews |
| Desarrollo | Node.js fuera de soporte · la mitad o más de los deployments recientes fallaron · proyectos sin Git conectado |
- Qué lee: los proyectos (hasta 100), sus últimos 10 deployments, sus dominios y el nombre, tipo y target de sus variables de entorno. Los valores se descartan al llegar y nunca se guardan. Una variable cuenta como credencial por su nombre (password, secret, token, API key…).
- Costo: lecturas gratuitas de la API de Vercel, unas 3 por proyecto. El análisis queda en caché 15 minutos; Analizar de nuevo fuerza uno nuevo.
- Decisiones e historial: acepta un riesgo o silencia un chequeo que no aplica, revisa la postura en el tiempo y programa el análisis, igual que en los Advisors de AWS y GCP. Un perfil agregado solo con un token (
local:<token>) se guarda con un hash del token y no se puede programar. - Agentes IA: la herramienta MCP
vercel_advisordevuelve los mismos hallazgos (ver Agentes IA).
Cambiar de Perfil y Proyecto
El header funciona como Cluster → Namespace en Kubernetes: eliges un perfil y después un proyecto.
- Perfil — cambia entre cuentas o perfiles de equipo de Vercel. Al cambiarlo se limpia el proyecto actual y se carga la lista de proyectos de ese perfil. La selección se mantiene entre sesiones.
- Proyecto — el proyecto activo para las vistas que dependen de él: Deployments, Domains, Env Vars y Cron. Al elegir un proyecto se recarga la vista en la que estás; las vistas que no dependen del proyecto (Projects, Aliases, Webhooks, Edge Config, Activity) no se recargan. Elige — Proyecto — para quitarlo.
- La lista de proyectos está disponible desde cualquier pestaña de Vercel, no hace falta abrir Projects primero.
- KUA recuerda el último proyecto usado con cada perfil y lo vuelve a seleccionar cuando regresas a ese perfil. Si el proyecto ya no existe, la selección se limpia.
- Hacer clic en una fila de la tabla Projects es un atajo para la misma selección: el header y la tabla siempre muestran el mismo proyecto.