Connecter Claude à un serveur Voozeo MCP

Pour connecter Claude à votre serveur Voozeo MCP, ajoutez un connecteur personnalisé dans claude.ai ou Claude Desktop avec l'URL qui contient votre clé, ou lancez une commande dans Claude Code.

Ce qu'il vous faut

• Un serveur Voozeo à l'état « active », c'est-à-dire avec au moins une source prête. Voir la prise en main.
• La clé MCP de ce serveur. Elle n'est affichée qu'une seule fois, à la création du serveur ou à la régénération de la clé. Si vous l'avez perdue, régénérez-la.
• Si votre serveur utilise OAuth 2.0, aucune clé : ajoutez la seule URL du serveur, puis chaque personne se connecte avec son propre compte chez le fournisseur de l'API au premier appel. Voir serveurs en OAuth.
• Une offre Claude qui autorise les connecteurs personnalisés. Sur une offre Team ou Enterprise, c'est un Owner qui ajoute le connecteur depuis les paramètres de l'organisation.

Quelle URL pour quelle application Claude

L'URL qui contient la clé est un secret : ne la partagez pas. Voir les deux formes d'URL.

Ajouter le connecteur dans claude.ai ou Claude Desktop

1. Dans Voozeo, ouvrez votre serveur, allez dans l'onglet « Connexion » et choisissez votre application Claude. L'URL et la clé réelles sont déjà insérées juste après la création ou la régénération. Sinon, les blocs affichent <YOUR_KEY> : remplacez-le par votre clé.
2. Dans Claude, ouvrez Customize, puis Connectors, puis Add custom connector.
3. Saisissez le nom du serveur et l'URL qui contient votre clé, et choisissez l'absence d'authentification.
4. Enregistrez le connecteur.

Customize > Connectors > Add custom connector
Name: mon-serveur
Remote MCP server URL: https://mcp.example.com/k/<votre-clé>/mcp
Authentication: No sign-in

Ajouter le serveur dans Claude Code

Lancez la commande dans votre terminal. Pour partager la configuration avec une équipe, utilisez plutôt le fichier .mcp.json du projet : il lit la clé dans une variable d'environnement, donc la clé n'est pas écrite dans le fichier.

claude mcp add --transport http mon-serveur https://mcp.example.com/s/<id-du-serveur>/mcp --header "Authorization: Bearer <votre-clé>"

{
  "mcpServers": {
    "mon-serveur": {
      "type": "http",
      "url": "https://mcp.example.com/s/<id-du-serveur>/mcp",
      "headers": {
        "Authorization": "Bearer ${VOOZEO_KEY}"
      }
    }
  }
}

Vérifier la connexion

1. Demandez à Claude de lister les outils du serveur, ou posez-lui une question qui en nécessite un.
2. Ouvrez l'onglet « Journal » du serveur dans Voozeo : chaque appel d'outil y apparaît.
3. En cas de doute, essayez d'abord l'outil dans l'onglet « Test ». Voir tester dans le bac à sable.

Dépannage

Les menus évoluent selon les versions de Claude : consultez la documentation officielle de Claude sur les connecteurs personnalisés et, pour la ligne de commande, la documentation de Claude Code sur MCP.

Pour aller plus loin

• Autres clients : ChatGPT, Cursor, VS Code.
• Créez d'abord le serveur : OpenAPI vers MCP ou documents vers MCP.
• Référence complète : connecter son IA.