Intégrations

Connecter les assistants IA (MCP)

Connectez n'importe quel assistant IA compatible MCP — Claude, Claude Code, ChatGPT, Cursor, VS Code, et plus encore — à vos données de recrutement Flowmingo, et gérez votre pipeline en langage clair.

Our team is online
Besoin d'aide pour l'intégration ?

Bloqué à une étape ou besoin d'assistance technique ? Notre équipe se fera un plaisir de vous aider — contactez-nous à tout moment et nous vous mettrons en relation.

Aperçu

Connectez n'importe quel assistant IA compatible MCP à vos données de recrutement Flowmingo — lisez vos offres d'emploi et vos candidats et effectuez des actions protégées (inviter, déplacer, rejeter, retirer d'un projet), en toute sécurité, avec votre permission. Avec deux permissions supplémentaires que vous activez vous-même, un assistant peut également créer des projets de recrutement et des évaluations, ainsi que publier, clôturer ou promouvoir une offre d'emploi (voir Ce que vous pouvez faire). Nouveau à MCP ? C'est la norme ouverte qui permet aux assistants IA de communiquer avec des outils comme Flowmingo. Apprenez ce qu'est MCP.

Transport : Streamable HTTP (le transport moderne à distance). Il n'y a pas de SSE hérité — pointez toujours votre client vers /mcp, jamais vers /sse.

Traitez votre clé API comme un mot de passe. Préférez OAuth, une saisie invitée, ou une variable d'environnement plutôt que de coller une clé brute fl_... dans un fichier que vous pourriez commiter dans git (par exemple .vscode/mcp.json, ~/.cursor/mcp.json, votre configuration Continue).

Authentification — deux options

A — Connectez-vous avec Flowmingo (OAuth, recommandé). Votre navigateur ouvre une page de consentement Flowmingo ; vous y collez votre clé API. L'assistant ne reçoit jamais votre clé brute. Il reçoit un jeton d'accès et un jeton d'actualisation, qu'il peut utiliser pour obtenir un nouveau jeton d'accès. La connexion ne dure pas éternellement. Le jeton d'actualisation vit environ 30 jours par défaut, à compter de sa délivrance, à la connexion ou à la dernière actualisation, donc une connexion inutilisée pendant environ cette durée expire, et une version de Flowmingo qui modifie la façon dont les connexions sont stockées peut également exiger que vous vous reconnectiez. L'assistant vous demande alors de vous reconnecter et vous recollez votre clé. Pour couper plus tôt, supprimez cette clé API. Il n'y a pas d'identifiant client ou de secret à créer (Flowmingo utilise l'enregistrement dynamique de client). Sur les clients qui affichent les paramètres OAuth "Avancés" (par exemple Claude.ai), laissez le champ Identifiant client et Secret vide.

B — Clé API statique (en-tête). Envoyez votre clé comme l'un des en-têtes suivants :

x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY

Obtenez votre clé dans Flowmingo → Paramètres → Intégrations → Clés API. Cochez Read hiring data et Read candidates — la première couvre les offres, le pipeline et les résultats, la seconde permet à un assistant de rechercher une personne. Ajoutez Manage pipeline / Invite candidates pour les actions d'écriture protégées. Pour permettre à un assistant de créer des projets et des évaluations et de publier ou promouvoir une offre d'emploi, cochez également Create hiring projects et Create assessments. Lisez Créer et publier sous Ce que vous pouvez faire d'abord : ces deux permissions sont facultatives, et le créateur de la clé doit être un propriétaire ou un administrateur.

À quoi ressemble une clé complète. Une longue valeur : fl_live_, le nom public de la clé, un point, puis un long secret. La moitié secrète est affichée une seule fois, juste après la création de la clé ; plus tard, la liste des clés API n'affiche que son début. Une valeur sans point n'est que le nom de la clé et sera refusée. Partout où ce guide écrit fl_YOUR_KEY, remplacez le tout par votre clé complète, sans guillemets ni espaces.

Si cela ne se connecte pas. Une clé incorrecte ou vide renvoie Missing credential ou The Flowmingo API key was rejected ; les deux peuvent signifier que la valeur ne nous est jamais parvenue en entier, vérifiez donc la valeur d'abord. Un paramètre tel que ${env:FLOWMINGO_API_KEY} ne fonctionne que si le programme peut voir cette variable, et un éditeur ouvert depuis le dock ou le menu Démarrer ne lit souvent pas votre profil de terminal. Démarrez-le depuis un terminal où la variable est définie, ou mettez votre clé complète dans le fichier (et gardez ce fichier hors de git).

