Serveurs et clé MCP
Mis à jour le 24 octobre 2026
Un serveur regroupe vos sources, vos outils, votre API cible et une clé MCP. Cette page explique comment le gérer.
Créer un serveur
Dans « Mes serveurs », cliquez sur « Créer un serveur ». Le nom compte de 1 à 60 caractères, sans caractère de contrôle ; la description, facultative, 500 caractères au plus. Le nombre de serveurs est fixé par votre offre (voir l'écran « Offres ») : supprimez un serveur pour en créer un autre au-delà. Votre adresse email doit être vérifiée.
À la création, la clé MCP s'affiche une seule fois (voir La clé MCP).
États d'un serveur
| État | Signification |
|---|---|
Brouillon (draft) | Aucune source n'est encore prête. |
Actif (active) | Le serveur répond aux IA. |
Désactivé (disabled) | Vous l'avez désactivé. |
Un serveur passe de brouillon à actif tout seul au premier import réussi. Un serveur en brouillon ou désactivé répond à l'IA par une erreur 403 « Server is not active ». Le bac à sable, lui, fonctionne quel que soit l'état.
Renommer un serveur
Dans le détail du serveur, cliquez sur « Modifier », changez le nom ou la description, puis « Enregistrer ». La clé et l'URL ne changent pas.
Activer ou désactiver
Utilisez l'interrupteur « Serveur activé » du détail du serveur. Désactivé, le serveur refuse les appels de l'IA sans rien perdre : sources, outils et clé sont conservés. Réactivez-le quand vous voulez.
Supprimer un serveur
Cliquez sur « Supprimer », puis saisissez le nom du serveur pour confirmer. Les sources, documents, journal d'appels et la clé sont supprimés définitivement. Cette action est irréversible.
La clé MCP
La clé commence par vz_ (par exemple vz_AbC…). C'est un secret : quiconque la détient peut appeler votre serveur. Elle n'est affichée qu'une seule fois, à la création ou à la régénération, et Voozeo n'en conserve qu'une empreinte : impossible de la retrouver ensuite. Conservez-la dans un gestionnaire de mots de passe et ne la publiez ni dans un dépôt de code ni dans un message.
Régénérer la clé
Si la clé est perdue ou compromise, ouvrez l'onglet « Connexion » et cliquez sur « Régénérer la clé », puis confirmez. L'ancienne clé cesse de fonctionner immédiatement : reconfigurez toutes les IA connectées avec la nouvelle. Une clé absente, invalide ou d'un autre serveur provoque une erreur 401 (voir Erreurs et dépannage). Un serveur dont l'API cible utilise OAuth 2.0 n'a pas de clé à régénérer : chaque IA se connecte à la place (voir Serveurs en OAuth). Si vous repassez ce serveur à un autre type d'authentification, régénérez la clé avant de connecter une IA.
Les deux formes d'URL
L'onglet « Connexion » propose deux URL pour le même serveur. L'adresse exacte est celle qui y est affichée.
URL avec la clé dans l'en-tête
Elle se termine par /s/<serverId>/mcp et la clé est envoyée dans l'en-tête Authorization: Bearer <clé>. C'est la forme à préférer quand le client permet de définir un en-tête, par exemple Claude Code, Cursor ou VS Code.
URL avec la clé intégrée
Elle se termine par /k/<clé>/mcp : la clé fait partie de l'adresse. Utilisez-la pour les clients qui n'acceptent qu'une URL, comme claude.ai, Claude Desktop ou ChatGPT. Gardez cette URL secrète : elle donne accès au serveur au même titre que la clé. Voir Connecter son IA.
L'onglet « Tableau de bord » résume l'usage du serveur : voir Tableau de bord.
Exemple
Vous créez le serveur boutique, copiez la clé vz_… dans votre gestionnaire de mots de passe, puis importez une spec. Le serveur devient actif. Plus tard, un collègue quitte l'équipe : vous cliquez sur « Régénérer la clé » et mettez à jour Claude Code avec la nouvelle clé. L'ancienne ne fonctionne plus.