Integrasjoner

Koble til AI-assistenter (MCP)

Koble til en hvilken som helst MCP-kompatibel AI-assistent — Claude, Claude Code, ChatGPT, Cursor, VS Code og mer — til dine Flowmingo-ansettelsesdata, og arbeid med pipelinen din på vanlig språk.

Our team is online
Trenger du hjelp med integreringen?

Står du fast på et trinn eller trenger du teknisk support? Teamet vårt hjelper deg gjerne — ta kontakt når som helst, så får vi deg på rett vei.

Oversikt

Koble enhver MCP-kompatibel AI-assistent til Flowmingo-ansettelsesdataene dine — les jobbene og kandidatene dine og utfør beskyttede handlinger (inviter, avvis, flytt, fjern fra prosjekt), sikkert, med din tillatelse. Med to ekstra tillatelser som du slår på selv, kan en assistent også opprette ansettelsesprosjekter og vurderinger og publisere, lukke eller booste en stillingsannonse (se Hva du kan gjøre). Ny til MCP? Det er den åpne standarden som lar AI-assistenter snakke med verktøy som Flowmingo. Lær hva MCP er.

Transport: Streamable HTTP (den moderne eksterne transporten). Det er ingen eldre SSE — pek alltid klienten mot /mcp, aldri /sse.

Behandle API-nøkkelen din som et passord. Foretrekk OAuth, en forespurt inntasting eller en miljøvariabel fremfor å lime inn en rå fl_...-nøkkel i en fil du kanskje committer til git (f.eks. .vscode/mcp.json, ~/.cursor/mcp.json, din Continue-konfigurasjon).

Autentisering — to alternativer

A — Logg inn med Flowmingo (OAuth, anbefalt). Nettleseren din åpner en Flowmingo-samtykkeside; du limer inn API-nøkkelen din der. Assistenten mottar aldri den rå nøkkelen din. Den mottar et tilgangstoken og et oppdateringstoken, som den kan bruke til å få et nytt tilgangstoken. Innloggingen varer ikke evig. Oppdateringstokenet lever i omtrent 30 dager som standard, regnet fra det ble utstedt, ved innlogging eller ved siste oppdatering, så en innlogging som ikke brukes i omtrent så lang tid utløper, og en Flowmingo-utgivelse som endrer hvordan innlogginger lagres kan også kreve at du logger inn igjen. Assistenten ber deg deretter logge inn igjen, og du limer inn nøkkelen din igjen. For å kutte det av tidligere, slett den API-nøkkelen. Det er ingen klient-ID eller hemmelighet å opprette (Flowmingo bruker Dynamic Client Registration). På klienter som viser "Avanserte" OAuth-innstillinger (f.eks. Claude.ai), la Klient-ID og Hemmelighet være tomme.

B — Statisk API-nøkkel (header). Send nøkkelen din som en av følgende headere:

x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY

Få nøkkelen din i Flowmingo → Innstillinger → Integrasjoner → API-nøkler. Merk av for Read hiring data og Read candidates — den første dekker jobber, pipeline og resultater, den andre er det som lar en assistent slå opp noen. Legg til Manage pipeline / Invite candidates for de beskyttede skrivehandlingene. For å la en assistent opprette prosjekter og vurderinger og publisere eller booste en stillingsannonse, merk også av for Create hiring projects og Create assessments. Les Opprett og publiser under Hva du kan gjøre først: disse to tillatelsene er frivillige, og nøkkelens oppretter må være en eier eller en administrator.

Hvordan en komplett nøkkel ser ut. Én lang verdi: fl_live_, nøkkelens offentlige navn, en punktum, så en lang hemmelighet. Den hemmelige halvdelen vises én gang, rett etter at du oppretter nøkkelen; senere viser API-nøkkellisten bare starten av den. En verdi uten punktum er bare nøkkelens navn, og den vil bli avvist. Der denne veiledningen skriver fl_YOUR_KEY, erstatt alt av det med din komplette nøkkel, uten anførselstegn og uten mellomrom.