Laquelle choisir ? La plupart des clients prennent en charge les deux ; quelques-uns (par exemple ChatGPT) sont OAuth uniquement — chaque onglet indique ce que ce client prend en charge. En général, OAuth convient aux assistants interactifs (Claude.ai, ChatGPT, VS Code) ; l'en-tête de clé API convient aux CLI, aux environnements headless/CI et aux éditeurs où vous préférez insérer une clé.

Ce que vous pouvez faire

Les lectures ne nécessitent pas d'approbation. La plupart des écritures sont protégées. Une invitation, un rejet fait avec l'action Rejeter, un retrait de candidats d'un projet, une suppression de projet, ou, normalement, un déplacement vers une étape configurée pour envoyer un e-mail au candidat attend qu'une personne l'approuve via un lien, connectée à Flowmingo. L'assistant ne peut pas l'approuver, et un oui tapé dans le chat ne compte pas. Le paramètre d'e-mail de l'étape est vérifié lorsque le déplacement est demandé. Pour une note, une évaluation, une liste de présélection, une étiquette ou un déplacement vers une étape non configurée pour envoyer un e-mail au candidat, l'assistant est invité à vous montrer un aperçu d'abord et à ne procéder que lorsque vous êtes d'accord, ce qui est une instruction pour lui, pas un verrou. Une invite que votre client IA affiche avant d'exécuter un outil est propre au client et ne constitue pas une approbation de Flowmingo : une invitation, un rejet fait avec l'action Rejeter et un déplacement vers une étape avec envoi d'e-mail attendent toujours le lien d'approbation, quelle que soit la demande du client. Un lien d'approbation expire après 15 minutes, et une seule demande pour plusieurs candidats ou candidatures (au plus 50) est une approbation qui les liste tous. Une fois un changement mis en attente, l'assistant peut vérifier où il en est, le retirer s'il attend toujours, et annuler un changement réversible (une note, une évaluation, une marque de présélection, une étiquette ou un déplacement sans envoi d'e-mail à personne) dans les 24 heures. L'annulation n'est pas toujours disponible : le changement doit revenir avec une référence d'annulation, son enregistrement est au mieux, et un déplacement pour un candidat sans étape antérieure n'en a pas, donc l'assistant doit vérifier et le signaler s'il n'y a pas de retour en arrière. Un e-mail envoyé ne peut pas être annulé. Les outils listés sous Créer et publier sont l'exception à tout cela, sauf delete_project : ils agissent immédiatement et ne sont pas mis en attente pour approbation. Un retrait et une suppression de projet ne peuvent pas être annulés. Tout est limité à votre organisation.

Lecture

