Connecter son IA

Cette page explique, pour chaque IA, où coller l'URL ou la clé de votre serveur. Les blocs ci-dessous sont les mêmes que dans l'onglet « Connexion » du serveur.

Avant de connecter

• Le serveur doit être « active » : en « draft » ou « disabled », l'IA reçoit une erreur 403 (voir Serveurs et clé MCP).
• Sur un serveur dont l'API cible utilise OAuth 2.0, il n'y a pas de clé : voir Serveurs en OAuth.
• La clé MCP est un secret affiché une seule fois, à la création du serveur ou à sa régénération. Si vous l'avez perdue, régénérez-la.
• Dans l'onglet « Connexion », choisissez votre IA : 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é.
• Deux formes d'URL existent (voir les URL) : l'URL avec la clé dans l'en-tête Authorization (Claude Code, Cursor, VS Code) et l'URL qui contient la clé (claude.ai, Claude Desktop, ChatGPT). Cette dernière est un secret : ne la partagez pas.

claude.ai

Ajoutez un connecteur personnalisé avec l'URL qui contient votre clé : nom du serveur, URL, sans authentification. Sur un plan Team ou Enterprise, c'est un Owner qui l'ajoute depuis les paramètres de l'organisation.

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

Claude Desktop

Les serveurs distants s'ajoutent comme connecteurs de votre compte Claude, sur le même écran que claude.ai. Le connecteur est partagé avec votre compte claude.ai.

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

Claude Code

Lancez la commande dans votre terminal : elle utilise l'URL avec l'en-tête Authorization. Pour partager la configuration avec une équipe, utilisez plutôt le fichier .mcp.json du projet : la clé reste dans la variable d'environnement VOOZEO_KEY et 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}"
      }
    }
  }
}

ChatGPT

Ajoutez un serveur MCP personnalisé avec l'URL qui contient votre clé, sans authentification. Les menus et le mode développeur dépendent de votre offre ChatGPT.

Plugins > + > Add custom MCP server
Name: mon-serveur
Server URL: https://mcp.example.com/k/<votre-clé>/mcp
Authentication: No authentication

Cursor

Cliquez sur « Ajouter à Cursor » dans la carte « Ajouter en un clic » de l'onglet « Connexion » : Cursor s'ouvre et vous demande de confirmer avant d'ajouter le serveur. Le bouton n'apparaît que tant que votre clé est affichée (juste après la création du serveur ou la régénération de la clé), ou pour un serveur qui utilise OAuth, et il est masqué dans l'application Android. Le lien contient votre clé : utilisez-le seulement sur votre propre ordinateur. Sinon, modifiez le fichier à la main :

Collez le bloc dans ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projet). La variante lit la clé dans la variable d'environnement VOOZEO_KEY, pour ne pas l'écrire dans le fichier.

{
  "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}"
      }
    }
  }
}

VS Code

« Ajouter à VS Code » fonctionne de la même façon : VS Code s'ouvre et vous demande de confirmer. Le lien contient votre clé, VS Code ne la demande donc pas. Pour ne pas écrire la clé dans le fichier, utilisez plutôt le bloc ci-dessous.

Collez le bloc dans .vscode/mcp.json. VS Code demande la clé au premier démarrage, sans la stocker dans le fichier.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "voozeo-key",
      "description": "Voozeo API key",
      "password": true
    }
  ],
  "servers": {
    "mon-serveur": {
      "type": "http",
      "url": "https://mcp.example.com/s/<id-du-serveur>/mcp",
      "headers": {
        "Authorization": "Bearer ${input:voozeo-key}"
      }
    }
  }
}

Serveurs en OAuth

Quand l'API cible de votre serveur utilise OAuth 2.0, il n'y a pas de clé MCP : l'onglet « Connexion » affiche un bloc « OAuth » avec la seule URL du serveur, https://mcp.example.com/s/<id-du-serveur>/mcp (la vraie figure dans l'onglet), et aucun bouton « Régénérer la clé ».

