Connettore Claude MCP

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