Capacité Ce qu'elle fait
Lister les offres d'emploi Parcourir les postes ouverts et fermés de votre organisation.
Lister les ensembles d'entretiens et projets Voir vos évaluations (ensembles d'entretiens) de tous types (entretiens IA, jeux de rôle, tests de compétences, tests techniques, évaluations de CV, vitrines et enregistrements ; questionnaires lorsque vous les demandez) et vos projets de recrutement.
Lister votre pipeline de candidats Voir les candidatures par étape dans un projet.
Lire les résultats d'évaluation et les scores Extraire les résultats de tous types : entretiens IA, jeux de rôle, tests de compétences, tests techniques, évaluations de CV, vitrines, enregistrements et questionnaires. Chaque résultat est étiqueté avec son type. Seuls certains types portent un score IA : une vitrine et un questionnaire ne sont jamais notés, et un test de compétences est un pourcentage.
Rechercher un candidat Récupérer le nom, l'e-mail et le CV d'un candidat.
Rechercher des candidats Trouver des candidats par nom ou e-mail.
Comparer des candidats Aligner 2 à 10 candidats côte à côte. Nécessite la permission Read candidates ainsi que Read hiring data.
Vue d'ensemble du recrutement L'entonnoir pour tout ce que votre connexion peut atteindre (toute l'entreprise, sauf si la clé a été créée par quelqu'un limité à certains projets), ou réduit si vous le demandez : candidatures par étape, actives vs rejetées, et, pour chaque type d'évaluation ayant des résultats, résultats terminés vs en cours et score moyen. Un projet réduit chaque compte, mais ses comptes de résultats couvrent les résultats des évaluations liées à ce projet, donc un candidat d'un autre projet partageant l'une de ces évaluations peut aussi être compté. Une évaluation réduit uniquement les comptes de résultats : les comptes d'étapes et de candidatures restent à tout ce que votre connexion peut atteindre. Les types ne sont jamais additionnés.
Meilleurs candidats Les résultats les mieux classés, ordonnés par score global. Chaque type d'évaluation est classé ensemble sauf si vous demandez un seul type ou une seule évaluation (ensemble d'entretiens).
Détail d'un résultat d'évaluation Les scores par compétence d'un résultat plus le résumé IA, pour les types qui en ont. Un test de compétences, un test technique, une vitrine et un questionnaire en ont peu ou pas.
Détail d'une offre d'emploi Le détail complet d'une seule offre d'emploi.
Une offre d'emploi est-elle ouverte au public ? (get_job_post_publication) Si quelqu'un peut ouvrir la page publique d'une offre d'emploi : en ligne, en attente de la vérification de contenu IA, refusée par celle-ci, signalée, désactivée, ou son projet n'est pas ouvert. Aussi son adresse publique et sa promotion (désactivée, flowmingo ou étendue). Nécessite Read hiring data.
Entretiens à venir Invitations à tout type d'évaluation envoyées ou planifiées et pas encore terminées. Ce n'est pas un compte de toutes les personnes en attente : une invitation dont le candidat a été rappelé, ou a ouvert ou cliqué sur le lien, est laissée de côté jusqu'à ce que le candidat commence, de même qu'une invitation qui n'a pas pu être délivrée.

Écriture (protégée)

Capacité Ce qu'elle fait
Inviter des candidats à une évaluation Prépare les invitations pour un entretien IA, un jeu de rôle, un test de compétences ou un test technique, et attend qu'une personne les approuve via un lien. Rien n'est envoyé avant. Une évaluation et au plus 50 candidats par demande ; un test de compétences ou un test technique nécessite un projet et un e-mail pour chaque candidat, et un test sponsorisé peut débiter le portefeuille de votre organisation lorsqu'un candidat le commence.
Déplacer un candidat à une autre étape Un déplacement vers une étape configurée pour envoyer un e-mail au candidat attend normalement qu'une personne l'approuve via un lien (le paramètre d'e-mail de l'étape est lu une fois, juste avant le déplacement, donc un paramètre activé à ce moment peut encore laisser un déplacement envoyer un e-mail sans approbation). Tout autre déplacement : l'assistant est invité à prévisualiser et attendre votre oui, et il peut généralement être annulé pendant 24 heures, lorsqu'il est revenu avec une référence d'annulation. Au plus 50 candidatures par demande.
Rejeter une candidature Demande une approbation via un lien. Si une personne approuve, Flowmingo tente de déplacer la candidature vers l'étape Rejeté du projet ; vérifiez le résultat ensuite. Au plus 50 candidatures par demande.
Retirer des candidats d'un projet (remove_application) Nécessite Manage pipeline. Demande une approbation via un lien. Si une personne approuve, Flowmingo supprime les candidatures du projet ; le profil du candidat reste dans votre vivier de talents et dans d'autres projets. Ce n'est pas un rejet, et il n'y a pas d'annulation. Au plus 50 candidatures par demande.
Ajouter une note à un résultat L'assistant est invité à prévisualiser la note proposée et attendre votre oui avant de l'enregistrer. Une note appartient à un résultat d'évaluation (de tout type), pas au candidat dans son ensemble.
Noter un résultat L'assistant est invité à prévisualiser la note et attendre votre oui. La note s'applique à un résultat d'évaluation.
Mettre un résultat en présélection L'assistant est invité à prévisualiser le changement de présélection et attendre votre oui. Il s'applique à un résultat d'évaluation.
Étiqueter / ajouter à une collection de talents L'assistant est invité à prévisualiser le changement d'étiquette ou de collection de talents et attendre votre oui.
Vérifier, retirer ou annuler un changement Vérifier où en est un changement mis en attente (en attente, effectué, échoué, expiré ou remplacé par une demande plus récente), retirer un changement qui attend encore l'approbation, ou annuler un changement réversible dans les 24 heures, lorsqu'il est revenu avec une référence d'annulation.