Hvis det ikke vil koble til. En dårlig eller tom nøkkel kommer tilbake som Missing credential eller The Flowmingo API key was rejected; begge kan bety at verdien aldri nådde oss i sin helhet, så sjekk verdien først. En innstilling som ${env:FLOWMINGO_API_KEY} fungerer bare hvis programmet kan se den variabelen, og en editor åpnet fra dokken eller Start-menyen leser ofte ikke terminalprofilen din. Start den enten fra en terminal der variabelen er satt, eller legg den komplette nøkkelen i filen (og hold den filen utenfor git).

Hvilken å velge? De fleste klienter støtter begge; noen få (f.eks. ChatGPT) er OAuth-only — hver fane noterer hva den klienten støtter. Generelt passer OAuth for interaktive assistenter (Claude.ai, ChatGPT, VS Code); API-nøkkelheaderen passer for CLI-er, headless/CI, og editorer der du heller vil legge inn en nøkkel.

Hva du kan gjøre

Lesinger trenger ikke godkjenning. De fleste skrivinger er beskyttet. En invitasjon, en avvisning gjort med Avvis-handlingen, en fjerning av kandidater fra et prosjekt, en sletting av et prosjekt, eller, normalt, en flytting til et trinn som er satt til å sende e-post til kandidaten, venter på at en person godkjenner det på en lenke, innlogget på Flowmingo. Assistenten kan ikke godkjenne det, og et ja skrevet i chatten teller ikke. Trinnets e-postinnstilling sjekkes når flyttingen blir forespurt. For en notat, en vurdering, en shortlist, en tag, eller en flytting til et trinn som ikke er satt til å sende e-post til kandidaten, blir assistenten bedt om å vise en forhåndsvisning først og fortsette bare når du samtykker, som er en instruksjon til den, ikke en lås. En forespørsel som AI-klienten din viser før den kjører et verktøy, er klientens egen og er ikke Flowmingos godkjenning: en invitasjon, en avvisning gjort med Avvis-handlingen og en flytting til et e-posttrinn venter fortsatt på godkjenningslenken, uansett hva klienten spurte. En godkjenningslenke utløper etter 15 minutter, og én forespørsel for flere kandidater eller søknader (maks 50) er én godkjenning som lister alle. Når en endring er lagt til, kan assistenten sjekke hvor den står, trekke den tilbake mens den fortsatt venter, og angre en reversibel endring (en notat, en vurdering, en shortlist-markering, en tag, eller en flytting som ikke sendte e-post til noen) innen 24 timer. En angring er ikke alltid tilgjengelig: endringen må komme tilbake med en angringsreferanse, å registrere en er best effort, og en flytting for en kandidat uten tidligere trinn har ingen, så assistenten bør sjekke og si det når det ikke er noen vei tilbake. En e-post som er sendt, kan ikke angres. Verktøyene listet under Opprett og publiser er unntaket fra alt dette, bortsett fra delete_project: de handler umiddelbart og er ikke lagt til for godkjenning. En fjerning og en prosjektsletting kan ikke angres. Alt er begrenset til organisasjonen din.

Les

