Vaia MCP

Vaia expone un endpoint MCP remoto para que los miembros conecten Claude, agentes de OpenAI y otros clientes MCP con una clave API personal y usen las mismas capacidades de tiempo y ausencias que el asistente in-app, con sus permisos de rol actuales.

Configuración

1. En Vaia, abre MCP y crea una clave API para la organización que quieras usar. Copia el secreto vaia_mcp_… cuando se muestre: solo se muestra una vez.
2. En tu cliente MCP, añade un conector remoto / personalizado (web).
3. Introduce los datos de conexión siguientes. Elige sin inicio de sesión (auth por API key) y configura el encabezado.

• URL del conector:https://api.vaia.space/mcp
• Nombre del encabezado:X-API-KEY
• Valor del encabezado: el secreto vaia_mcp_… en bruto (sin prefijo Bearer).

La organización va en la clave. Crea una clave por organización si perteneces a varias.

Qué puedes hacer

El cliente descubre herramientas tras conectar. La disponibilidad depende de los módulos habilitados y de tus permisos. Las acciones son siempre tuyas: nunca en nombre de otro miembro.

Control de tiempo

Iniciar y detener el temporizador, ver estado, reanudar, resumir tiempo, crear registros y enviar hojas de horas cuando el proyecto lo requiera.

• timer_start
• timer_stop
• timer_status
• timer_resume
• timelog_summary
• timelog_create
• timesheet_weeks_status
• timesheet_submit

Ausencias

Consultar saldos, listar y solicitar ausencias, ver próximas ausencias aprobadas, cancelar pendientes y acortar ausencias aprobadas.

• leave_balance
• leave_request
• leave_requests_list
• leave_upcoming
• leave_request_cancel
• leave_request_shorten

No incluido: contabilidad, facturas, RR. HH., inventario, documentos, flujos de trabajo, administración de la organización ni otros módulos fuera de tiempo y ausencias.

Seguridad

• Trata la clave como una contraseña. Se muestra una vez; si la pierdes, crea otra y revoca la anterior.
• Las claves solo sirven en el endpoint MCP (/mcp), no en las rutas REST normales.
• Revoca claves que ya no uses o si pueden haberse filtrado. Como máximo cinco claves activas por membresía.
• Revisa las solicitudes de aprobación de herramientas de tu cliente antes de permitir escrituras (temporizadores, ausencias, envío de partes).
• El endpoint MCP tiene límite de ritmo (60 solicitudes por minuto).

Ejemplos de prompts

• Inicia mi temporizador en el proyecto X.
• ¿Cuántos días de vacaciones me quedan este año?
• Solicita vacaciones del lunes al miércoles próximos.
• ¿Está corriendo mi temporizador?