Créer et publier (agit immédiatement, sauf suppression de projet)

Ces outils créent des éléments et les rendent publics. Ils se comportent différemment des écritures protégées ci-dessus :

  • Ils agissent immédiatement, sauf delete_project. Rien n'est mis en attente pour qu'une personne approuve via un lien, et aucun d'eux n'envoie d'e-mail à un candidat. delete_project attend qu'un propriétaire ou un administrateur l'approuve via un lien.
  • Le créateur de la clé doit être un propriétaire ou un administrateur, pour chaque outil ici, sauf l'annulation, qui nécessite seulement Invite candidates. Les outils agissent avec les permissions de la personne qui a créé la clé API. Si cette personne est un membre, l'appel est refusé.
  • Deux autorisations sont facultatives. Create hiring projects et Create assessments ne sont pas accordées par défaut. Avec la connexion (option A), l'assistant ne les obtient que si deux conditions sont réunies : le client les liste par leur nom lors de la connexion, et la clé API que vous collez sur la page de consentement les possède. Un client qui n'envoie pas de liste d'autorisations reçoit les quatre autorisations standard (Read hiring data, Read candidates, Manage pipeline, Invite candidates) détenues par la clé, et aucune de ces deux, donc l'assistant ne voit pas les outils qui en ont besoin. Avec une clé statique (option B), l'assistant voit ces outils quelles que soient les autorisations de la clé, et Flowmingo refuse tout appel que la clé n'autorise pas.
  • Certains appels prennent du temps. La publication attend la vérification de contenu IA, jusqu'à environ 90 secondes. La création d'un projet ou d'une évaluation utilise la génération IA et peut prendre plus de temps (un test technique prend 3 à 9 minutes). Lorsque la réponse indique que le travail est encore en attente, l'assistant rappelle avec la même clé d'idempotence pour lire où il en est. Une nouvelle tentative ne crée jamais un deuxième projet ou évaluation.
Capacité Ce qu'elle fait
Créer un projet de recrutement (create_project) Nécessite Create hiring projects (facultative). Crée un projet avec ses quatre étapes par défaut et une offre d'emploi rédigée par la même IA que le tableau de bord, à partir d'un titre, du poste et d'une description facultative. Par défaut, il crée également une évaluation de CV et un entretien IA ; l'assistant peut nommer d'autres évaluations, ou aucune. L'offre d'emploi est activée et devient publique une fois que la vérification de contenu IA l'approuve, normalement en une minute. Limité à 10 projets par minute et 300 par jour pour votre entreprise. La clé d'idempotence est facultative : lorsqu'elle est omise, une est créée à partir des arguments, donc une nouvelle tentative ne crée jamais un deuxième projet.
Créer une évaluation (create_assessment) Nécessite Create assessments (facultative). Crée une évaluation avec l'IA : un entretien IA, une évaluation de CV, un test de compétences, une vitrine, un test technique ou un jeu de rôle, à partir d'un titre de poste et d'une description facultative, nom, projet et langue (une étiquette telle que en ou vi-VN ; un test de compétences et un test technique ignorent la langue). Attachez-la à un projet afin que des candidats puissent être invités à un test de compétences, un test technique ou une vitrine. La clé d'idempotence est facultative, comme ci-dessus.
Publier une offre d'emploi (publish_job_post) Nécessite Create hiring projects. Active l'offre d'emploi et s'assure que la vérification de contenu IA a été effectuée. La réponse indique si la page est en ligne maintenant, en attente de la vérification, ou refusée par celle-ci. Le projet de recrutement doit être actif.
Dépublier une offre d'emploi (unpublish_job_post) Nécessite Create hiring projects. Désactive l'offre d'emploi, donc son lien public cesse de s'ouvrir. Par défaut, la promotion est également désactivée (withdraw_boost est vrai).
Promouvoir une offre d'emploi (boost_job_post) Nécessite Create hiring projects. Définit la promotion sur off, flowmingo ou extended. La promotion est gratuite. L'augmenter nécessite que l'offre d'emploi soit activée, que son projet soit actif, un logo et une description d'entreprise, et la vérification de contenu IA ; une entreprise peut augmenter 50 promotions par jour.
Ouvrir, brouillon ou archiver un projet (set_project_state) Nécessite Create hiring projects. Déplace un projet de recrutement entre active, draft et archived. Les statuts « brouillon » et « archivé » ferment le lien de candidature. Les données des candidats sont conservées.
Annuler une invitation planifiée (cancel_scheduled_invite) Nécessite Invite candidates. Annule une invitation planifiée pour plus tard et pas encore envoyée, en utilisant l'identifiant d'invitation du résultat d'invitation. Personne n'est contacté par e-mail. La personne reste dans votre compte et sur le tableau du projet.
Supprimer un projet de recrutement (delete_project) Nécessite Create hiring projects (facultative). Il ne fait que demander : il ne supprime pas immédiatement, il demande une approbation via un lien, et rien n'est supprimé tant qu'un propriétaire ou un administrateur ne l'approuve pas. Seul un projet actif peut être supprimé. Si une personne approuve, Flowmingo supprime le projet et ses offres d'emploi ; ses candidatures ne sont pas supprimées une par une, et les profils et contacts des candidats, vos évaluations et liens d'invitation sont conservés. Il n'y a pas d'annulation.