Evne Hva den gjør
Liste stillingsannonser Bla gjennom organisasjonens åpne og lukkede roller.
Liste intervjusett og prosjekter Se vurderingene dine (intervjusett) av alle slag (AI-intervjuer, rollespill, ferdighetstester, tekniske tester, CV-vurderinger, showcases og opptak; spørreskjemaer når du ber om dem) og ansettelsesprosjektene dine.
Liste kandidatpipelinen din Vis søknader etter trinn på tvers av et prosjekt.
Les vurderingsresultater og scorer Hent resultater av alle slag: AI-intervjuer, rollespill, ferdighetstester, tekniske tester, CV-vurderinger, showcases, opptak og spørreskjemaer. Hvert resultat er merket med sitt slag. Bare noen slag har en AI-score: en showcase og et spørreskjema er aldri scoret, og en ferdighetstest er en prosentandel.
Slå opp en kandidat Hent én kandidats navn, e-post og CV.
Søk etter kandidater Finn kandidater etter navn eller e-post.
Sammenlign kandidater Still opp 2 til 10 kandidater side om side. Krever Read candidates-tillatelsen i tillegg til Read hiring data.
Ansettelsesoversikt Trakten for alt forbindelsen din kan nå (hele selskapet, med mindre nøkkelen ble laget av noen begrenset til noen prosjekter), eller avgrenset når du spør: søknader per trinn, aktive vs. avviste, og, for hvert slag av vurdering som har resultater, fullførte vs. pågående resultater og gjennomsnittsscoren. Et prosjekt avgrenser hver telling, men resultattellingene dekker resultatene på vurderingene knyttet til det prosjektet, så en kandidat fra et annet prosjekt som deler en av de vurderingene kan også telles. En vurdering avgrenser bare resultattellingene: trinn- og søknadstellingene forblir på alt forbindelsen din kan nå. Slagene blir aldri lagt sammen.
Toppkandidater De høyest rangerte resultatene, sortert etter total score. Alle slag av vurderinger rangeres sammen med mindre du ber om ett slag eller én vurdering (intervjusett).
Vurderingsresultatdetaljer Én resultats per-kompetanse-scorer pluss AI-sammendraget, for slagene som har dem. En ferdighetstest, en teknisk test, en showcase og et spørreskjema har lite eller ingenting.
Stillingsannonsedetaljer Full detalj av én stillingsannonse.
Er en stillingsannonse offentlig? (get_job_post_publication) Om noen kan åpne en stillingsannonses offentlige side: live, fortsatt venter på AI-innholdssjekken, avvist av den, flagget, slått av, eller prosjektet er ikke åpent. Også dens offentlige adresse og boosten (av, flowmingo eller utvidet). Krever Read hiring data.
Kommende intervjuer Invitasjoner til alle slag av vurderinger som ble sendt eller er planlagt og ikke ennå fullført. Det er ikke en telling av alle som fortsatt er utestående: en invitasjon hvis kandidat har blitt påminnet, eller har åpnet eller klikket på lenken, er utelatt til kandidaten starter, og det samme er en som ikke ble levert.

Skriv (beskyttet)

Evne Hva den gjør
Inviter kandidater til en vurdering Forbereder invitasjonene for et AI-intervju, et rollespill, en ferdighetstest eller en teknisk test, og venter på at en person godkjenner dem på en lenke. Ingenting sendes før det. Én vurdering og maks 50 kandidater per forespørsel; en ferdighetstest eller en teknisk test krever et prosjekt og en e-post for hver kandidat, og en sponset en kan debitere organisasjonens lommebok når en kandidat starter den.
Flytt en kandidat til et annet trinn En flytting til et trinn som er satt til å sende e-post til kandidaten venter normalt på at en person godkjenner det på en lenke (trinnets e-postinnstilling leses én gang, rett før flyttingen, så en innstilling som slås på i det øyeblikket kan fortsatt la en flytte-e-post gå uten godkjenning). Enhver annen flytting: assistenten blir bedt om å forhåndsvise den og vente på ja-et ditt, og den kan vanligvis angres i 24 timer, når den kom tilbake med en angringsreferanse. Maks 50 søknader per forespørsel.
Avvis en søknad Ber om godkjenning på en lenke. Hvis en person godkjenner det, prøver Flowmingo å flytte søknaden til prosjektets Avvist-trinn; sjekk resultatet etterpå. Maks 50 søknader per forespørsel.
Fjern kandidater fra et prosjekt (remove_application) Krever Manage pipeline. Ber om godkjenning på en lenke. Hvis en person godkjenner det, sletter Flowmingo søknadene fra prosjektet; kandidatens profil forblir i talentpoolen din og i andre prosjekter. Det er ikke en avvisning, og det er ingen angring. Maks 50 søknader per forespørsel.
Legg til en notat på et resultat Assistenten blir bedt om å forhåndsvise den foreslåtte notaten og vente på ja-et ditt før den lagrer den. En notat tilhører ett vurderingsresultat (av alle slag), ikke kandidaten som helhet.
Vurder et resultat Assistenten blir bedt om å forhåndsvise vurderingen og vente på ja-et ditt. Vurderingen gjelder ett vurderingsresultat.
Shortlist et resultat Assistenten blir bedt om å forhåndsvise shortlist-endringen og vente på ja-et ditt. Den gjelder ett vurderingsresultat.
Tag / legg til i talentsamling Assistenten blir bedt om å forhåndsvise tag- eller talentsamlings-endringen og vente på ja-et ditt.
Sjekk, trekk tilbake eller angre en endring Sjekk hvor en lagt til endring står (venter, utført, mislyktes, utløpt eller erstattet av en nyere forespørsel), trekk tilbake en som fortsatt venter på godkjenning, eller angre en reversibel endring innen 24 timer, når den kom tilbake med en angringsreferanse.

