# Connecteur Claude 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 pour que les membres connectent Claude avec une clé API personnelle et utilisent les mêmes capacités de temps et de congés que l’assistant intégré, selon leurs permissions.

## Configuration

1. Dans Vaia, ouvrez [Claude MCP](https://app.vaia.space/claude-mcp) et créez une clé API pour l’organisation. Copiez le secret vaia\_mcp\_… — affiché une seule fois.
2. Dans Claude, ajoutez un connecteur personnalisé (MCP distant / web).
3. Saisissez les détails ci-dessous. Choisissez sans connexion et définissez l’en-tête de requê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

Claude découvre les outils après 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.

### 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.
- Vérifiez les approbations d’outils de Claude avant d’autoriser des écritures.
- 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/claude-mcp
Index: https://vaia.space/llms.txt