Overzicht
Verbind elke MCP-compatibele AI-assistent met je Flowmingo wervingsgegevens — lees je vacatures en kandidaten en voer beveiligde acties uit (uitnodigen, verplaatsen, afwijzen, verwijderen uit een project), veilig en met jouw toestemming. Met twee extra rechten die je zelf inschakelt, kan een assistent ook wervingsprojecten en beoordelingen maken en een vacature publiceren, sluiten of promoten (zie Wat je kunt doen). Nieuw bij MCP? Het is de open standaard waarmee AI-assistenten kunnen communiceren met tools zoals Flowmingo. Leer wat MCP is.
Transport: Streamable HTTP (het moderne externe transport). Er is geen legacy SSE — wijs je client altijd naar /mcp, nooit naar /sse.
Behandel je API-sleutel als een wachtwoord. Geef de voorkeur aan OAuth, een invoerprompt of een omgevingsvariabele boven het plakken van een rauwe
fl_...-sleutel in een bestand dat je mogelijk in git plaatst (bijv..vscode/mcp.json,~/.cursor/mcp.json, je Continue-configuratie).
Authenticatie — twee opties
A — Inloggen met Flowmingo (OAuth, aanbevolen). Je browser opent een Flowmingo-toestemmingspagina; daar plak je je API-sleutel. De assistent ontvangt nooit je rauwe sleutel. Hij ontvangt een toegangstoken en een vernieuwingstoken, waarmee hij een nieuw toegangstoken kan krijgen. Het inloggen duurt niet eeuwig. Het vernieuwingstoken leeft standaard ongeveer 30 dagen, gerekend vanaf het moment van uitgifte, bij inloggen of bij de laatste vernieuwing, dus een inlog die ongeveer zo lang ongebruikt blijft, vervalt, en een Flowmingo-release die verandert hoe inlogs worden opgeslagen, kan er ook voor zorgen dat je opnieuw moet inloggen. De assistent vraagt je dan opnieuw in te loggen en je plakt je sleutel opnieuw. Om het eerder te stoppen, verwijder die API-sleutel. Er is geen client-ID of geheim te creëren (Flowmingo gebruikt Dynamic Client Registration). Bij clients die "Geavanceerde" OAuth-instellingen tonen (bijv. Claude.ai), laat de Client-ID en het Geheim leeg.
B — Statische API-sleutel (header). Stuur je sleutel als een van beide headers:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Haal je sleutel op in Flowmingo → Instellingen → Integraties → API-sleutels. Vink Read hiring data en Read candidates aan — de eerste dekt vacatures, pijplijn en resultaten, de tweede is wat een assistent in staat stelt iemand op te zoeken. Voeg Manage pipeline / Invite candidates toe voor de beveiligde schrijfacties. Om een assistent projecten en beoordelingen te laten maken en een vacature te publiceren of promoten, vink ook Create hiring projects en Create assessments aan. Lees eerst Maken en publiceren onder Wat je kunt doen: deze twee rechten zijn opt-in en de maker van de sleutel moet een eigenaar of beheerder zijn.
Hoe een complete sleutel eruitziet. Eén lange waarde: fl_live_, de openbare naam van de sleutel, een punt, dan een lang geheim. Het geheime deel wordt één keer getoond, direct nadat je de sleutel maakt; later toont de API-sleutellijst alleen het begin ervan. Een waarde zonder punt is alleen de naam van de sleutel en wordt geweigerd. Waar deze handleiding fl_YOUR_KEY schrijft, vervang dat alles door je complete sleutel, zonder aanhalingstekens en zonder spaties.
Als het geen verbinding maakt. Een slechte of lege sleutel komt terug als Missing credential of The Flowmingo API key was rejected; beide kunnen betekenen dat de waarde ons nooit volledig heeft bereikt, dus controleer eerst de waarde. Een instelling zoals ${env:FLOWMINGO_API_KEY} werkt alleen als het programma die variabele kan zien, en een editor die vanuit het dock of het Startmenu wordt geopend, leest vaak niet je terminalprofiel. Start het vanuit een terminal waar de variabele is ingesteld, of plaats je complete sleutel in het bestand (en houd dat bestand buiten git).
Welke kiezen? De meeste clients ondersteunen beide; een paar (bijv. ChatGPT) zijn OAuth-only — elk tabblad vermeldt wat die client ondersteunt. Over het algemeen past OAuth bij interactieve assistenten (Claude.ai, ChatGPT, VS Code); de API-sleutelheader past bij CLI's, headless/CI en editors waar je liever een sleutel plaatst.
Wat je kunt doen
Leesbewerkingen hebben geen goedkeuring nodig. De meeste schrijfacties zijn beveiligd. Een uitnodiging, een afwijzing met de Afwijzen-actie, een verwijdering van kandidaten uit een project, een verwijdering van een project, of normaal gesproken een verplaatsing naar een fase die is ingesteld om de kandidaat te e-mailen, wacht op goedkeuring door een persoon via een link, ingelogd bij Flowmingo. De assistent kan dit niet goedkeuren en een ja dat in de chat wordt getypt telt niet. De e-mailinstelling van de fase wordt gecontroleerd wanneer de verplaatsing wordt aangevraagd. Voor een notitie, een beoordeling, een shortlist, een tag of een verplaatsing naar een fase die niet is ingesteld om de kandidaat te e-mailen, krijgt de assistent de opdracht om eerst een voorbeeld te tonen en alleen door te gaan als je akkoord gaat, wat een instructie aan hem is, geen slot. Een prompt die je AI-client toont voordat hij een tool uitvoert, is van de client zelf en is geen goedkeuring van Flowmingo: een uitnodiging, een afwijzing met de Afwijzen-actie en een verplaatsing naar een e-mailfase wachten nog steeds op de goedkeuringslink, wat de client ook vraagt. Een goedkeuringslink vervalt na 15 minuten en één verzoek voor meerdere kandidaten of sollicitaties (maximaal 50) is één goedkeuring die iedereen vermeldt. Zodra een wijziging is klaargezet, kan de assistent controleren waar die staat, deze intrekken terwijl die nog wacht, en een omkeerbare wijziging (een notitie, een beoordeling, een shortlistmarkering, een tag of een verplaatsing die niemand heeft gemaild) binnen 24 uur ongedaan maken. Een ongedaan maken is niet altijd beschikbaar: de wijziging moet terugkomen met een ongedaan-referentie, het registreren ervan is best effort, en een verplaatsing voor een kandidaat zonder eerdere fase heeft er geen, dus de assistent moet controleren en dat melden als er geen weg terug is. Een verzonden e-mail kan niet ongedaan worden gemaakt. De tools onder Maken en publiceren vormen de uitzondering op dit alles, behalve delete_project: ze handelen direct en worden niet klaargezet voor goedkeuring. Een verwijdering en een projectverwijdering kunnen niet ongedaan worden gemaakt. Alles is beperkt tot jouw organisatie.
Lezen
| Mogelijkheid | Wat het doet |
|---|---|
| Vacatures weergeven | Doorzoek de open en gesloten functies van je organisatie. |
| Interview-sets en projecten weergeven | Bekijk je beoordelingen (interview-sets) van elke soort (AI-interviews, rollenspellen, vaardigheidstests, technische tests, CV-evaluaties, showcases en opnamen; vragenlijsten wanneer je erom vraagt) en je wervingsprojecten. |
| Je kandidatenpijplijn bekijken | Bekijk sollicitaties per fase in een project. |
| Beoordelingsresultaten en scores lezen | Haal resultaten van elke soort op: AI-interviews, rollenspellen, vaardigheidstests, technische tests, CV-evaluaties, showcases, opnamen en vragenlijsten. Elk resultaat is gelabeld met zijn soort. Slechts sommige soorten hebben een AI-score: een showcase en een vragenlijst worden nooit gescoord en een vaardigheidstest is een percentage. |
| Kandidaat opzoeken | Haal de naam, het e-mailadres en het CV van één kandidaat op. |
| Kandidaten zoeken | Vind kandidaten op naam of e-mailadres. |
| Kandidaten vergelijken | Zet 2 tot 10 kandidaten naast elkaar. Vereist de Read candidates -machtiging en ook Read hiring data. |
| Wervingsoverzicht | De trechter voor alles wat je verbinding kan bereiken (het hele bedrijf, tenzij de sleutel is gemaakt door iemand die beperkt is tot bepaalde projecten), of versmald wanneer je vraagt: sollicitaties per fase, actief versus afgewezen, en voor elke beoordelingssoort met resultaten, voltooide versus lopende resultaten en de gemiddelde score. Een project versmalt elke telling, maar de resultaatentellingen dekken de resultaten van de beoordelingen die aan dat project zijn gekoppeld, dus een kandidaat van een ander project dat een van die beoordelingen deelt, kan ook worden meegeteld. Een beoordeling versmalt alleen de resultaatentellingen: de fase- en sollicitatietellingen blijven bij alles wat je verbinding kan bereiken. De soorten worden nooit bij elkaar opgeteld. |
| Topkandidaten | De hoogst gerangschikte resultaten, geordend op totale score. Elke beoordelingssoort wordt samen gerangschikt, tenzij je om één soort of één beoordeling (interview-set) vraagt. |
| Beoordelingsresultaatdetails | De per-competentie scores van één resultaat plus de AI-samenvatting, voor de soorten die die hebben. Een vaardigheidstest, een technische test, een showcase en een vragenlijst hebben weinig of geen. |
| Vacaturedetails | De volledige details van één vacature. |
Is een vacature openbaar? (get_job_post_publication) |
Of iedereen de openbare pagina van een vacature kan openen: live, nog wachtend op de AI-inhoudscontrole, geweigerd, gemarkeerd, uitgeschakeld, of het project is niet actief. Ook het openbare adres en de boost (uit, flowmingo of uitgebreid). Vereist Read hiring data. |
| Aankomende interviews | Uitnodigingen voor elke beoordelingssoort die zijn verzonden of gepland en nog niet zijn voltooid. Het is geen telling van iedereen die nog openstaat: een uitnodiging waarvan de kandidaat is herinnerd, of de link heeft geopend of aangeklikt, wordt weggelaten totdat de kandidaat begint, en ook een uitnodiging die niet bezorgd is. |
Schrijven (beveiligd)
| Mogelijkheid | Wat het doet |
|---|---|
| Kandidaten uitnodigen voor een beoordeling | Bereidt de uitnodigingen voor voor een AI-interview, een rollenspel, een vaardigheidstest of een technische test en wacht tot een persoon ze goedkeurt via een link. Er wordt niets verzonden daarvoor. Eén beoordeling en maximaal 50 kandidaten per verzoek; een vaardigheidstest of technische test vereist een project en een e-mailadres voor elke kandidaat, en een gesponsorde kan het wallet van je organisatie debiteren wanneer een kandidaat begint. |
| Kandidaat naar een andere fase verplaatsen | Een verplaatsing naar een fase die is ingesteld om de kandidaat te e-mailen, wacht normaal gesproken op goedkeuring door een persoon via een link (de e-mailinstelling van de fase wordt één keer gelezen, vlak voor de verplaatsing, dus een instelling die op dat moment wordt ingeschakeld, kan nog steeds een verplaatsing mailen zonder goedkeuring). Elke andere verplaatsing: de assistent krijgt de opdracht om die te tonen en te wachten op je ja, en het kan meestal 24 uur ongedaan worden gemaakt, wanneer het terugkwam met een ongedaan-referentie. Maximaal 50 sollicitaties per verzoek. |
| Een sollicitatie afwijzen | Vraagt goedkeuring via een link. Als een persoon goedkeurt, probeert Flowmingo de sollicitatie naar de afgewezen fase van het project te verplaatsen; controleer daarna het resultaat. Maximaal 50 sollicitaties per verzoek. |
Kandidaten uit een project verwijderen (remove_application) |
Vereist Manage pipeline. Vraagt goedkeuring via een link. Als een persoon goedkeurt, verwijdert Flowmingo de sollicitaties uit het project; het profiel van de kandidaat blijft in je talentenpool en in andere projecten. Het is geen afwijzing en er is geen ongedaan maken. Maximaal 50 sollicitaties per verzoek. |
| Een notitie toevoegen aan een resultaat | De assistent krijgt de opdracht om de voorgestelde notitie te tonen en te wachten op je ja voordat hij die opslaat. Een notitie hoort bij één beoordelingsresultaat (van elke soort), niet bij de kandidaat als geheel. |
| Een resultaat beoordelen | De assistent krijgt de opdracht om de beoordeling te tonen en te wachten op je ja. De beoordeling geldt voor één beoordelingsresultaat. |
| Een resultaat op de shortlist zetten | De assistent krijgt de opdracht om de shortlistwijziging te tonen en te wachten op je ja. Het geldt voor één beoordelingsresultaat. |
| Taggen / toevoegen aan talentencollectie | De assistent krijgt de opdracht om de tag- of talentencollectiewijziging te tonen en te wachten op je ja. |
| Een wijziging controleren, intrekken of ongedaan maken | Controleer waar een klaargezette wijziging staat (wachtend, uitgevoerd, mislukt, verlopen of vervangen door een nieuwer verzoek), trek er een in die nog wacht op goedkeuring, of maak een omkeerbare wijziging binnen 24 uur ongedaan, wanneer die terugkwam met een ongedaan-referentie. |
Maken en publiceren (handelt direct, behalve het verwijderen van een project)
Deze tools maken dingen en stellen ze openbaar. Ze gedragen zich anders dan de bovenstaande beveiligde schrijfacties:
- Ze handelen direct, behalve
delete_project. Er wordt niets klaargezet voor goedkeuring door een persoon via een link, en geen van hen mailt een kandidaat.delete_projectwacht tot een eigenaar of beheerder het goedkeurt via een link. - De maker van de sleutel moet een eigenaar of beheerder zijn, voor elke tool hier, behalve het annuleren, waarvoor alleen Invite candidates nodig is. De tools handelen met de rechten van de persoon die de API-sleutel heeft gemaakt. Als die persoon een lid is, wordt de oproep geweigerd.
- Twee machtigingen zijn opt-in. Create hiring projects en Create assessments worden standaard niet verstrekt. Bij aanmelden (optie A) krijgt de assistent ze alleen als aan beide voorwaarden is voldaan: de client noemt ze bij naam bij het verbinden, en de API-sleutel die u op de toestemmingspagina plakt, bevat ze. Een client die geen lijst met machtigingen verstuurt, krijgt de vier standaardmachtigingen (Read hiring data, Read candidates, Manage pipeline, Invite candidates) die de sleutel bevat, en geen van deze twee, dus de assistent ziet de tools die ze nodig hebben niet. Met een statische sleutel (optie B) worden deze tools aan de assistent getoond, ongeacht welke machtigingen de sleutel bevat, en weigert Flowmingo elke aanroep die de sleutel niet toestaat.
- Sommige oproepen duren even. Publiceren wacht op de AI-inhoudscontrole, tot ongeveer 90 seconden. Het maken van een project of beoordeling gebruikt AI-generatie en kan langer duren (een technische test duurt 3 tot 9 minuten). Wanneer het antwoord zegt dat het werk nog in behandeling is, roept de assistent opnieuw aan met dezelfde idempotentiesleutel om te lezen waar het is. Een herhaling maakt nooit een tweede project of beoordeling.
| Mogelijkheid | Wat het doet |
|---|---|
Een wervingsproject maken (create_project) |
Vereist Create hiring projects (opt-in). Maakt een project met de vier standaardfasen en een vacature geschreven door dezelfde AI als het dashboard, op basis van een titel, de functie en een optionele beschrijving. Standaard maakt het ook een CV-evaluatie en een AI-interview; de assistent kan andere beoordelingen noemen, of geen. De vacature wordt ingeschakeld en wordt openbaar zodra de AI-inhoudscontrole hem goedkeurt, normaal binnen een minuut. Beperkt tot 10 projecten per minuut en 300 per dag voor je bedrijf. De idempotentiesleutel is optioneel: wanneer die wordt weggelaten, wordt er een gemaakt van de argumenten, dus een herhaling maakt nooit een tweede project. |
Een beoordeling maken (create_assessment) |
Vereist Create assessments (opt-in). Maakt één beoordeling met de AI: een AI-interview, een CV-evaluatie, een vaardigheidstest, een showcase, een technische test of een rollenspel, op basis van een functietitel en een optionele functiebeschrijving, naam, project en taal (een tag zoals en of vi-VN; een vaardigheidstest en technische test negeren de taal). Koppel het aan een project zodat kandidaten kunnen worden uitgenodigd voor een vaardigheidstest, technische test of showcase. De idempotentiesleutel is optioneel, zoals hierboven. |
Een vacature publiceren (publish_job_post) |
Vereist Create hiring projects. Schakelt de vacature in en zorgt dat de AI-inhoudscontrole is uitgevoerd. Het antwoord zegt of de pagina nu live is, nog wacht op de controle, of erdoor geweigerd. Het wervingsproject moet actief zijn. |
Een vacature depubliceren (unpublish_job_post) |
Vereist Create hiring projects. Schakelt de vacature uit, zodat de openbare link stopt met openen. Standaard wordt de boost ook uitgeschakeld (withdraw_boost is waar). |
Een vacature promoten (boost_job_post) |
Vereist Create hiring projects. Stelt de boost in op off, flowmingo of extended. Promoten is gratis. Verhogen vereist dat de vacature is ingeschakeld, het project actief is, een bedrijfslogo en beschrijving, en de AI-inhoudscontrole; een bedrijf mag 50 boosts per dag verhogen. |
Een project openen, concept of archiveren (set_project_state) |
Vereist Create hiring projects. Verplaatst een aanwervingsproject tussen active, draft en archived. Concept en gearchiveerd sluiten de vacaturelink. Kandidaatgegevens blijven bewaard. |
Een geplande uitnodiging annuleren (cancel_scheduled_invite) |
Vereist Invite candidates. Annuleert een uitnodiging die voor later was gepland en nog niet is verzonden, met behulp van de uitnodigings-id uit het uitnodigingsresultaat. Er wordt niemand gemaild. De persoon blijft in je account en op het projectbord. |
Een wervingsproject verwijderen (delete_project) |
Vereist Create hiring projects (opt-in). Het vraagt alleen: het verwijdert niet direct, het vraagt goedkeuring via een link, en er wordt niets verwijderd totdat een eigenaar of beheerder het goedkeurt. Alleen een actief project kan worden verwijderd. Als een persoon het goedkeurt, verwijdert Flowmingo het project en de vacatures; de sollicitaties worden niet één voor één verwijderd, en kandidaatprofielen en -contacten, je beoordelingen en uitnodigingslinks worden bewaard. Er is geen ongedaan maken. |
Beveiliging & vertrouwen
- Je gegevens zijn organisatiebeperkt — de assistent kan nooit gegevens van een ander bedrijf zien.
- Met OAuth ontvangt de assistent nooit je API-sleutel. Hij krijgt een toegangstoken dat na een uur verloopt, stil vernieuwd terwijl hij verbonden blijft. De inlog zelf duurt zo lang als het vernieuwingstoken, standaard ongeveer 30 dagen vanaf het moment van uitgifte of laatste vernieuwing, dus het vervalt na ongeveer 30 dagen zonder gebruik, en je logt dan opnieuw in. Met een statische header (optie B) houdt de client van je assistent je sleutel vast en stuurt die met elk verzoek, dus houd hem buiten bestanden die je mogelijk deelt of in git plaatst.
- Een assistent afsluiten: verwijder de API-sleutel waarmee je hem hebt geautoriseerd, in Instellingen → Integraties → API-sleutels. Toegang stopt onmiddellijk. Er is nog geen per-assistent verbreken, dus als je ze één voor één wilt intrekken, geef elke assistent dan een eigen sleutel.
- Verzoeken aan het
/mcp-eindpunt worden gecontroleerd op herkomst: een ondoorzichtigenull-herkomst wordt altijd geweigerd, en de controle kan worden vergrendeld op een allowlist, maar standaard wordt elke echte herkomst geaccepteerd, dus de bescherming is je inloggegevens, niet de herkomst. Elke sessie is gebonden aan de inloggegevens die hem hebben geopend.
Voor authenticatie, zie Authenticatie — twee opties; voor de exacte leesbewerkingen, beveiligde schrijfacties en acties die direct plaatsvinden, zie Wat je kunt doen. Wanneer je klaar bent, ga naar Verbind je assistent en kies je client.
MCP-server-URL
Verbind uw assistent
Claude Code (CLI)
Met één opdracht voeg je Flowmingo toe bovenop native Streamable HTTP. Gebruik OAuth als eerste optie; de statische --header is het alternatief.
Stappen: 1) voeg de server toe, 2) log in (browser → plak de sleutel), 3) voer claude mcp list uit om te controleren.
# 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
Let op: vlaggen moeten vóór de naam komen, en gebruik altijd --transport http (nooit sse). Vervang fl_YOUR_KEY door je volledige sleutel (zie Hoe ziet een volledige sleutel eruit in het gedeelte Authenticatie hierboven).
Controleer of het werkt — vraag: "toon mijn openstaande vacatures."
Cursor
De statische header is de eenvoudigste route. Cursor ondersteunt ook OAuth (het ondersteunt Dynamic Client Registration) — daarvoor verwijder je het headers-blok.
Stappen: 1) voeg de server toe aan ~/.cursor/mcp.json (hieronder), 2) stel FLOWMINGO_API_KEY in op je volledige sleutel in je shell-profiel, 3) sluit Cursor af en start het op vanuit een terminal waar de variabele is ingesteld, 4) zet in Instellingen → MCP de server uit en weer aan om te herladen.
Cursor moet de variabele kunnen zien. Cursor leest ${env:FLOWMINGO_API_KEY} uit de eigen omgeving. Als je het vanuit het dock of het Startmenu start, ziet het vaak geen variabele die in je terminal-profiel is ingesteld, en dan komt de header leeg of niet geëxpandeerd aan en antwoordt de server Missing credential. Als het starten van Cursor vanuit een terminal niet praktisch is, vervang dan ${env:FLOWMINGO_API_KEY} in het bestand door je volledige sleutel (en houd ~/.cursor/mcp.json buiten git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth in plaats daarvan — verwijder het headers-blok; Cursor voert Dynamic Client Registration uit en opent bij de eerste verbinding een browser-toestemmingspagina:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Controleer of het werkt — vraag: "toon mijn openstaande vacatures."
VS Code (Copilot, agentmodus)
Tools verschijnen alleen in Copilot Chat → Agentmodus. De hoofdsleutel is servers (niet mcpServers) en het type is http. Het geprompte sleutelpad hieronder is de betrouwbare instelling.
Stappen: 1) maak .vscode/mcp.json aan (of voer MCP: Server toevoegen → HTTP uit), 2) wanneer u de server start, vraagt VS Code om uw sleutel (deze wordt niet in het bestand geschreven), 3) gebruik het in Agentmodus.
{
"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 kan ook OAuth proberen, maar de gedocumenteerde OAuth-configuratie verwacht een client-ID; gebruik het geprompte sleutelpad hierboven voor een betrouwbare instelling.
Verifieer of het werkt — vraag: "list my open jobs."
Claude — claude.ai & Claude Desktop
Beide gebruiken dezelfde Connectors UI en dezelfde plak-de-URL-stroom. Alleen OAuth (er is geen header-veld in de UI).
Stappen (web of desktop):
- Open Instellingen → Connectors en klik op Aangepaste connector toevoegen.
- Noem het
Flowmingoen plak de MCP-server-URL hierboven. Laat Geavanceerd → OAuth Client ID / Secret leeg. - Klik op Toevoegen → Verbinden. Plak op de Flowmingo-toestemmingspagina uw
fl_-API-sleutel en autoriseer. - Verifieer — vraag Claude: "list my open jobs."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Team / Enterprise: een Eigenaar voegt het één keer toe onder Organisatie-instellingen → Connectors → Aangepast; leden klikken vervolgens op Verbinden.
Heeft u toch een statische sleutel nodig op Claude Desktop? Gebruik het tabblad Elke client (mcp-remote).
Uw browser opent een Flowmingo-autorisatiepagina bij de eerste verbinding — plak uw API-sleutel en autoriseer. Om later te ontkoppelen, verwijdert u die API-sleutel in Instellingen → Integraties → API-sleutels.
ChatGPT & OpenAI Codex CLI
Beide zijn van OpenAI. ChatGPT gebruikt Developer Mode voor aangepaste connectors (alleen OAuth); Codex verbindt rechtstreeks vanuit de CLI.
ChatGPT (web)
- Ga op chatgpt.com (Plus / Pro / Business / Enterprise / Edu — niet mobiel) naar Instellingen → Apps → Geavanceerd en zet Developer mode AAN.
- Apps → Maken → naam
Flowmingo, plak de onderstaande URL, transport Streamable HTTP, authenticatie OAuth. - Open de conceptversie, schakel de tools in en klik op Vernieuwen.
- Voeg het toe via het +-menu in een chat.
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)
ChatGPT's Developer Mode verbindt alleen via OAuth — het accepteert geen statische x-api-key / aangepaste API-keyheader. Gewone en deep-research connectors gebruiken alleen search + fetch (je hebt beide). Schrijftools (uitnodigen / verplaatsen / afwijzen) vereisen Developer Mode. Een prompt die ChatGPT toont voordat het een tool uitvoert, is van ChatGPT zelf en is niet de goedkeuring van Flowmingo: een uitnodiging, een afwijzing en een verplaatsing naar een fase die de kandidaat een e-mail stuurt, wachten altijd op goedkeuring door een persoon via een Flowmingo-link.
OpenAI Codex CLI
Geen brug nodig — Codex spreekt van nature Streamable HTTP.
# ~/.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
Controleer of het werkt — vraag: "toon mijn openstaande vacatures."
Gemini CLI & Code Assist
De Gemini CLI (en Gemini Code Assist agentmodus) bereiken een externe MCP-server via ~/.gemini/settings.json. De consument Gemini-app kan geen aangepaste MCP-connectors toevoegen — dit pad is alleen voor CLI / Code Assist.
Stappen: 1) voeg de server toe onder mcpServers in ~/.gemini/settings.json, 2) exporteer FLOWMINGO_API_KEY=fl_..., 3) voer gemini en /mcp uit om te bevestigen dat de tools worden vermeld.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl selecteert native Streamable HTTP. De ${FLOWMINGO_API_KEY}-placeholder wordt uitgebreid vanuit uw omgeving, dus er wordt geen ruwe sleutel in het bestand geschreven. Liever OAuth? Gemini CLI kan het native doen — laat het headers-blok weg en voeg "authProviderType": "dynamic_discovery" toe aan de serververmelding. De CLI detecteert de 401-uitdaging, ontdekt onze OAuth-metadata en voert zelf dynamische clientregistratie uit (geen client-ID in te stellen).
Verifieer of het werkt — vraag in
gemini: "list my open jobs."
Andere clients — Windsurf · Zed · Cline · Continue · Antigravity
Elke client hieronder werkt met dezelfde server — de meeste ondersteunen zowel OAuth als een statische header. De voorbeelden gebruiken een statische sleutel via een omgevingsvariabele; laat de headers weg om een client OAuth te laten gebruiken waar dit wordt ondersteund. Let op de per-client valkuilen met sleutelnamen die hieronder worden genoemd.
Google Antigravity
Voeg https://mcp.flowmingo.ai/mcp toe als een externe MCP-server en kies ervoor om te authenticeren: er opent een Flowmingo-pagina die vraagt om uw volledige API-sleutel (zie Hoe een volledige sleutel eruitziet in het gedeelte Authenticatie hierboven). Elk Antigravity-oppervlak (de IDE, de CLI) meldt zich afzonderlijk aan. In het mcp_config.json van Antigravity staat het adres onder serverUrl, en een statische sleutel gaat in een headers-blok als Authorization met Bearer en uw volledige sleutel, zoals in Google's eigen Antigravity MCP-voorbeelden. We hebben niet elke Antigravity-versie kunnen testen, dus als uw menu's hiervan verschillen, bevat de gids van Google de huidige stappen.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf accepteert serverUrl of url, en ondersteunt OAuth (laat headers weg om dit te activeren).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — de sleutel is context_servers; laat headers weg voor native OAuth. Stel FLOWMINGO_API_KEY=fl_... in in uw omgeving in plaats van een onbewerkte sleutel te plakken.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP-servers → Configureer — stel type: "streamableHttp" in (camelCase), anders wordt standaard dode SSE gebruikt.
{ "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 — verbind via de mcp-remote-brug. Stel FLOWMINGO_AUTH_HEADER = Bearer fl_YOUR_KEY in.
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 }}"]
Controleer of het werkt — vraag: "toon mijn openstaande vacatures."
Elke client (mcp-remote)
Voor elke stdio-only client (of een toekomstige client zonder native remote transport), overbrug naar Flowmingo met het mcp-remote stdio-commando. --transport http-only is vereist — de server heeft geen SSE.
Stappen: 1) zorg dat Node ≥ 18 is geïnstalleerd, 2) voer de bridge uit als stdio-commando in je client, 3) bij de eerste OAuth-run opent de browser — plak je sleutel.
# 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" }
}
}
}
Redding: als de authenticatie vastloopt, voer rm -rf ~/.mcp-auth uit en probeer het opnieuw. Vervang fl_YOUR_KEY door je volledige sleutel (zie Hoe een volledige sleutel eruitziet in de sectie Authenticatie hierboven). In een JSON args[], vermijd een spatie na de header-dubbele punt (npx escaping-quirk).
Controleer of het werkt — vraag: "toon mijn openstaande vacatures."