# Vaia MCP

> Connectez Claude à Vaia avec une clé API personnelle : configuration, outils de temps et congés, et bases de sécurité.

Docs publiques

Guide public ciblé — pas la documentation API privée complète.

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](https://app.vaia.space/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 ?

Passez à l’étape suivante

## Les belles choses commencent ensemble.

Soyez parmi les premiers à accueillir votre équipe dans Vaia.

---

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