Sécurité et confiance

  • Vos données sont limitées à l'organisation — l'assistant ne peut jamais voir les données d'une autre entreprise.
  • Avec OAuth, l'assistant ne reçoit jamais votre clé API. Il obtient un jeton d'accès qui expire après une heure, actualisé en arrière-plan tant qu'il reste connecté. La connexion elle-même dure aussi longtemps que son jeton d'actualisation, environ 30 jours par défaut à compter de sa délivrance ou de sa dernière actualisation, donc elle expire après environ 30 jours sans utilisation, et vous vous reconnectez alors. Avec un en-tête statique (option B), le client de votre assistant détient votre clé et l'envoie avec chaque demande, alors gardez-la hors des fichiers que vous pourriez partager ou commiter.
  • Couper un assistant : supprimez la clé API avec laquelle vous l'avez autorisé, dans Paramètres → Intégrations → Clés API. L'accès s'arrête immédiatement. Il n'y a pas encore de déconnexion par assistant, donc si vous voulez révoquer un à un, donnez à chaque assistant sa propre clé.
  • Les demandes vers le point de terminaison /mcp sont vérifiées pour leur origine : une origine opaque null est toujours refusée, et la vérification peut être verrouillée sur une liste blanche, mais par défaut chaque origine réelle est acceptée, donc la protection est votre identifiant, pas l'origine. Chaque session est liée à l'identifiant qui l'a ouverte.

Pour savoir comment vous authentifier, voir Authentification — deux options ; pour les lectures exactes, les écritures protégées et les actions immédiates, voir Ce que vous pouvez faire. Lorsque vous êtes prêt, passez à Connectez votre assistant et choisissez votre client.

URL du serveur MCP

URL du serveur MCPhttps://mcp.flowmingo.ai/mcp

Connecter votre assistant

Quel assistant utilisez-vous ?

Claude Code (CLI)

Une seule commande ajoute Flowmingo sur Streamable HTTP natif. Commencez par OAuth ; l'option statique --header est l'alternative.

Étapes : 1) ajoutez le serveur, 2) connectez-vous (navigateur → collez la clé), 3) claude mcp list pour vérifier.

# OAuth (recommended) — flags BEFORE the name:
claude mcp add --transport http flowmingo https://mcp.flowmingo.ai/mcp
claude mcp login flowmingo          # browser opens; paste your fl_ key on the consent page

# Static API key instead (pick ONE header):
claude mcp add --transport http flowmingo https://mcp.flowmingo.ai/mcp \
  --header "x-api-key: fl_YOUR_KEY"
# or: --header "Authorization: Bearer fl_YOUR_KEY"

# Share with a repo team (writes a git-committable .mcp.json):
claude mcp add --transport http --scope project flowmingo https://mcp.flowmingo.ai/mcp

claude mcp list && claude mcp get flowmingo

Piège : les options doivent être placées avant le nom, et utilisez toujours --transport http (jamais sse). Remplacez fl_YOUR_KEY par votre clé complète (voir À quoi ressemble une clé complète dans la section Authentification ci-dessus).

Vérifiez que cela fonctionne — demandez : "liste mes offres d'emploi ouvertes."