LetsFindWhy

Agents et API

Un agent est un assistant IA qui travaille dans LetsFindWhy en votre nom : Claude Code, une routine Claude planifiée, un assistant d'éditeur, ou tout autre outil qui parle le Model Context Protocol (MCP). Donnez-lui une clé d'API et il peut créer des projets, rédiger des guides d'entretien, inviter des répondants et lire transcriptions et insights depuis un chat, avec exactement les accès que vous avez.

Tout ce qu'un agent peut faire, vous pouvez aussi le faire vous-même avec de simples appels HTTP à l'API REST. Les deux utilisent la même clé.

Comment créer une clé d'API

  1. Ouvrez Paramètres et trouvez la carte Clés d'API.
  2. Créez une clé et donnez-lui un nom qui dit quel agent la détiendra, par exemple « Claude Code sur mon portable ». Une clé par agent permet d'en révoquer une sans déranger les autres.
  3. Copiez la clé tout de suite. Elle commence par mtg_ et n'est affichée qu'une seule fois ; si vous la perdez, supprimez-la et créez-en une autre.

Une clé est la vôtre, pas celle d'une organisation. Un agent qui la détient voit toutes les organisations dont vous êtes membre, avec le rôle que vous y avez, et tout ce qu'il fait est enregistré comme fait par vous. Traitez la clé comme un mot de passe et révoquez-la dès que vous cessez d'utiliser l'agent. Une connexion établie par identification a la même portée qu'une clé et, comme une clé, elle survit à la déconnexion et au changement de mot de passe. La déconnecter est une étape distincte, décrite ci-dessous.

Comment connecter claude.ai

claude.ai se connecte par une URL et une identification, sans aucune clé à coller. Une connexion établie dans claude.ai couvre aussi Claude Desktop et les applications mobiles Claude.

  1. Dans claude.ai, ouvrez Paramètres, puis Connecteurs, et choisissez Ajouter un connecteur personnalisé.
  2. Saisissez https://letsfindwhy.com/api/mcp comme URL, exactement comme elle est écrite et sans barre oblique finale, et laissez l'ID client et le secret vides.
  3. Choisissez Connecter. LetsFindWhy vous demande de vous identifier si ce n'est pas déjà fait, puis montre ce que la connexion peut faire ; choisissez Autoriser.

Pour mettre fin à une connexion, ouvrez Paramètres dans LetsFindWhy et choisissez Déconnecter dans la carte Agents connectés. C'est la seule façon de la révoquer : retirer le connecteur dans Claude empêche Claude de l'utiliser, mais un connecteur ajouté à nouveau plus tard se reconnecte directement. Retirez-le aux deux endroits pour que Claude cesse de vous demander de vous identifier à nouveau.

Comment connecter Claude Code

Claude Code peut s'identifier de la même façon. Exécutez ceci une fois, puis tapez /mcp dans Claude Code et choisissez Authenticate ; une fenêtre de navigateur s'ouvre pour l'identification. C'est une connexion distincte de celle que détient claude.ai, et elle apparaît séparément dans les Paramètres.

claude mcp add --transport http letsfindwhy https://letsfindwhy.com/api/mcp

Pour les scripts, l'utilisation sans interface ou tout client qui permet de définir un en-tête de requête, collez plutôt une clé :

claude mcp add --transport http letsfindwhy https://letsfindwhy.com/api/mcp --header "Authorization: Bearer mtg_..."

Claude Code liste alors un outil par action possible dans LetsFindWhy, nommé d'après ce qu'il fait : create_project, create_discussion_guide_with_questions, invite_recruited_respondents_to_session, get_session_transcript, et ainsi de suite. Demandez ce que vous voulez en langage courant et il choisit les outils.

Cursor, les scripts et les autres clients qui permettent de définir un en-tête de requête fonctionnent de la même façon. Les annuaires de connecteurs de claude.ai et Claude Desktop ne peuvent pas envoyer d'en-tête ; ils se connectent plutôt par URL et identification, comme décrit ci-dessus.

Ce qu'un agent peut et ne peut pas faire

Un agent travaille comme vous. Il prépare et lit la recherche ; il ne mène pas d'entretiens et ne gère pas votre équipe.

Il peut :

  • Créer et mettre à jour des organisations, projets, processus, guides d'entretien et questionnaires de sélection.
  • Gérer le recrutement : ouvrir et fermer des liens d'inscription, ajouter des répondants à la main et les inviter à des sessions.
  • Préparer des sessions à l'avance : les créer, modifier leurs paramètres, attribuer un guide et modifier ses questions.
  • Lire les résultats : enregistrements, transcriptions, réponses, insights IA et utilisation.

Il ne peut pas :

  • Toucher à un entretien en direct. Démarrer, terminer, admettre des personnes, les retirer, et convoquer ou congédier le modérateur IA restent aux mains des personnes dans la salle.
  • Changer qui fait partie de votre organisation : il ne peut pas modifier les rôles, retirer des membres, transférer la propriété, quitter ou supprimer l'organisation.
  • Supprimer des enregistrements. Supprimer un enregistrement supprime aussi sa transcription, cela reste donc une décision que vous prenez dans l'application.

La limite est placée là parce qu'un agent lit ce que les répondants ont dit, et un répondant pourrait dire quelque chose conçu pour le manipuler. Quoi qu'il lise, il ne peut pas vous exclure de votre propre organisation ni effacer votre recherche.

Supprimer un projet, une session, un processus, un guide ou un questionnaire de sélection est autorisé. Les projets et les sessions peuvent être restaurés pendant 30 jours, et votre agent vous demandera confirmation avant toute suppression.

Comment appeler directement l'API REST

Chaque outil est en dessous un point de terminaison REST. Envoyez votre clé sous la forme Authorization: Bearer mtg_... et parcourez la référence complète, avec chaque point de terminaison et ses paramètres, sur /api/docs une fois connecté.

Les clés sont limitées à de courtes rafales : 60 appels en une seconde sur l'API REST, et environ 30 via MCP, où chaque appel d'outil vérifie la clé deux fois. Aucun agent qui réfléchit n'atteint l'une ou l'autre. Un appel qui dépasse reçoit une réponse 429 indiquant combien de temps attendre.