Opprett og publiser (handler umiddelbart, bortsett fra å slette et prosjekt)

Disse verktøyene oppretter ting og åpner dem for offentligheten. De oppfører seg annerledes enn de beskyttede skrivingene ovenfor:

  • De handler umiddelbart, bortsett fra delete_project. Ingenting er lagt til for en person å godkjenne på en lenke, og ingen av dem sender e-post til en kandidat. delete_project venter på at en eier eller en administrator godkjenner det på en lenke.
  • Nøkkelens oppretter må være en eier eller en administrator, for hvert verktøy her bortsett fra avbrytelsen, som bare krever Invite candidates. Verktøyene handler med tillatelsene til personen som opprettet API-nøkkelen. Hvis den personen er et medlem, blir kallet avvist.
  • To tillatelser er valgfrie. Create hiring projects og Create assessments gis ikke som standard. Med pålogging (alternativ A) får assistenten dem bare hvis begge deler er sanne: klienten lister dem ved navn når den kobler til, og API-nøkkelen du limer inn på samtykkesiden har dem. En klient som ikke sender en liste over tillatelser, får de fire standardtillatelsene (Read hiring data, Read candidates, Manage pipeline, Invite candidates) som nøkkelen har, og ingen av disse to, så assistenten ser ikke verktøyene som trenger dem. Med en statisk nøkkel (alternativ B) vises disse verktøyene til assistenten uansett hvilke tillatelser nøkkelen har, og Flowmingo avviser alle kall som nøkkelen ikke tillater.
  • Noen kall tar tid. Publisering venter på AI-innholdssjekken, opptil omtrent 90 sekunder. Å opprette et prosjekt eller en vurdering bruker AI-generering og kan ta lengre tid (en teknisk test tar 3 til 9 minutter). Når svaret sier at arbeidet fortsatt er pågående, kaller assistenten igjen med samme idempotensnøkkel for å lese hvor det har kommet. Et forsøk på nytt lager aldri et andre prosjekt eller en vurdering.