1. Ajoutez le serveur à votre IA avec cette URL, sans en-tête ni clé (syntaxe ci-dessous).
2. Au premier appel, l'IA ouvre votre navigateur sur une page de consentement Voozeo : elle affiche l'adresse qui recevra l'accès (vérifiez-la), le nom déclaré par l'application (non vérifié), le fournisseur chez qui vous vous connecterez et les scopes demandés. Cliquez sur « Autoriser », ou « Refuser ».
3. Vous vous connectez ensuite chez le fournisseur de l'API avec votre propre compte et acceptez. L'IA est connectée : chaque appel d'outil part avec votre jeton du fournisseur, que l'IA ne voit jamais.

Chaque personne qui utilise le serveur se connecte avec son propre compte. L'IA garde la connexion tant qu'elle sert au moins une fois tous les 30 jours.

Syntaxe par IA (remplacez l'URL par celle de l'onglet) :

• claude.ai : Customize > Connectors > Add custom connector, puis :

Name: mon-serveur
Remote MCP server URL: https://mcp.example.com/s/<id-du-serveur>/mcp
Authentication: Sign in now
OAuth client: Use Claude's published identity
Add, then Connect

• Claude Desktop : mêmes connecteurs que claude.ai (Customize > Connectors > Add custom connector, l'URL, puis Connect).
• Claude Code : lancez la commande, puis tapez /mcp dans Claude Code pour vous connecter.

claude mcp add --transport http mon-serveur https://mcp.example.com/s/<id-du-serveur>/mcp

• ChatGPT : Plugins > + > Add custom MCP server, l'URL, authentification « OAuth », puis « Create as a plugin » et connectez-vous.
• Cursor (~/.cursor/mcp.json ou .cursor/mcp.json) :

{ "mcpServers": { "mon-serveur": { "url": "https://mcp.example.com/s/<id-du-serveur>/mcp" } } }

• VS Code (.vscode/mcp.json) :

{ "servers": { "mon-serveur": { "type": "http", "url": "https://mcp.example.com/s/<id-du-serveur>/mcp" } } }

Les IA qui tournent uniquement dans un navigateur web (sans partie serveur ni application de bureau) ne peuvent pas se connecter en OAuth. Si l'IA vous demande de vous reconnecter, voir Connexion demandée.

Identifiants par utilisateur

Quand l'API cible de votre serveur utilise le type « Transmis par l'appelant », l'onglet « Connexion » affiche un bloc « Passerelle OAuth » avec l'URL qui contient la clé, à déclarer dans une passerelle placée devant Voozeo. Ne donnez pas cette URL aux utilisateurs. Avec l'en-tête Authorization, les blocs qui placent la clé dans un en-tête sont masqués. Voir Identifiants par utilisateur avec une passerelle OAuth.

Vérifier la connexion

1. Demandez à votre IA de lister les outils de ce serveur, ou posez-lui une question qui en nécessite un.
2. Ouvrez l'onglet « Journal » : chaque appel d'outil y apparaît (voir Journal des appels).
3. En cas de doute, essayez d'abord l'outil dans le bac à sable.

Exemple : après avoir ajouté le serveur « Catalogue » à Claude Code, vous écrivez « Cherche le produit 42 ». L'IA appelle l'outil get_product, et une ligne « Réussi » apparaît dans le journal.

Dépannage

• L'IA indique une erreur d'authentification (401) : la clé est absente, fausse ou d'un autre serveur, ou a été régénérée. Voir 401. Sur un serveur en OAuth, l'IA doit se reconnecter : voir Connexion demandée.
• L'IA indique un accès refusé (403) : le serveur n'est pas « active » ou l'espace est suspendu. Voir 403.
• Les appels échouent avec un message de quota : voir quota atteint.
• Pour les menus propres à chaque IA, consultez sa documentation officielle, liée dans l'onglet « Connexion » (« Documentation officielle »).