# Connettore Claude 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 con una chiave API personale e usare le stesse capacità di tempo e ferie dell’assistente in-app, con i loro permessi attuali.

## Configurazione

1. In Vaia apri [Claude MCP](https://app.vaia.space/claude-mcp) e crea una chiave API per l’organizzazione. Copia il secret vaia\_mcp\_… — viene mostrato una sola volta.
2. In Claude aggiungi un connettore personalizzato (MCP remoto / web).
3. Inserisci i dettagli sotto. Scegli nessun accesso e imposta l’header della richiesta.

- **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

Claude scopre gli strumenti dopo la connessione. La disponibilità dipende dai moduli attivi e dai tuoi permessi. Le azioni sono sempre per te, mai per conto di altri.

### 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 approvazioni degli strumenti di Claude prima di consentire scritture.
- 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/claude-mcp
Index: https://vaia.space/llms.txt