Vaia MCP

Vaia expose un endpoint MCP distant afin que les membres puissent connecter Claude, des agents OpenAI et d’autres clients MCP avec une clé API personnelle et utiliser les mêmes capacités de temps et d’absences que l’assistant intégré, selon leurs permissions de rôle actuelles.

Configuration

1. Dans Vaia, ouvrez MCP et créez une clé API pour l’organisation que le client doit utiliser. Copiez le secret vaia_mcp_… lorsqu’il s’affiche — il n’est montré qu’une seule fois.
2. Dans votre client MCP, ajoutez un connecteur distant / personnalisé (web).
3. Saisissez les détails de connexion ci-dessous. Choisissez aucune connexion (auth par clé API) et définissez l’en-tête.

• URL du connecteur :https://api.vaia.space/mcp
• Nom de l’en-tête :X-API-KEY
• Valeur de l’en-tête : le secret vaia_mcp_… brut (sans préfixe Bearer).

L’organisation est liée à la clé. Créez une clé par organisation si vous en avez plusieurs.

Ce que vous pouvez faire

Le client découvre les outils après la connexion. La disponibilité dépend des modules activés et de vos permissions. Les actions sont toujours pour vous — jamais au nom d’un autre membre.

Suivi du temps

Démarrer et arrêter le minuteur, vérifier l’état, reprendre, résumer le temps, créer des entrées et soumettre des feuilles de temps si le projet l’exige.

• timer_start
• timer_stop
• timer_status
• timer_resume
• timelog_summary
• timelog_create
• timesheet_weeks_status
• timesheet_submit

Congés

Consulter les soldes, lister et demander des congés, voir les prochains congés approuvés, annuler les demandes en attente et raccourcir les congés approuvés.

• leave_balance
• leave_request
• leave_requests_list
• leave_upcoming
• leave_request_cancel
• leave_request_shorten

Non inclus : comptabilité, factures, RH, inventaire, documents, workflows, admin d’organisation et autres modules hors temps et congés.

Sécurité

• Traitez la clé comme un mot de passe. Elle n’est affichée qu’à la création ; en cas de perte, créez-en une nouvelle et révoquez l’ancienne.
• Les clés ne fonctionnent que sur l’endpoint MCP (/mcp), pas sur les routes REST ordinaires.
• Révoquez les clés inutilisées ou compromises. Cinq clés actives maximum par adhésion.
• Examinez les invites d’approbation d’outils de votre client avant d’autoriser des écritures (timers, absences, soumission de feuilles de temps).
• L’endpoint MCP est limité en débit (60 requêtes par minute).

Exemples de prompts

• Démarre mon minuteur sur le projet X.
• Combien de congés me reste-t-il cette année ?
• Demande des vacances du lundi au mercredi prochains.
• Mon minuteur tourne-t-il ?