# Vaia MCP

> Collega Claude a Vaia con una chiave API personale: configurazione, strumenti per tempo e ferie, e basi di sicurezza.

Docs pubbliche

Guida pubblica curata — non la documentazione API privata completa.

Vaia espone un endpoint MCP remoto così i membri possono collegare Claude, agent OpenAI e altri client MCP con una chiave API personale e usare le stesse capacità di tempo e ferie dell’assistente in-app, con i permessi del ruolo attuali.

## Configurazione

1. In Vaia apri [MCP](https://app.vaia.space/mcp) e crea una chiave API per l’organizzazione che il client deve usare. Copia il secret vaia\_mcp\_… quando viene mostrato: viene visualizzato una sola volta.
2. Nel tuo client MCP, aggiungi un connettore remoto / personalizzato (web).
3. Inserisci i dettagli di connessione sotto. Scegli nessun accesso (auth con API key) e imposta l’intestazione.

- **URL del connettore:**`https://api.vaia.space/mcp`
- **Nome header:**`X-API-KEY`
- **Valore header:** il secret vaia\_mcp\_… grezzo (senza prefisso Bearer).

L’organizzazione è nella chiave. Crea una chiave per organizzazione se ne hai più di una.

## Cosa puoi fare

Il client scopre gli strumenti dopo la connessione. La disponibilità dipende dai moduli abilitati e dai tuoi permessi. Le azioni sono sempre per te — mai per conto di un altro membro.

### Tracciamento tempo

Avvia e ferma il timer, controlla lo stato, riprendi, riepiloga il tempo, crea registrazioni e invia timesheet quando il progetto lo richiede.

- `timer_start`
- `timer_stop`
- `timer_status`
- `timer_resume`
- `timelog_summary`
- `timelog_create`
- `timesheet_weeks_status`
- `timesheet_submit`

### Ferie / assenze

Controlla i saldi, elenca e richiedi assenze, vedi le prossime assenze approvate, annulla le richieste in sospeso e accorcia le assenze approvate.

- `leave_balance`
- `leave_request`
- `leave_requests_list`
- `leave_upcoming`
- `leave_request_cancel`
- `leave_request_shorten`

Non incluso: contabilità, fatture, HR, inventario, documenti, workflow, admin organizzazione e altri moduli oltre tempo e assenze.

## Sicurezza

- Tratta la chiave come una password. Viene mostrata una sola volta; se la perdi, creane una nuova e revoca la vecchia.
- Le chiavi funzionano solo sull’endpoint MCP (/mcp), non sulle route REST normali.
- Revoca le chiavi inutilizzate o compromesse. Al massimo cinque chiavi attive per membership.
- Controlla le richieste di approvazione strumenti del tuo client prima di consentire scritture (timer, ferie, invio timesheet).
- L’endpoint MCP ha un limite di frequenza (60 richieste al minuto).

## Esempi di prompt

- Avvia il mio timer sul progetto X.
- Quante ferie mi restano quest’anno?
- Richiedi ferie da lunedì a mercoledì prossimi.
- Il mio timer è in esecuzione?

Fai il prossimo passo

## Le cose belle iniziano insieme.

Porta il tuo team in Vaia tra i primi.

---

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