Connecter Claude, ChatGPT, Codex ou Cursor à Clevera

Vous pouvez permettre à des applications d'IA telles que Claude, ChatGPT, Claude Code, Codex et Cursor de fonctionner dans votre espace de travail Clevera via le serveur MCP de Clevera. Les applications de chat se connectent avec une connexion (un connecteur, aucun jeton requis) ; les agents de codage et les scripts se connectent avec un jeton d'API.

Avant de commencer#

• Les agents d'IA et l'API, y compris les connecteurs pour Claude et ChatGPT, sont disponibles sur les plans Pro, Business et Custom. Sur les autres plans, le connecteur affiche "Les connecteurs Claude.ai et ChatGPT sont disponibles sur le plan Pro et supérieur."
• Un agent agit en votre nom, dans la limite de ce que votre rôle autorise. Voir Autorisations de l'agent.

Choisir comment se connecter#

L'adresse du serveur MCP est la même pour chaque application :

https://app.clevera.ai/mcp

Connecter Claude ou ChatGPT#

1. Copier l'URL du connecteur#

   Ouvrez le menu de l'espace de travail et choisissez AI agents & API, puis ouvrez l'onglet Applications connectées. Copiez l'URL du connecteur sous Connecter Claude ou ChatGPT : "Aucun jeton requis : ajoutez Clevera en tant que connecteur personnalisé et connectez-vous."

   

2. Ajouter un connecteur personnalisé dans l'application#

   Dans Claude ou ChatGPT, ouvrez les paramètres du connecteur et ajoutez un connecteur personnalisé. Collez l'URL.

3. Se connecter et choisir l'accès#

   L'application vous envoie vers l'écran Connecter app à Clevera. Connectez-vous si ce n'est pas déjà fait, puis choisissez :

   • Espace de travail : l'espace de travail dans lequel l'application fonctionne.
   • Sites Web : Tous les sites ("Chaque site actuel et futur de cet espace de travail.") ou Sites choisis, lorsque l'accès inclut des sites de documentation.
   • Accès : des autorisations prédéfinies ou Personnalisé. Les autorisations que votre rôle n'autorise pas affichent Non autorisé pour votre rôle. Voir Autorisations de l'agent.
   • Durée de la connexion : 30 ou 90 jours. La valeur par défaut est de 90 jours.

4. Autoriser l'accès#

   Cliquez sur Autoriser l'accès. Vous revenez à l'application, qui peut désormais utiliser les outils de Clevera. "Vous pouvez la déconnecter à tout moment dans Intégrations → AI agents & API." Cliquez sur Refuser pour ne rien envoyer.

L'écran de connexion indique qui vous connectez :

• Application vérifiée · vous renvoie à adresse : une application connue (Claude, ChatGPT ou Cursor), reconnue par l'adresse vers laquelle elle renvoie.
• Vous renvoie à adresse : toute autre application. Vérifiez l'adresse avant d'autoriser l'accès.

Le propriétaire et les administrateurs de l'espace de travail reçoivent une notification, "app a été connectée à workspace", avec l'accès que vous avez choisi.

Ce qu'une application connectée peut et ne peut pas faire#

• Elle agit en votre nom, dans la limite de votre rôle, avec l'accès que vous avez choisi. Elle ne voit que les enregistrements, vidéos et collections que vous pouvez voir.
• Elle fonctionne uniquement via MCP. Sa connexion ne peut pas être utilisée sur l'API REST : "Les jetons de connecteur OAuth fonctionnent uniquement sur le serveur MCP. Utilisez un jeton statique pour l'API REST."
• Elle n'a pas ses propres plafonds de dépenses, donc chaque démarrage payant depuis une application connectée attend qu'une personne l'approuve dans Requêtes de l'agent. Voir Contrôler les dépenses et les approbations des agents.
• Chaque personne peut avoir jusqu'à 20 applications connectées.
• La connexion prend fin lorsque sa durée de vie (30 ou 90 jours) expire ; vous devez alors reconnecter l'application. Une application qui n'utilise pas Clevera pendant 30 jours doit également se reconnecter.

Connecter Claude Code, Codex ou un autre agent avec un jeton#

Créez un jeton d'API d'abord. Une fois créé, Connecter un agent affiche une configuration prête à l'emploi avec l'adresse du serveur de votre espace de travail. Chaque extrait lit le jeton à partir de la variable d'environnement CLEVERA_TOKEN, de sorte que le jeton lui-même n'est jamais inclus dans un fichier : "Définissez CLEVERA_TOKEN sur le jeton dans votre shell ou le magasin de secrets de l'agent."

claude mcp add --transport http clevera https://app.clevera.ai/mcp --header "Authorization: Bearer $CLEVERA_TOKEN"

codex mcp add clevera --url https://app.clevera.ai/mcp --bearer-token-env-var CLEVERA_TOKEN

[mcp_servers.clevera]
url = "https://app.clevera.ai/mcp"
bearer_token_env_var = "CLEVERA_TOKEN"

{
  "mcpServers": {
    "clevera": {
      "type": "http",
      "url": "https://app.clevera.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${CLEVERA_TOKEN}"
      }
    }
  }
}

curl -H "Authorization: Bearer $CLEVERA_TOKEN" https://app.clevera.ai/api/v1/docs/me

Cursor et les autres clients MCP qui lisent un fichier mcpServers utilisent la même entrée de serveur que .mcp.json.

Vérifier que cela fonctionne#

Demandez à l'agent ce qu'il peut faire dans Clevera, ou de lister vos enregistrements. L'agent ne voit que les outils autorisés par ses permissions, donc une liste courte signifie généralement un jeton restreint. Tout ce qu'il fait s'affiche dans l'onglet Activité.

Déconnecter une application#

Dans l'onglet Applications connectées, cliquez sur le bouton de déconnexion à la fin de la ligne de l'application et confirmez avec Déconnecter ("Déconnecter app ?"). "L'application perd immédiatement l'accès. La reconnecter nécessite une nouvelle connexion." La ligne reste listée (grisée) pendant 30 jours.

Le propriétaire et les administrateurs de l'espace de travail voient chaque application connectée dans l'espace de travail ("Applications connectées par les membres de cet espace de travail.") et peuvent déconnecter n'importe laquelle d'entre elles. Tous les autres voient et déconnectent les leurs ("Applications que vous avez connectées.").

Dépannage#

Plus de messages : Corriger les erreurs d'agent et d'API.

Connexe#