# Vaia MCP

> Conecta Claude a Vaia con una clave API personal: configuración, herramientas de tiempo y ausencias, y seguridad básica.

Docs públicas

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](https://app.vaia.space/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.

Sé de los primeros en traer a tu equipo a Vaia.

---

Canonical: https://vaia.space/es/public/mcp
Index: https://vaia.space/llms.txt