Evne Hva den gjør
Opprett et ansettelsesprosjekt (create_project) Krever Create hiring projects (frivillig). Lager et prosjekt med sine fire standardtrinn og en stillingsannonse skrevet av samme AI som dashbordet, fra en tittel, stillingen og en valgfri beskrivelse. Som standard lager den også en CV-vurdering og et AI-intervju; assistenten kan navngi andre vurderinger, eller ingen. Stillingsannonsen er slått på og blir offentlig når AI-innholdssjekken godkjenner den, normalt innen et minutt. Begrenset til 10 prosjekter i minuttet og 300 om dagen for selskapet ditt. Idempotensnøkkelen er valgfri: når den utelates, lages en fra argumentene, så et forsøk på nytt lager aldri et andre prosjekt.
Opprett en vurdering (create_assessment) Krever Create assessments (frivillig). Lager én vurdering med AI-en: et AI-intervju, en CV-vurdering, en ferdighetstest, en showcase, en teknisk test eller et rollespill, fra en jobbtittel og en valgfri jobbbeskrivelse, navn, prosjekt og språk (en tag som en eller vi-VN; en ferdighetstest og en teknisk test ignorerer språket). Fest den til et prosjekt slik at kandidater kan inviteres til en ferdighetstest, en teknisk test eller en showcase. Idempotensnøkkelen er valgfri, som ovenfor.
Publiser en stillingsannonse (publish_job_post) Krever Create hiring projects. Slår på stillingsannonsen og sørger for at AI-innholdssjekken har kjørt. Svaret sier om siden er live nå, fortsatt venter på sjekken, eller avvist av den. Ansettelsesprosjektet må være aktivt.
Avpubliser en stillingsannonse (unpublish_job_post) Krever Create hiring projects. Slår av stillingsannonsen, så den offentlige lenken slutter å åpne. Som standard slås boosten også av (withdraw_boost er true).
Boost en stillingsannonse (boost_job_post) Krever Create hiring projects. Setter boosten til off, flowmingo eller extended. Boosting er gratis. Å heve den krever at stillingsannonsen er slått på, prosjektet aktivt, en firmalogo og beskrivelse, og AI-innholdssjekken; et selskap kan heve 50 boosts om dagen.
Åpne, utkast eller arkiver et prosjekt (set_project_state) Krever Create hiring projects. Flytter et ansettelsesprosjekt mellom active, draft og archived. Utkast og arkivert lukker jobblinken. Kandidatdata beholdes.
Avbryt en planlagt invitasjon (cancel_scheduled_invite) Krever Invite candidates. Avbryter en invitasjon som var planlagt for senere og ikke ennå sendt, ved å bruke invitasjons-ID-en fra invite-resultatet. Ingen får e-post. Personen forblir i kontoen din og på prosjektstavlen.
Slett et ansettelsesprosjekt (delete_project) Krever Create hiring projects (frivillig). Den ber bare: den sletter ikke umiddelbart, den ber om godkjenning på en lenke, og ingenting slettes før en eier eller en administrator godkjenner det. Bare et aktivt prosjekt kan slettes. Hvis en person godkjenner det, sletter Flowmingo prosjektet og stillingsannonsene; søknadene blir ikke slettet én etter én, og kandidatprofiler og kontakter, vurderingene dine og invitasjonslenker beholdes. Det er ingen angring.

Sikkerhet og tillit

  • Dataene dine er org-begrenset — assistenten kan aldri se et annet selskaps data.
  • Med OAuth mottar assistenten aldri API-nøkkelen din. Den får et tilgangstoken som utløper etter en time, oppdatert stille mens den forblir tilkoblet. Selve innloggingen varer så lenge som oppdateringstokenet, omtrent 30 dager som standard fra det ble utstedt eller sist oppdatert, så den utløper etter omtrent 30 dager uten bruk, og du logger inn igjen. Med en statisk header (alternativ B) holder klienten til assistenten din nøkkelen din og sender den med hver forespørsel, så hold den utenfor filer du kan dele eller committe.
  • Koble fra en assistent: slett API-nøkkelen du autoriserte den med, i Innstillinger → Integrasjoner → API-nøkler. Tilgang stopper umiddelbart. Det er ennå ingen per-assistent-frakobling, så hvis du vil tilbakekalle dem én om gangen, gi hver assistent sin egen nøkkel.
  • Forespørsler til /mcp-endepunktet sjekkes for opprinnelsen: en ugjennomsiktig null-opprinnelse blir alltid avvist, og sjekken kan låses til en tillatelsesliste, men som standard godtas enhver ekte opprinnelse, så beskyttelsen er legitimasjonen din, ikke opprinnelsen. Hver økt er bundet til legitimasjonen som åpnet den.

For hvordan du autentiserer, se Autentisering — to alternativer; for de eksakte lesingene, beskyttede skrivingene og handlingene som skjer umiddelbart, se Hva du kan gjøre. Når du er klar, hopp til Koble til assistenten din og velg klienten din.

MCP-server-URL

MCP-server-URLhttps://mcp.flowmingo.ai/mcp

Koble til din assistent

Hvilken assistent bruker du?

Claude Code (CLI)

Én kommando legger til Flowmingo over native Streamable HTTP. Start med OAuth; den statiske --header er alternativet.

Trinn: 1) legg til serveren, 2) logg inn (nettleser → lim inn nøkkel), 3) claude mcp list for å bekrefte.

# 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

Merk: flagg må komme før navnet, og bruk alltid --transport http (aldri sse). Erstatt fl_YOUR_KEY med din fullstendige nøkkel (se Hva en fullstendig nøkkel består av i Autentiseringsdelen ovenfor).

Bekreft at det fungerer – spør: "list mine åpne stillinger."