Docs públicas

Vaia MCP

Guía pública curada — no es la documentación completa privada de la API.

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?

Da el siguiente paso

Todo lo bueno
empieza en equipo.

Por ahora el acceso es por invitación.

Por ahora no aceptamos nuevas inscripciones a la lista de espera.

La lista de espera en pausa no recopila correos electrónicos ni nombres de empresa.

Política de privacidad

Cookies de analítica

Usamos Google Analytics para entender cómo se usa el sitio. Solo se activa si aceptas: tu elección se guarda y puedes cambiarla cuando quieras desde el pie de página.