Oorsig
Koppel enige MCP-versoenbare AI-assistent aan jou Flowmingo-aanstellingsdata — lees jou werksgeleenthede en kandidate en neem beskermde aksies (nooi, skuif, verwerp, verwyder uit 'n projek), veilig, met jou toestemming. Met twee ekstra toestemmings wat jy self aanskakel, kan 'n assistent ook aanstellingsprojekte en assesserings skep en 'n werksadvertensie publiseer, sluit of bevorder (sien Wat jy kan doen). Nuut tot MCP? Dit is die oop standaard wat AI-assistente in staat stel om met instrumente soos Flowmingo te praat. Leer wat MCP is.
Vervoer: Streamable HTTP (die moderne afstandsvervoer). Daar is geen verouderde SSE nie — wys jou kliënt altyd na /mcp, nooit na /sse nie.
Behandel jou API-sleutel soos 'n wagwoord. Verkies OAuth, 'n gevraagde invoer, of 'n omgewingsveranderlike bo die plak van 'n rou
fl_...-sleutel in 'n lêer wat jy dalk na git kan commit (bv..vscode/mcp.json,~/.cursor/mcp.json, jou Continue-konfigurasie).
Verifikasie — twee opsies
A — Teken in met Flowmingo (OAuth, aanbeveel). Jou blaaier maak 'n Flowmingo-toestemmingsbladsy oop; jy plak jou API-sleutel daar. Die assistent ontvang nooit jou rou sleutel nie. Dit ontvang 'n toegangstoken en 'n verversingstoken, wat dit kan gebruik om 'n nuwe toegangstoken te kry. Die aanmelding duur nie vir ewig nie. Die verversingstoken leef ongeveer 30 dae by verstek, getel vanaf wanneer dit uitgereik is, by aanmelding of by die jongste verversing, so 'n aanmelding wat vir ongeveer so lank ongebruik bly, verval, en 'n Flowmingo-vrystelling wat verander hoe aanmeldings gestoor word, kan ook vereis dat jy weer aanmeld. Die assistent vra jou dan om weer aan te meld, en jy plak weer jou sleutel. Om dit vroeër te beëindig, verwyder daardie API-sleutel. Daar is geen kliënt-ID of geheim om te skep nie (Flowmingo gebruik Dynamic Client Registration). Op kliënte wat "Gevorderde" OAuth-instellings toon (bv. Claude.ai), laat die Client ID en Secret leeg.
B — Statiese API-sleutel (kopskrif). Stuur jou sleutel as óf 'n kopskrif:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Kry jou sleutel in Flowmingo → Instellings → Integrasies → API-sleutels. Merk Read hiring data en Read candidates — die eerste dek werkgeleenthede, pyplyn en resultate, en die tweede laat 'n assistent iemand op te soek. Voeg Manage pipeline / Invite candidates by vir die beskermde skryfaksies. Om 'n assistent te laat projekte en assesserings skep en 'n werksadvertensie te publiseer of te bevorder, merk ook Create hiring projects en Create assessments. Lees Skep en publiseer onder Wat jy eers kan doen: hierdie twee toestemmings is opsioneel, en die skepper van die sleutel moet 'n Eienaar of 'n Administrateur wees.
Hoe 'n volledige sleutel lyk. Een lang waarde: fl_live_, die sleutel se publieke naam, 'n punt, dan 'n lang geheime deel. Die geheime helfte word een keer gewys, net nadat jy die sleutel geskep het; later wys die API-sleutelslys net die begin daarvan. 'n Waarde sonder 'n punt is net die sleutel se naam en sal geweier word. Waar hierdie gids fl_YOUR_KEY skryf, vervang dit alles met jou volledige sleutel, sonder aanhalingstekens en sonder spasies.
As dit nie verbind nie. 'n Swak of leë sleutel kom terug as Missing credential of The Flowmingo API key was rejected; beide kan beteken dat die waarde nooit volledig by ons uitgekom het nie, so kontroleer eers die waarde. 'n Instelling soos ${env:FLOWMINGO_API_KEY} werk net as die program daardie veranderlike kan sien, en 'n redigeerder wat vanaf die dock of die Start-kieslys geopen word, lees dikwels nie jou terminale profiel nie. Begin dit óf vanaf 'n terminale waar die veranderlike gestel is, óf plaas jou volledige sleutel in die lêer (en hou daardie lêer buite git).
Watter een om te kies? Die meeste kliënte ondersteun albei; 'n paar (bv. ChatGPT) is slegs OAuth — elke blad wys wat daardie kliënt ondersteun. Oor die algemeen pas OAuth by interaktiewe assistente (Claude.ai, ChatGPT, VS Code); die API-sleutel-header pas by CLI's, kopvry/CI, en redakteurs waar jy liewer net 'n sleutel wil invoer.
Wat jy kan doen
Lesings benodig nie goedkeuring nie. Die meeste skryfaksies word beskerm. 'n Uitnodiging, 'n verwerping wat met die Reject-aksie gemaak word, 'n verwydering van kandidate uit 'n projek, die skrapping van 'n projek, of, normaalweg, 'n skuif na 'n stadium wat ingestel is om die kandidaat te e-pos, wag dat 'n persoon dit goedkeur via 'n skakel, terwyl hy by Flowmingo aangemeld is. Die assistent kan dit nie goedkeur nie, en 'n "ja" wat in die klets getik word, tel nie. Die e-posinstelling van die stadium word nagegaan wanneer die skuif versoek word. Vir 'n nota, 'n gradering, 'n kortlys, 'n etiket, of 'n skuif na 'n stadium wat nie ingestel is om die kandidaat te e-pos nie, word die assistent aangesê om eers vir jou 'n voorskou te wys en om slegs voort te gaan wanneer jy instem, wat 'n instruksie aan hom is, nie 'n slot nie. 'n Herinnering wat jou AI-kliënt wys voordat dit 'n hulpmiddel gebruik, is die kliënt se eie en nie Flowmingo se goedkeuring nie: 'n uitnodiging, 'n verwerping wat met die Verwerp-aksie gemaak is, en 'n skuif na 'n e-posfase wag steeds op die goedkeuringskakel, ongeag wat die kliënt gevra het. 'n Goedkeuringskakel verval na 15 minute, en een versoek vir verskeie kandidate of aansoeke (hoogstens 50) is een goedkeuring wat almal lys. Sodra 'n verandering geënsceneer is, kan die assistent nagaan waar dit staan, dit terugtrek terwyl dit nog wag, en 'n omkeerbare verandering ('n nota, 'n gradering, 'n kortlysmerk, 'n etiket, of 'n skuif wat niemand ge-e-pos het nie) binne 24 uur ongedaan maak. 'n Ongedaanmaking is nie altyd beskikbaar nie: die verandering moet met 'n ongedaanverwysing terugkom, en die opname daarvan is 'n beste poging, en 'n skuif vir 'n kandidaat met geen vorige fase nie, het nie een nie, so die assistent moet dit nagaan en dit sê wanneer daar geen terugpad is nie. ’n E-pos wat gestuur is, kan nie ongedaan gemaak word nie. Die gereedskap wat onder Skep en publiseer gelys word, is die uitsondering op dit alles, behalwe delete_project: hulle tree dadelik op en word nie vir goedkeuring geënsceneer nie. ’n Verwydering en ’n projekuitskrapping kan nie ongedaan gemaak word nie. Alles is beperk tot jou organisasie.
Lees
| Vermoë | Wat dit doen |
|---|---|
| Lys werksadvertensies | Blaai deur jou organisasie se oop en geslote rolle. |
| Lys onderhoudstelle en projekte | Sien jou assesserings (onderhoudstelle) van elke soort (AI-onderhoude, rolspele, vaardigheidstoetse, tegniese toetse, CV-evaluasies, vertonings en opnames; vraelyste wanneer jy daarvoor vra) en jou aanstellingsprojekte. |
| Lys jou kandidaatpyplyn | Bekyk aansoeke per stadium in 'n projek. |
| Lees assesseringsresultate en -tellings | Haal resultate van elke soort op: AI-onderhoude, rolspele, vaardigheidstoetse, tegniese toetse, CV-evaluasies, vertonings, opnames en vraelyste. Elke resultaat is gemerk met sy soort. Slegs sommige soorte dra 'n AI-telling: 'n vertoning en 'n vraelys word nooit getel nie, en 'n vaardigheidstoets is 'n persentasie. |
| Soek 'n kandidaat op | Haal een kandidaat se naam, e-pos en CV op. |
| Soek kandidate | Vind kandidate per naam of e-posadres. |
| Vergelyk kandidate | Plaas 2 tot 10 kandidate langs mekaar. Benodig die Read candidates-toestemming sowel as Read hiring data. |
| Aanstellingsoorsig | Die tregter vir alles waartoe jou verbinding toegang kan kry (die hele maatskappy, tensy die sleutel gemaak is deur iemand wat beperk is tot sekere projekte), of vernou wanneer jy vra: aansoeke per stadium, aktief vs verwerp, en vir elke tipe assessering wat resultate het, voltooide vs lopende resultate en die gemiddelde telling. 'n Projek vernou elke tel, maar die resultaat-tellings dek die resultate op die assesserings wat aan daardie projek gekoppel is, so 'n kandidaat van 'n ander projek wat een van daardie assesserings deel, kan ook getel word. 'n Assessering vernou slegs die resultaat-tellings: die stadium- en aansoektellings bly by alles waartoe jou verbinding toegang kan kry. Die tipes word nooit bymekaar getel nie. |
| Top kandidate | Die hoogste gerangskikte resultate, georden volgens algehele telling. Elke soort assessering word saam gerangskik tensy jy vir een soort of vir een assessering (onderhoudstel) vra. |
| Assesseringsresultaatbesonderhede | Een resultaat se telling per bevoegdheid plus die AI-opsomming, vir die soorte wat dit het. 'n Vaardigheidstoets, 'n Tegniese toets, 'n Uitstalling en 'n vraelys het min of geen nie. |
| Werksposbesonderhede | Die volle besonderhede van 'n enkele werkspos. |
Is 'n werkspos vir die publiek oop? (get_job_post_publication) |
Of enigiemand 'n werkspos se publieke bladsy kan oopmaak: lewendig, steeds wag vir die AI-inhoudsondersoek, geweier daardeur, gemerk, afgeskakel, of sy projek is nie oop nie. Ook sy publieke adres en sy hupstoot (af, flowmingo of uitgebrei). Benodig Read hiring data. |
| Komende onderhoude | Uitnodigings na enige vorm van assessering wat gestuur of geskeduleer is en nog nie voltooi is nie. Dit is nie 'n telling van almal wat nog uitstaande is nie: 'n uitnodiging waarvan die kandidaat herinner is, of die skakel geopen of geklik het, word uitgelaat totdat die kandidaat begin, en so ook een wat nie afgelewer kon word nie. |
Skryf (beskerm)
| Vermoë | Wat dit doen |
|---|---|
| Nooi kandidate na 'n assessering | Berei die uitnodigings voor vir 'n AI-onderhoud, 'n rolspeletjie, 'n Vaardigheidstoets of 'n Tegniese Toets, en wag dat 'n persoon dit by 'n skakel goedkeur. Niks word voor dit gestuur nie. Een assessering en hoogstens 50 kandidate per versoek; 'n Vaardigheidstoets of 'n Tegniese Toets benodig 'n projek en 'n e-pos vir elke kandidaat, en 'n geborgde een kan jou organisasie se beursie debiteer wanneer 'n kandidaat dit begin. |
| Skuif 'n kandidaat na 'n ander stadium | 'n Skuif na 'n stadium wat ingestel is om die kandidaat per e-pos te kontak, wag normaalweg vir 'n persoon om dit goed te keur by 'n skakel (die stadium se e-posinstelling word een keer gelees, net voor die skuif, sodat 'n instelling wat op daardie oomblik aangeskakel word, steeds 'n skuif kan laat e-pos stuur sonder goedkeuring). Enige ander skuif: die assistent word aangesê om dit te voorskou en op jou ja te wag, en dit kan gewoonlik vir 24 uur ongedaan gemaak word, wanneer dit met 'n ongedaan-maak-verwysing teruggekom het. Hoogstens 50 aansoeke per versoek. |
| Wys 'n aansoek af | Versoek goedkeuring by 'n skakel. As 'n persoon dit goedkeur, probeer Flowmingo om die aansoek na die projek se Verwerp-stadium te skuif; kontroleer die resultaat daarna. Hoogstens 50 aansoeke per versoek. |
Verwyder kandidate uit 'n projek (remove_application) |
Benodig Manage pipeline. Vra goedkeuring by 'n skakel. As 'n persoon dit goedkeur, verwyder Flowmingo die aansoeke uit die projek; die kandidaat se profiel bly in jou talentpoel en in ander projekte. Dit is nie 'n verwerping nie, en daar is geen ongedaan maak nie. Hoogstens 50 aansoeke per versoek. |
| Voeg 'n nota by 'n uitslag | Die assistent word aangesê om die voorgestelde nota te voorskou en op jou ja te wag voordat dit gestoor word. 'n Nota behoort aan een assesseringsuitslag (van enige soort), nie aan die kandidaat as geheel nie. |
| Gradeer 'n uitslag | Die assistent word aangesê om die gradering te voorskou en op jou ja te wag. Die gradering geld vir een assesseringsuitslag. |
| Plaas 'n uitslag op die kortlys | Die assistent word aangesê om die kortlysverandering te voorskou en op jou ja te wag. Dit geld vir een assesseringsuitslag. |
| Merk by / voeg by talentversameling | Die assistent word aangesê om die merk- of talentversamelingverandering voor te vertoon en op jou ja te wag. |
| Kontroleer, trek terug of ontdoen 'n verandering | Kontroleer waar 'n gestasioneerde verandering staan (wag, uitgevoer, misluk, verval of vervang deur 'n nuwer versoek), trek een terug wat steeds op goedkeuring wag, of ontdoen 'n omkeerbare verandering binne 24 uur, wanneer dit met 'n ontdoenverwysing teruggekom het. |
Skep en publiseer (tree dadelik in werking, behalwe die verwydering van 'n projek)
Hierdie gereedskap skep dinge en maak dit aan die publiek beskikbaar. Hulle tree anders op as die beveiligde skryfaksies hierbo:
- Hulle tree onmiddellik op, behalwe
delete_project. Niks word vir 'n persoon gestoor om by 'n skakel goed te keur nie, en nie een van hulle e-pos 'n kandidaat nie.delete_projectwag dat 'n Eienaar of 'n Admin dit by 'n skakel goedkeur. - Die skepper van die sleutel moet 'n Eienaar of 'n Admin wees vir elke instrument hier, behalwe die kansellasie, wat slegs Invite candidates benodig. Die instrumente tree op met die toestemmings van die persoon wat die API-sleutel geskep het. As daardie persoon 'n Lid is, word die oproep geweier.
- Twee toestemmings is opsioneel. Create hiring projects en Create assessments word nie by verstek gegee nie. Met aanmelding (opsie A) kry die assistent hulle slegs as beide waar is: die kliënt lys hulle by naam wanneer hy verbind, en die API-sleutel wat jy op die toestemmingsbladsy plak, bevat hulle. 'n Kliënt wat geen lys van toestemmings stuur nie, kry die vier standaardtoestemmings (Read hiring data, Read candidates, Manage pipeline, Invite candidates) wat die sleutel besit, en nie een van hierdie twee nie, so die assistent sien nie die instrumente wat dit benodig nie. Met 'n statiese sleutel (opsie B) word hierdie instrumente aan die assistent gewys ongeag watter toestemmings die sleutel besit, en Flowmingo weier enige oproep wat die sleutel nie toelaat nie.
- Sommige oproepe neem 'n rukkie. Publisering wag vir die AI-inhoudkontrole, tot ongeveer 90 sekondes. Die skep van 'n projek of 'n assessering gebruik AI-generering en kan langer neem ('n Tegniese Toets neem 3 tot 9 minute). Wanneer die antwoord sê die werk is steeds hangende, bel die assistent weer met dieselfde idempotensiesleutel om te sien waar dit gevorder het. 'n Herpog skep nooit 'n tweede projek of assessering nie.
| Vermoë | Wat dit doen |
|---|---|
Skep 'n werwingsprojek (create_project) |
Benodig Create hiring projects (toestemming). Skep 'n projek met sy vier standaard fases en 'n werksadvertensie wat deur dieselfde AI as die dashboard geskryf is, gebaseer op 'n titel, die posisie en 'n opsionele beskrywing. Standaard skep dit ook 'n CV-evaluasie en 'n KI-onderhoud; die assistent kan ander assesserings benoem, of geen. Die werksadvertensie word aangeskakel en word publiek sodra die KI-inhoudsondersoek dit goedkeur, gewoonlik binne 'n minuut. Beperk tot 10 projekte per minuut en 300 per dag vir jou maatskappy. Die idempotensiesleutel is opsioneel: wanneer dit uitgelaat word, word een uit die argumente gemaak, sodat 'n herprobeer nooit 'n tweede projek skep nie. |
Skep 'n assessering (create_assessment) |
Benodig Create assessments (opt-in). Maak een assessering met die AI: 'n AI-onderhoud, 'n CV-evaluering, 'n Vaardigheidstoets, 'n Uitstalling, 'n Tegniese toets of 'n Rolspel, vanaf 'n werkstitel en 'n opsionele werkbeskrywing, naam, projek en taal ('n etiket soos en of vi-VN; 'n Vaardigheidstoets en 'n Tegniese toets ignoreer die taal). Heg dit aan 'n projek sodat kandidate na 'n Vaardigheidstoets, 'n Tegniese toets of 'n Uitstalling genooi kan word. Die idempotensiesleutel is opsioneel, soos hierbo. |
Publiseer 'n werkadvertensie (publish_job_post) |
Benodig Create hiring projects. Skakel die werkadvertensie aan en verseker dat die AI-inhoudkontrole uitgevoer is. Die antwoord sê of die bladsy nou lewendig is, steeds wag vir die kontrole, of deur dit geweier is. Die aanstellingsprojek moet aktief wees. |
Deaktiveer 'n werksadvertensie (unpublish_job_post) |
Benodig Create hiring projects. Skakel die werksadvertensie af, sodat die publieke skakel nie meer oopmaak nie. By verstek word die hupstoot ook afgeskakel (withdraw_boost is waar). |
Verhoog 'n werksadvertensie (boost_job_post) |
Benodig Create hiring projects. Stel die hupstoot op off, flowmingo of extended. Hupstoot is gratis. Om dit te verhoog, moet die werksadvertensie aangeskakel wees, die projek aktief wees, 'n maatskappylogo en -beskrywing hê, en die AI-inhoudkontrole; 'n maatskappy kan 50 hupstote per dag verhoog. |
Maak 'n projek oop, konsep of argiveer (set_project_state) |
Benodig Create hiring projects. Skuif 'n aanstellingsprojek tussen active, draft en archived. Konsep en argief maak die werkskakel toe. Kandidaatdata word bewaar. |
Kanselleer 'n geskeduleerde uitnodiging (cancel_scheduled_invite) |
Benodig Invite candidates. Kanselleer 'n uitnodiging wat vir later geskeduleer is en nog nie gestuur is nie, deur die uitnodigings-ID van die uitnodigingsresultaat te gebruik. Niemand word per e-pos gekontak nie. Die persoon bly in jou rekening en op die projekbord. |
Verwyder 'n werwingsprojek (delete_project) |
Benodig Create hiring projects (opsioneel). Dit vra net: dit verwyder nie dadelik nie, dit versoek goedkeuring by 'n skakel, en niks word verwyder totdat 'n Eienaar of 'n Admin dit goedkeur nie. Slegs 'n aktiewe projek kan verwyder word. As 'n persoon dit goedkeur, verwyder Flowmingo die projek en sy werksadvertensies; sy kandidaataansoeke word nie een vir een verwyder nie, en kandidaatprofiele en kontakte, jou assesserings en uitnodigingskakels word behou. Daar is geen ongedaan maak nie. |
Sekuriteit en vertroue
- Jou data is org-gebonde — die assistent kan nooit 'n ander maatskappy se data sien nie.
- Met OAuth ontvang die assistent nooit jou API-sleutel nie. Dit kry 'n toegangstoken wat na 'n uur verval, en word stilweg verfris terwyl dit verbind bly. Die aanmelding self duur so lank as sy verfrissingstoken, ongeveer 30 dae by verstek vanaf wanneer dit uitgereik of laas verfris is, dus verval dit na ongeveer 30 dae sonder gebruik, en dan meld jy weer aan. Met 'n statiese kopskrif (opsie B) hou jou assistent se kliënt jou sleutel en stuur dit met elke versoek, hou dit dus uit lêers wat jy mag deel of pleeg.
- Om 'n assistent af te sny: verwyder die API-sleutel wat jy daarmee gemagtig het, in Instellings → Integrasies → API-sleutels. Toegang stop onmiddellik. Daar is nog geen per-assistent-ontkoppeling nie, so as jy hulle een vir een wil herroep, gee elke assistent sy eie sleutel.
- Versoeke aan die
/mcp-eindpunt word vir hul Oorsprong nagegaan: 'n ondeursigtigenull-oorsprong word altyd geweier, en die kontrole kan tot 'n toelatingslys gesluit word, maar by verstek word elke werklike oorsprong aanvaar, so die beskerming is jou geloofsbrief, nie die oorsprong nie. Elke sessie is gekoppel aan die geloofsbrief wat dit geopen het.
Vir hoe om te verifieer, sien Verifikasie — twee opsies; vir die presiese leesbewerkings, bewaakte skryfwerk en aksies wat gelyktydig plaasvind, sien Wat jy kan doen. Wanneer jy gereed is, spring na Koppel jou assistent en kies jou kliënt.
MCP bediener URL
Koppel jou assistent
Claude Code (CLI)
Een opdrag voeg Flowmingo by oor native Streamable HTTP. Lei met OAuth; die statiese --header is die alternatief.
Stappe: 1) voeg die bediener by, 2) teken aan (blaaier → plak sleutel), 3) claude mcp list om te verifieer.
# 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: vlae moet voor die naam kom, en gebruik altyd --transport http (nooit sse nie). Vervang fl_YOUR_KEY met jou volledige sleutel (sien Hoe 'n volledige sleutel lyk in die Authentication-afdeling hierbo).
Verifieer dat dit werk — vra: "lys my oop poste."
Cursor
Die statiese kopblok is die eenvoudigste pad. Cursor kan ook OAuth gebruik (dit ondersteun Dynamic Client Registration) — vir dit, verwyder die headers blok.
Stappe: 1) voeg die bediener by ~/.cursor/mcp.json (hieronder), 2) stel FLOWMINGO_API_KEY op jou volledige sleutel in jou dop-profiel, 3) verlaat Cursor en begin dit vanaf 'n terminal waar die veranderlike gestel is, 4) in Instellings → MCP, skakel die bediener af en aan om te herlaai.
Cursor moet die veranderlike kan sien. Cursor lees ${env:FLOWMINGO_API_KEY} uit sy eie omgewing. As dit vanaf die dok of die Start-kieslys begin word, sien dit dikwels nie 'n veranderlike wat in jou terminal-profiel gestel is nie, en dan kom die kopblok leeg of onuitgebrei aan en die bediener antwoord Missing credential. As dit nie prakties is om Cursor vanaf 'n terminal te begin nie, vervang ${env:FLOWMINGO_API_KEY} in die lêer met jou volledige sleutel (en hou ~/.cursor/mcp.json buite git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth in plaas daarvan — verwyder die headers blok; Cursor gebruik Dynamic Client Registration en maak 'n blaaier-toestemmingsbladsy oop by eerste verbinding:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Verifieer dit werk — vra: "lys my oop werk."
VS Code (Copilot, agent modus)
Gereedskap verskyn slegs in Copilot Chat → Agent modus. Die wortelsleutel is servers (nie mcpServers nie) en die tipe is http. Die gevraagde-sleutel pad hieronder is die betroubare opstelling.
Stappe: 1) skep .vscode/mcp.json (of voer MCP: Voeg Bediener by → HTTP uit), 2) wanneer jy die bediener begin, vra VS Code vir jou sleutel (dit word nie in die lêer geskryf nie), 3) gebruik dit in Agent modus.
{
"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 probeer, maar die gedokumenteerde OAuth-konfigurasie verwag 'n kliënt-ID; gebruik die gevraagde-sleutel pad hierbo vir 'n betroubare opstelling.
Verifieer dat dit werk — vra: "list my open jobs."
Claude — claude.ai & Claude Desktop
Albei gebruik dieselfde Verbindings UI en dieselfde plak-die-URL-vloei. Slegs OAuth (daar is geen header-veld in die UI nie).
Stappe (web of desktop):
- Maak Instellings → Verbindings oop en klik Voeg pasgemaakte verbinding by.
- Noem dit
Flowmingoen plak die MCP-bediener URL hierbo. Laat Gevorderd → OAuth Kliënt ID / Geheim leeg. - Klik Voeg by → Koppel. Op die Flowmingo-toestemmingsbladsy, plak jou
fl_API-sleutel en magtig. - Verifieer — vra 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)
Span / Enterprise: 'n Eienaar voeg dit een keer by onder Organisasie Instellings → Verbindings → Pasgemaak; lede klik dan Koppel.
Benodig 'n statiese sleutel op Claude Desktop in plaas daarvan? Gebruik die Enige kliënt (mcp-remote) oortjie.
Jou blaaier maak 'n Flowmingo-goedkeuringsbladsy oop met die eerste verbinding — plak jou API-sleutel en magtig. Om later te ontkoppel, vee daardie API-sleutel uit in Instellings → Integrasies → API-sleutels.
ChatGPT & OpenAI Codex CLI
Beide is OpenAI. ChatGPT gebruik Developer Mode vir pasgemaakte konneksies (slegs OAuth); Codex koppel inheems vanaf die CLI.
ChatGPT (web)
- Op chatgpt.com (Plus / Pro / Business / Enterprise / Edu — nie mobiel nie), maak Instellings → Programme → Gevorderd oop en skakel Developer mode AAN.
- Programme → Skep → noem dit
Flowmingo, plak die URL hieronder, vervoer Streamable HTTP, outentisering OAuth. - Maak die konsep oop, skakel die gereedskap aan, en Verfris.
- Heg dit aan via die +-kieslys in 'n klets.
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 se Developer Mode koppel met slegs OAuth — dit aanvaar nie 'n statiese x-api-key / pasgemaakte API-sleutel-kopskuif nie. Gewone en diepnavorsingskonnekteurs gebruik slegs search + fetch (jy het albei). Skryfgereedskap (nooi / skuif / verwerp) vereis Developer Mode. 'n Aanwysing wat ChatGPT wys voordat dit 'n gereedskap gebruik, is ChatGPT se eie en nie Flowmingo se goedkeuring nie: 'n uitnodiging, 'n verwerping en 'n skuif na 'n stadium wat die kandidaat per e-pos stuur, wag altyd vir 'n persoon om dit by 'n Flowmingo-skakel goed te keur.
OpenAI Codex CLI
Geen brug nodig nie — Codex praat Streamable HTTP inheems.
# ~/.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
Verifieer dit werk — vra: "lys my oop werkgeleenthede."
Gemini CLI & Code Assist
Die Gemini CLI (en Gemini Code Assist agentmodus) bereik 'n afgeleë MCP-bediener via ~/.gemini/settings.json. Die verbruiker Gemini-toepassing kan nie pasgemaakte MCP-verbindings byvoeg nie — hierdie pad is slegs CLI / Code Assist.
Stappe: 1) voeg die bediener by onder mcpServers in ~/.gemini/settings.json, 2) voer FLOWMINGO_API_KEY=fl_... uit, 3) voer gemini en /mcp uit om te bevestig dat die gereedskap gelys is.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl kies inheemse Stroombare HTTP. Die ${FLOWMINGO_API_KEY}-plekhouer word uit jou omgewing uitgebrei, dus word geen rou sleutel in die lêer geskryf nie. Verkies OAuth? Gemini CLI kan dit inheems doen — laat die headers-blok weg en voeg "authProviderType": "dynamic_discovery" by die bedienerinskrywing. Die CLI bespeur die 401-uitdaging, ontdek ons OAuth-metadata, en voer dinamiese kliëntregistrasie op sy eie uit (geen kliënt-ID om in te stel nie).
Verifieer dat dit werk — in
gemini, vra: "list my open jobs."
Ander kliënte — Windsurf · Zed · Cline · Continue · Antigravity
Elke kliënt hieronder werk teen dieselfde bediener — die meeste ondersteun beide OAuth en 'n statiese kopstuk. Die kodes gebruik 'n statiese sleutel via 'n omgewingsveranderlike; los die headers uit om 'n kliënt te laat OAuth loop waar dit dit ondersteun. Let op die per-kliënt sleutelnaam-kuipe wat hieronder genoem word.
Google Antigravity
Voeg https://mcp.flowmingo.ai/mcp by as 'n afgeleë MCP-bediener en kies om dit te verifieer: 'n Flowmingo-bladsy open en vra vir jou volledige API-sleutel (sien Wat 'n volledige sleutel behels in die Verifikasie-afdeling hierbo). Elke Antigravity-oppervlak (die IDE, die CLI) teken afsonderlik aan. In Antigravity se mcp_config.json gaan die adres onder serverUrl, en 'n statiese sleutel gaan in 'n headers-blok as Authorization met Bearer en jou volledige sleutel, soos in Google se eie Antigravity MCP-voorbeelde. Ons kon nie elke Antigravity-weergawe toets nie, so as jou kieslyste hiervan verskil, het Google se gids die huidige stappe.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf aanvaar serverUrl of url, en ondersteun OAuth (los headers uit om dit te aktiveer).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — die sleutel is context_servers; los headers uit vir inheemse OAuth. Stel FLOWMINGO_API_KEY=fl_... in jou omgewing eerder as om 'n rou sleutel te plak.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP-bediener → Konfigureer — stel type: "streamableHttp" (kameelkas), anders verstek dit na dooie SSE.
{ "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 — koppel via die mcp-remote-brug. Stel 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 }}"]
Verifieer dit werk — vra: "lys my oop posvakke."
Enige kliënt (mcp-remote)
Vir enige stdio-alleen-kliënt (of 'n toekomstige kliënt sonder 'n inheemse afstand-transport), brug na Flowmingo met die mcp-remote stdio-opdrag. --transport http-only word vereis — die bediener het geen SSE nie.
Stappe: 1) maak seker Node ≥ 18, 2) voer die brug as 'n stdio-opdrag in jou kliënt uit, 3) met die eerste OAuth-loop open die blaaier — plak jou 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: as verifikasie vassit, hardloop rm -rf ~/.mcp-auth en probeer weer. Vervang fl_YOUR_KEY met jou volledige sleutel (sien Hoe 'n volledige sleutel lyk in die Verifikasie-afdeling hierbo). In 'n JSON args[], vermy 'n spasie na die kop-kolom (npx-ontsnappingskwaal).
Verifieer dit werk — vra: "lys my oop werk."