Conector Claude MCP

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

Configuración

1. En Vaia, abre Claude MCP y crea una clave API para la organización. Copia el secreto vaia_mcp_… cuando se muestre — solo una vez.
2. En Claude, añade un conector personalizado (MCP remoto / web).
3. Introduce los datos de conexión. Elige sin inicio de sesión y configura el encabezado de solicitud.

• 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

Claude descubre herramientas al conectar. La disponibilidad depende de los módulos activos y tus permisos. Las acciones son siempre para ti, nunca en nombre de otro.

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 aprobaciones de herramientas de Claude antes de permitir escrituras.
• 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?