Connecter Cursor à un serveur Voozeo MCP

Pour connecter Cursor à votre serveur Voozeo MCP, collez un bloc dans ~/.cursor/mcp.json pour tous vos projets, ou dans .cursor/mcp.json pour un seul projet.

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 ; 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.
• Cursor avec la prise en charge de MCP.

Quel fichier modifier

Cursor utilise l'URL avec la clé dans l'en-tête Authorization. C'est la forme la plus sûre : la clé ne fait pas partie de l'adresse. Voir les deux formes d'URL.

Ajouter le serveur

1. Dans Voozeo, ouvrez votre serveur, allez dans l'onglet « Connexion » et choisissez Cursor. 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. Collez le premier bloc dans le fichier mcp.json que vous avez choisi.

{
  "mcpServers": {
    "mon-serveur": {
      "url": "https://mcp.example.com/s/<id-du-serveur>/mcp",
      "headers": {
        "Authorization": "Bearer <votre-clé>"
      }
    }
  }
}

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

Le second bloc est une variante : elle lit la clé dans une variable d'environnement, donc la clé n'est pas écrite dans le fichier. Préférez-la pour un fichier de projet que vous versionnez dans un dépôt.

Installation en un clic

Juste après la création du serveur ou la régénération de sa clé, l'onglet Connexion affiche un bouton « Ajouter à Cursor ». Il ouvre Cursor avec le serveur déjà renseigné, clé comprise : utilisez-le seulement sur votre propre ordinateur. Le bouton n'est pas affiché dans l'application Android, ni quand la clé ne peut plus être affichée : copiez alors le bloc ci-dessus.

Vérifier la connexion

1. Demandez à Cursor 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

Consultez aussi la documentation officielle de Cursor sur MCP.

Pour aller plus loin

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