Vaia MCP

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