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

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/claude-mcp
Index: https://vaia.space/llms.txt