Connecter Claude ou ChatGPT

La connexion prend environ une minute. Vous collez une adresse dans votre assistant, vous vous identifiez sur Kops, et vous approuvez ce que l'assistant a le droit de faire. Tout ce qu'il peut atteindre ensuite est listé sur ce que votre assistant peut faire.

#Ce qu'il vous faut

• Un compte Kops auquel vous pouvez vous connecter. L'assistant agit en votre nom : il obtient les permissions que votre rôle possède déjà, jamais plus.
• L'espace de travail dans lequel vous voulez qu'il travaille. Une connexion est liée à un seul espace, choisi au moment de l'approbation — impossible d'en changer ensuite.
• Sur Claude : n'importe quel plan, y compris Free, qui autorise un connecteur. Sur ChatGPT : un plan payant, sur l'application web.

Vous n'avez pas besoin de clé d'API, et l'assistant ne vous demandera jamais votre mot de passe Kops.

#L'adresse

C'est toute la configuration — une adresse, la même pour tout le monde :

Copiez-la telle quelle. Elle doit être complète, https:// compris : les assistants refusent le reste.

#Claude

Les libellés ci-dessous sont ceux de l'interface française. En anglais : Customize → Connectors, Add custom connector, Add.

#Sur un plan personnel

1. Ouvrez Personnaliser → Connecteurs.
2. Cliquez sur +, puis Ajouter un connecteur personnalisé.
3. Collez l'adresse ci-dessus.
4. Cliquez sur Ajouter.

Ne touchez pas aux paramètres avancés. Ils demandent un identifiant et un secret OAuth, qui existent pour les serveurs qui distribuent des créances à la main — Kops enregistre votre assistant automatiquement à sa première connexion, donc les remplir est le meilleur moyen d'obtenir une connexion qui échoue.

Une fois ajouté, activez-le dans une conversation avec le bouton + en bas à gauche du chat, puis Connecteurs.

#Sur un plan Team ou Enterprise

Un propriétaire l'ajoute une fois pour tout le monde :

1. Paramètres de l'organisation → Connecteurs.
2. Cliquez sur Ajouter, survolez Personnalisé, choisissez Web.
3. Collez l'adresse, cliquez sur Ajouter.

Les membres ouvrent ensuite Personnaliser → Connecteurs, trouvent le connecteur dans la liste, et cliquent sur Se connecter — c'est là que chaque personne s'identifie et choisit son propre espace de travail. La configuration du propriétaire ne connecte le compte de personne, et elle ne le peut pas : l'approbation est individuelle, parce que les permissions le sont.

#ChatGPT

ChatGPT atteint les serveurs extérieurs via le mode développeur, sur l'application web uniquement — un connecteur ajouté sur chatgpt.com apparaît ensuite dans les applications bureau et mobile, jamais l'inverse.

1. Activez le mode développeur dans les Paramètres. Sur un espace Business, Enterprise ou Education, un administrateur doit l'autoriser d'abord, et il ne peut pas l'activer pour une seule personne.
2. Ajoutez un connecteur personnalisé, avec un nom et l'adresse ci-dessus.
3. Approuvez l'avertissement que ChatGPT affiche sur les serveurs tiers, puis identifiez-vous sur Kops quand il vous y envoie.

warning Deux choses bougent ici, et l'une mérite une vérification avant de commencer. OpenAI a renommé cette section plus d'une fois — cherchez Apps ou Connecteurs dans les Paramètres — et ce que votre plan a le droit de faire d'un connecteur personnalisé est restreint : plusieurs plans ne peuvent utiliser que des outils qui lisent. Kops publie des outils qui écrivent (créer un filtre, bloquer un vendeur) : ils n'apparaîtront tout simplement pas sur un plan en lecture seule. Tout ce qui lit fonctionne quand même.

La recherche approfondie n'est pas le chemin. Ce mode attend un serveur construit autour de deux outils génériques, alors que Kops en publie des nommés : il se connectera sans rien trouver à appeler.

#Ce que vous approuvez

Quel que soit l'assistant, la dernière étape est un écran Kops, et c'est celui qui mérite d'être lu plutôt que cliqué. Il nomme trois choses :

• quelle application demande,
• dans quel espace de travail elle agira,
• exactement ce qu'elle aura le droit de faire, une phrase par autorisation.

Approuver accorde cette liste et rien en dehors. Un assistant qui tente ensuite quelque chose que la liste ne couvrait pas est refusé — aucun réglage n'élargit une connexion après coup, et l'assistant n'a aucun moyen d'en demander plus sans vous renvoyer sur cet écran.

#Vérifier que ça marche

Demandez quelque chose que vous pouvez vérifier en une seconde, en langage naturel :

liste mes filtres

Vous devez récupérer vos propres filtres, depuis l'espace que vous avez choisi. Si l'assistant répond depuis ses connaissances générales à la place — en décrivant ce qu'est un filtre, ou en inventant des noms plausibles — il n'est pas réellement connecté. Vérifiez que le connecteur est activé pour cette conversation avant de conclure à un échec.

#Se déconnecter

Deux endroits, et ils ne font pas la même chose.

Dans Kops — Paramètres → Connexions. Déconnectez là et toutes les créances de l'application cessent de fonctionner immédiatement, pas à la fin d'une session. C'est celui-là qu'il faut utiliser si quelque chose ne va pas.

Dans votre assistant. Y retirer le connecteur l'empêche de proposer les outils, mais c'est une modification de la configuration de votre assistant, pas de ce que Kops accepte. Faites les deux quand vous en avez fini avec un assistant ; faites celui de Kops en premier quand ça presse.

#En cas de problème

L'assistant ne voit pas du tout le connecteur. Sur ChatGPT c'est généralement le plan ou l'administrateur de l'espace, pas une erreur dans l'adresse — voir l'avertissement ci-dessus. Sur Claude Free, vérifiez que votre unique connecteur n'est pas déjà pris par autre chose.

L'identification passe, puis rien. Vous avez approuvé dans un navigateur où vous étiez connecté à un autre compte Kops que celui attendu. Déconnectez-vous, reconnectez le connecteur, et lisez le nom de l'espace sur l'écran d'approbation.

Ça se connecte mais tout est refusé. La connexion est liée à un espace où votre rôle n'a pas la permission utilisée. L'écran d'approbation montrait la liste des autorisations ; c'est votre rôle qui décide lesquelles aboutissent vraiment.

Un outil que vous attendiez est absent. Il ne faisait pas partie de ce que vous avez approuvé, ou il n'existe pas. La liste complète est sur ce que votre assistant peut faire — regardez-y d'abord, puis déconnectez et reconnectez pour revoir l'écran d'approbation.