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_projectattend 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
/mcpsont vérifiées pour leur origine : une origine opaquenullest 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
Connecter votre assistant
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."
Cursor
L'en-tête statique est le chemin le plus simple. Cursor peut également utiliser OAuth (il prend en charge l'enregistrement dynamique des clients) — pour cela, supprimez le bloc headers.
Étapes : 1) ajoutez le serveur à ~/.cursor/mcp.json (ci-dessous), 2) définissez FLOWMINGO_API_KEY avec votre clé complète dans votre profil shell, 3) quittez Cursor et relancez-le depuis un terminal où la variable est définie, 4) dans Paramètres → MCP, désactivez puis réactivez le serveur pour le recharger.
Cursor doit pouvoir voir la variable. Cursor lit ${env:FLOWMINGO_API_KEY} depuis son propre environnement. S'il est lancé depuis le dock ou le menu Démarrer, il ne voit souvent pas une variable définie dans votre profil de terminal, et l'en-tête arrive alors vide ou non développé, et le serveur répond Missing credential. Si le lancement de Cursor depuis un terminal n'est pas pratique, remplacez ${env:FLOWMINGO_API_KEY} dans le fichier par votre clé complète (et gardez ~/.cursor/mcp.json hors de git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth à la place — supprimez le bloc headers ; Cursor exécute l'enregistrement dynamique des clients et ouvre une page de consentement dans le navigateur à la première connexion :
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Vérifiez que cela fonctionne — demandez : "liste mes offres d'emploi ouvertes."
Les outils apparaissent uniquement dans Copilot Chat → Mode Agent. La clé racine est servers (pas mcpServers) et le type est http. Le chemin de clé demandée ci-dessous est la configuration fiable.
Étapes : 1) créez .vscode/mcp.json (ou exécutez MCP : Ajouter un serveur → HTTP), 2) lorsque vous démarrez le serveur, VS Code vous demande votre clé (elle n'est pas écrite dans le fichier), 3) utilisez-la en Mode Agent.
{
"servers": {
"flowmingo": {
"type": "http",
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${input:flowmingo_key}" }
}
},
"inputs": [
{ "id": "flowmingo_key", "type": "promptString", "description": "Flowmingo API key (fl_...)", "password": true }
]
}
VS Code peut également tenter OAuth, mais la configuration OAuth documentée attend un ID client ; utilisez le chemin de clé demandée ci-dessus pour une configuration fiable.
Vérifiez que cela fonctionne — demandez : "listez mes offres d'emploi ouvertes."
Les deux utilisent la même interface utilisateur de connecteurs et le même flux de copier-coller d'URL. OAuth uniquement (il n'y a pas de champ d'en-tête dans l'interface).
Étapes (web ou bureau) :
- Ouvrez Paramètres → Connecteurs et cliquez sur Ajouter un connecteur personnalisé.
- Nommez-le
Flowmingoet collez l'URL du serveur MCP ci-dessus. Laissez Avancé → ID client OAuth / Secret vides. - Cliquez sur Ajouter → Connecter. Sur la page de consentement Flowmingo, collez votre clé API
fl_et autorisez. - Vérifiez — demandez à Claude : "listez mes offres d'emploi ouvertes."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Équipe / Entreprise : un Propriétaire l'ajoute une fois sous Paramètres de l'organisation → Connecteurs → Personnalisé ; les membres cliquent ensuite sur Connecter.
Besoin d'une clé statique sur Claude Desktop à la place ? Utilisez l'onglet Tout client (mcp-remote).
Votre navigateur ouvre une page de consentement Flowmingo lors de la première connexion — collez votre clé API et autorisez. Pour vous déconnecter plus tard, supprimez cette clé API dans Paramètres → Intégrations → Clés API.
ChatGPT & OpenAI Codex CLI
Les deux sont OpenAI. ChatGPT utilise le mode Développeur pour les connecteurs personnalisés (OAuth uniquement) ; Codex se connecte nativement depuis le CLI.
ChatGPT (web)
- Sur chatgpt.com (Plus / Pro / Business / Enterprise / Edu — pas mobile), ouvrez Paramètres → Applications → Avancé et activez le mode Développeur.
- Applications → Créer → nommez
Flowmingo, collez l'URL ci-dessous, transport Streamable HTTP, authentification OAuth. - Ouvrez le brouillon, activez les outils, puis Actualisez.
- Joignez-le via le menu + dans une conversation.
Connector URL: https://mcp.flowmingo.ai/mcp
Transport: Streamable HTTP
Auth: OAuth (leave any static OAuth client ID / secret blank — Flowmingo uses Dynamic Client Registration)
Le mode Développeur de ChatGPT se connecte uniquement via OAuth — il n'accepte pas un en-tête statique x-api-key / clé API personnalisée. Les connecteurs simples et de recherche approfondie utilisent uniquement search + fetch (vous disposez des deux). Les outils d'écriture (invitation / déplacement / rejet) nécessitent le mode Développeur. Une invite que ChatGPT affiche avant d'exécuter un outil est propre à ChatGPT et ne constitue pas une approbation de Flowmingo : une invitation, un rejet et un déplacement vers une étape qui envoie un e-mail au candidat attendent toujours qu'une personne les approuve via un lien Flowmingo.
OpenAI Codex CLI
Aucun pont nécessaire — Codex parle Streamable HTTP nativement.
# ~/.codex/config.toml — static fl_ key as a bearer (simplest)
[mcp_servers.flowmingo]
url = "https://mcp.flowmingo.ai/mcp"
bearer_token_env_var = "FLOWMINGO_API_KEY" # export FLOWMINGO_API_KEY=fl_...
startup_timeout_sec = 20
tool_timeout_sec = 120
# Static API key (bearer from env) — simplest:
codex mcp add flowmingo --url https://mcp.flowmingo.ai/mcp --bearer-token-env-var FLOWMINGO_API_KEY
# export FLOWMINGO_API_KEY=fl_... (or set it in ~/.codex/config.toml [mcp_servers.flowmingo])
# OAuth instead (no key stored):
codex mcp add flowmingo --url https://mcp.flowmingo.ai/mcp
codex mcp login flowmingo
codex mcp list
Vérifiez que cela fonctionne — demandez : "Listez mes offres d'emploi ouvertes."
Le Gemini CLI (et le mode agent Gemini Code Assist) accèdent à un serveur MCP distant via ~/.gemini/settings.json. L'application Gemini grand public ne peut pas ajouter de connecteurs MCP personnalisés — ce chemin est réservé à la CLI / Code Assist.
Étapes : 1) ajoutez le serveur sous mcpServers dans ~/.gemini/settings.json, 2) exportez FLOWMINGO_API_KEY=fl_..., 3) exécutez gemini et /mcp pour confirmer que les outils sont listés.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl sélectionne le HTTP Streamable natif. Le placeholder ${FLOWMINGO_API_KEY} est développé à partir de votre environnement, donc aucune clé brute n'est écrite dans le fichier. Préférez OAuth ? Gemini CLI peut le faire nativement — supprimez le bloc headers et ajoutez "authProviderType": "dynamic_discovery" à l'entrée du serveur. La CLI détecte le défi 401, découvre nos métadonnées OAuth et effectue l'enregistrement dynamique de client par elle-même (aucun ID client à définir).
Vérifiez que cela fonctionne — dans
gemini, demandez : "listez mes offres d'emploi ouvertes."
Autres clients — Windsurf · Zed · Cline · Continue · Antigravity
Chaque client ci-dessous fonctionne avec le même serveur — la plupart prennent en charge OAuth et un en-tête statique. Les extraits utilisent une clé statique via une variable d'environnement ; supprimez les headers pour laisser un client exécuter OAuth s'il le prend en charge. Attention aux pièges sur les noms de clés spécifiques à chaque client.
Google Antigravity
Ajoutez https://mcp.flowmingo.ai/mcp comme serveur MCP distant et choisissez de l'authentifier : une page Flowmingo s'ouvre et demande votre clé API complète (voir À quoi ressemble une clé complète dans la section Authentification ci-dessus). Chaque interface Antigravity (l'IDE, la CLI) se connecte séparément. Dans mcp_config.json d'Antigravity, l'adresse va sous serverUrl, et une clé statique va dans un bloc headers comme Authorization avec Bearer et votre clé complète, comme dans les exemples MCP d'Antigravity de Google. Nous n'avons pas pu tester toutes les versions d'Antigravity, donc si vos menus diffèrent, le guide de Google contient les étapes actuelles.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf accepte serverUrl ou url, et prend en charge OAuth (omettre headers pour le déclencher).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — la clé est context_servers ; omettez headers pour OAuth natif. Définissez FLOWMINGO_API_KEY=fl_... dans votre environnement plutôt que de coller une clé brute.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Servers → Configure — définissez type: "streamableHttp" (camelCase), sinon il utilise par défaut SSE obsolète.
{ "mcpServers": { "flowmingo": {
"type": "streamableHttp",
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" },
"disabled": false, "autoApprove": []
} } }
Continue.dev
~/.continue/config.yaml — connectez-vous via le pont mcp-remote. Définissez FLOWMINGO_AUTH_HEADER = Bearer fl_YOUR_KEY.
name: Flowmingo MCP
version: 0.0.1
schema: v1
mcpServers:
- name: Flowmingo
command: npx
args: ["-y", "mcp-remote", "https://mcp.flowmingo.ai/mcp", "--transport", "http-only", "--header", "Authorization:${{ secrets.FLOWMINGO_AUTH_HEADER }}"]
Vérifiez que cela fonctionne — demandez : "Listez mes offres d'emploi ouvertes."
Tout client (mcp-remote)
Pour tout client stdio uniquement (ou un futur client sans transport distant natif), faites le pont avec Flowmingo à l'aide de la commande stdio mcp-remote. --transport http-only est requis — le serveur ne prend pas en charge SSE.
Étapes : 1) assurez-vous que Node ≥ 18, 2) exécutez le pont comme commande stdio dans votre client, 3) lors du premier lancement OAuth, le navigateur s'ouvre — collez votre clé.
# Bare terminal — OAuth, caches the token in ~/.mcp-auth:
npx -y mcp-remote https://mcp.flowmingo.ai/mcp --transport http-only
# Static key (no browser): --header on its own arg is fine
npx -y mcp-remote https://mcp.flowmingo.ai/mcp --transport http-only \
--header "x-api-key: fl_YOUR_KEY"
{
"mcpServers": {
"flowmingo": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.flowmingo.ai/mcp",
"--transport", "http-only", "--header", "x-api-key:${FLOWMINGO_KEY}"],
"env": { "FLOWMINGO_KEY": "fl_YOUR_KEY" }
}
}
}
Secours : si l'authentification reste bloquée, exécutez rm -rf ~/.mcp-auth et réessayez. Remplacez fl_YOUR_KEY par votre clé complète (voir À quoi ressemble une clé complète dans la section Authentification ci-dessus). Dans un args[] JSON, évitez un espace après les deux-points de l'en-tête (particularité d'échappement npx).
Vérifiez que cela fonctionne — demandez : "Listez mes offres d'emploi ouvertes."