Integrationer

Forbind AI-assistenter (MCP)

Forbind enhver MCP-kompatibel AI-assistent — Claude, Claude Code, ChatGPT, Cursor, VS Code og mere — til dine Flowmingo-ansættelsesdata, og arbejd din pipeline med almindeligt sprog.

Our team is online
Har du brug for hjælp til integrationen?

Sidder du fast i et trin eller har du brug for teknisk support? Vores team hjælper gerne — kontakt os når som helst, så får vi dig hjulpet videre.

Oversigt

Forbind enhver MCP-kompatibel AI-assistent til dine Flowmingo-ansættelsesdata – læs dine job og kandidater og tag beskyttede handlinger (inviter, flyt, afvis, fjern fra et projekt), sikkert, med din tilladelse. Med to ekstra tilladelser, som du selv slår til, kan en assistent også oprette ansættelsesprojekter og vurderinger samt publicere, lukke eller booste et jobopslag (se Hvad du kan gøre). Ny til MCP? Det er den åbne standard, der lader AI-assistenter tale med værktøjer som Flowmingo. Lær hvad MCP er.

Transport: Streamable HTTP (den moderne fjernbetjeningstransport). Der er ingen ældre SSE – peg altid din klient på /mcp, aldrig /sse.

Behandl din API-nøgle som en adgangskode. Foretræk OAuth, en promptet indtastning eller en miljøvariabel frem for at indsætte en rå fl_...-nøgle i en fil, du måske committer til git (f.eks. .vscode/mcp.json, ~/.cursor/mcp.json, din Continue-konfiguration).

Godkendelse – to muligheder

A – Log ind med Flowmingo (OAuth, anbefalet). Din browser åbner en Flowmingo-samtykkeside; du indsætter din API-nøgle der. Assistenten modtager aldrig din rå nøgle. Den modtager et adgangstoken og et refresh-token, som den kan bruge til at få et nyt adgangstoken. Indlogningen varer ikke evigt. Refresh-tokenet lever omkring 30 dage som standard, regnet fra udstedelsen, ved indlogning eller seneste opdatering, så en indlogning, der ikke bruges i omkring så lang tid, udløber, og en Flowmingo-udgivelse, der ændrer, hvordan indlogninger gemmes, kan også kræve, at du logger ind igen. Assistenten beder dig derefter logge ind igen, og du indsætter din nøgle igen. For at afbryde det tidligere, slet den API-nøgle. Der er ingen klient-ID eller hemmelighed at oprette (Flowmingo bruger Dynamic Client Registration). På klienter, der viser "Avancerede" OAuth-indstillinger (f.eks. Claude.ai), lad Client ID og Secret være tomme.

B – Statisk API-nøgle (header). Send din nøgle som enten header:

x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY

Hent din nøgle i Flowmingo → Indstillinger → Integrationer → API-nøgler. Afkryds Read hiring data og Read candidates – den første dækker job, pipeline og resultater, den anden er det, der lader en assistent slå nogen op. Tilføj Manage pipeline / Invite candidates for de beskyttede skrivehandlinger. For at lade en assistent oprette projekter og vurderinger samt publicere eller booste et jobopslag, afkryds også Create hiring projects og Create assessments. Læs Opret og publicer under Hvad du kan gøre først: disse to tilladelser er opt-in, og nøglens skaber skal være en ejer eller en administrator.

Hvad en komplet nøgle ser ud som. Én lang værdi: fl_live_, nøglens offentlige navn, en prik, derefter en lang hemmelighed. Den hemmelige halvdel vises én gang, lige efter du opretter nøglen; senere viser API-nøglelisten kun begyndelsen af den. En værdi uden prik er kun nøglens navn, og den vil blive afvist. Hvor denne guide skriver fl_YOUR_KEY, skal du erstatte det hele med din komplette nøgle, uden anførselstegn og uden mellemrum.

Hvis den ikke vil forbinde. En dårlig eller tom nøgle kommer tilbage som Missing credential eller The Flowmingo API key was rejected; begge kan betyde, at værdien aldrig nåede os i sin helhed, så tjek værdien først. En indstilling som ${env:FLOWMINGO_API_KEY} fungerer kun, hvis programmet kan se den variabel, og en editor åbnet fra docken eller Startmenuen læser ofte ikke din terminalprofil. Start den enten fra en terminal, hvor variablen er sat, eller læg din komplette nøgle i filen (og hold den fil ude af git).

Hvilken skal du vælge? De fleste klienter understøtter begge; nogle få (f.eks. ChatGPT) er kun OAuth – hver fane noterer, hvad den klient understøtter. Generelt passer OAuth til interaktive assistenter (Claude.ai, ChatGPT, VS Code); API-nøgleheaderen passer til CLI'er, headless/CI og editorer, hvor du hellere vil indsætte en nøgle.

Hvad du kan gøre

Læsninger kræver ikke godkendelse. De fleste skrivninger er beskyttede. En invitation, en afvisning lavet med Afvis-handlingen, en fjernelse af kandidater fra et projekt, en sletning af et projekt eller normalt en flytning til et stadie, der er sat til at maile kandidaten, venter på, at en person godkender dem via et link, logget ind på Flowmingo. Assistenten kan ikke godkende det, og et ja skrevet i chatten tæller ikke. Stadiets e-mail-indstilling kontrolleres, når flytningen anmodes. For en note, en vurdering, en shortlist, et tag eller en flytning til et stadie, der ikke er sat til at maile kandidaten, får assistenten besked på at vise dig en forhåndsvisning først og kun fortsætte, når du er enig, hvilket er en instruktion til den, ikke en lås. En prompt, som din AI-klient viser, før den kører et værktøj, er klientens egen og er ikke Flowmingos godkendelse: en invitation, en afvisning lavet med Afvis-handlingen og en flytning til et mailende stadie venter stadig på godkendelseslinket, uanset hvad klienten spurgte. Et godkendelseslink udløber efter 15 minutter, og én anmodning for flere kandidater eller ansøgninger (højst 50) er én godkendelse, der lister alle. Når en ændring er oprettet, kan assistenten tjekke, hvor den står, trække den tilbage, mens den stadig venter, og fortryde en reversibel ændring (en note, en vurdering, en shortlist-markering, et tag eller en flytning, der ikke mailede til nogen) inden for 24 timer. En fortrydelse er ikke altid tilgængelig: ændringen skal komme tilbage med en fortrydelsesreference, og at registrere en er bedste indsats, og en flytning for en kandidat uden tidligere stadie har ingen, så assistenten bør tjekke og sige det, når der ikke er nogen vej tilbage. En e-mail, der er sendt, kan ikke fortrydes. Værktøjerne under Opret og publicer er undtagelsen til alt dette, undtagen delete_project: de handler med det samme og er ikke oprettet til godkendelse. En fjernelse og en projektsletning kan ikke fortrydes. Alt er afgrænset til din organisation.

Læs

Funktion Hvad den gør
Liste over jobopslag Gennemse din organisations åbne og lukkede roller.
Liste over interviewsæt og projekter Se dine vurderinger (interviewsæt) af alle slags (AI-interviews, rollespil, færdighedstests, tekniske tests, CV-evalueringer, showcases og optagelser; spørgeskemaer, når du beder om dem) og dine ansættelsesprojekter.
Liste over din kandidatpipeline Vis ansøgninger efter stadie på tværs af et projekt.
Læs vurderingsresultater og scoringer Hent resultater af alle slags: AI-interviews, rollespil, færdighedstests, tekniske tests, CV-evalueringer, showcases, optagelser og spørgeskemaer. Hvert resultat er mærket med sin slags. Kun nogle slags har en AI-score: en showcase og et spørgeskema scores aldrig, og en færdighedstest er en procentdel.
Slå en kandidat op Hent én kandidats navn, e-mail og CV.
Søg efter kandidater Find kandidater efter navn eller e-mail.
Sammenlign kandidater Stil 2 til 10 kandidater op side om side. Kræver Read candidates-tilladelsen samt Read hiring data.
Ansættelsesoversigt Tragten for alt, din forbindelse kan nå (hele virksomheden, medmindre nøglen blev lavet af nogen begrænset til nogle projekter), eller indsnævret, når du beder om det: ansøgninger per stadie, aktive vs. afviste, og for hver slags vurdering, der har resultater, fuldførte vs. igangværende resultater og gennemsnitsscoren. Et projekt indsnævrer alle tællinger, men dets resultattællinger dækker resultaterne på de vurderinger, der er knyttet til projektet, så en kandidat fra et andet projekt, der deler en af disse vurderinger, kan også tælles. En vurdering indsnævrer kun resultattællingerne: stadie- og ansøgningstællingerne forbliver på alt, din forbindelse kan nå. Slagsene lægges aldrig sammen.
Topkandidater De højest rangerede resultater, ordnet efter samlet score. Alle slags vurderinger rangeres sammen, medmindre du beder om én slags eller én vurdering (interviewsæt).
Detalje for vurderingsresultat Ét resultats per-kompetence-scoringer plus AI-sammenfatningen, for de slags, der har dem. En færdighedstest, en teknisk test, en showcase og et spørgeskema har lidt eller intet.
Detalje for jobopslag Den fulde detalje for et enkelt jobopslag.
Er et jobopslag offentligt? (get_job_post_publication) Om nogen kan åbne et jobopslags offentlige side: live, stadig venter på AI-indholdstjekket, afvist af det, markeret, slået fra, eller dets projekt er ikke åbent. Også dens offentlige adresse og dens boost (fra, flowmingo eller udvidet). Kræver Read hiring data.
Kommende interviews Invitationer til enhver slags vurdering, der er sendt eller planlagt og endnu ikke fuldført. Det er ikke et antal af alle, der stadig mangler: en invitation, hvis kandidat er blevet mindet om, eller har åbnet eller klikket på linket, udelades, indtil kandidaten starter, og det samme gælder en, der ikke blev leveret.

Skriv (beskyttet)

Funktion Hvad den gør
Inviter kandidater til en vurdering Forbereder invitationerne til et AI-interview, et rollespil, en færdighedstest eller en teknisk test og venter på, at en person godkender dem via et link. Intet sendes før det. Én vurdering og højst 50 kandidater per anmodning; en færdighedstest eller en teknisk test kræver et projekt og en e-mail til hver kandidat, og en sponsoreret kan debitere din organisations tegnebog, når en kandidat starter den.
Flyt en kandidat til et andet stadie En flytning til et stadie, der er sat til at maile kandidaten, venter normalt på, at en person godkender det via et link (stadiets e-mail-indstilling læses én gang, lige før flytningen, så en indstilling, der slås til i det øjeblik, kan stadig lade en flytning maile uden godkendelse). Enhver anden flytning: assistenten får besked på at forhåndsvise den og vente på dit ja, og den kan normalt fortrydes i 24 timer, når den kom tilbage med en fortrydelsesreference. Højst 50 ansøgninger per anmodning.
Afvis en ansøgning Anmoder om godkendelse via et link. Hvis en person godkender det, forsøger Flowmingo at flytte ansøgningen til projektets afviste stadie; tjek resultatet bagefter. Højst 50 ansøgninger per anmodning.
Fjern kandidater fra et projekt (remove_application) Kræver Manage pipeline. Anmoder om godkendelse via et link. Hvis en person godkender det, sletter Flowmingo ansøgningerne fra projektet; kandidatens profil forbliver i din talentpulje og i andre projekter. Det er ikke en afvisning, og der er ingen fortrydelse. Højst 50 ansøgninger per anmodning.
Tilføj en note til et resultat Assistenten får besked på at forhåndvise den foreslåede note og vente på dit ja, før den gemmes. En note hører til ét vurderingsresultat (af enhver slags), ikke til kandidaten som helhed.
Vurdér et resultat Assistenten får besked på at forhåndvise vurderingen og vente på dit ja. Vurderingen gælder for ét vurderingsresultat.
Shortlist et resultat Assistenten får besked på at forhåndvise shortlist-ændringen og vente på dit ja. Den gælder for ét vurderingsresultat.
Tag / tilføj til talentsamling Assistenten får besked på at forhåndvise tag- eller talentsamlingsændringen og vente på dit ja.
Tjek, træk tilbage eller fortryd en ændring Tjek, hvor en oprettet ændring står (venter, udført, mislykket, udløbet eller erstattet af en nyere anmodning), træk en tilbage, der stadig venter på godkendelse, eller fortryd en reversibel ændring inden for 24 timer, når den kom tilbage med en fortrydelsesreference.

Opret og publicer (handler med det samme, undtagen sletning af projekt)

Disse værktøjer opretter ting og åbner dem for offentligheden. De opfører sig anderledes end de beskyttede skrivninger ovenfor:

  • De handler med det samme, undtagen delete_project. Intet er oprettet til, at en person godkender via et link, og ingen af dem mailer en kandidat. delete_project venter på, at en ejer eller en administrator godkender det via et link.
  • Nøglens skaber skal være en ejer eller en administrator, for hvert værktøj her undtagen aflysningen, som kun kræver Invite candidates. Værktøjerne handler med tilladelserne fra den person, der oprettede API-nøglen. Hvis den person er et medlem, afvises kaldet.
  • To tilladelser er valgfrie. Create hiring projects og Create assessments gives ikke som standard. Med login (mulighed A) får assistenten dem kun, hvis begge dele er opfyldt: klienten angiver dem ved navn, når den opretter forbindelse, og den API-nøgle, du indsætter på godkendelsessiden, indeholder dem. En klient, der ikke sender en liste over tilladelser, får de fire standardtilladelser (Read hiring data, Read candidates, Manage pipeline, Invite candidates), som nøglen indeholder, og ingen af disse to, så assistenten ikke ser de værktøjer, der kræver dem. Med en statisk nøgle (mulighed B) vises assistenten disse værktøjer, uanset hvilke tilladelser nøglen har, og Flowmingo afviser ethvert kald, som nøglen ikke tillader.
  • Nogle kald tager et stykke tid. Publicering venter på AI-indholdstjekket, op til omkring 90 sekunder. Oprettelse af et projekt eller en vurdering bruger AI-generering og kan tage længere tid (en teknisk test tager 3 til 9 minutter). Når svaret siger, at arbejdet stadig afventer, kalder assistenten igen med den samme idempotensnøgle for at læse, hvor langt det er kommet. En gentagelse laver aldrig et andet projekt eller en anden vurdering.
Funktion Hvad den gør
Opret et ansættelsesprojekt (create_project) Kræver Create hiring projects (opt-in). Laver et projekt med dets fire standardstadier og et jobopslag skrevet af samme AI som dashboardet, fra en titel, stillingen og en valgfri beskrivelse. Som standard laver det også en CV-evaluering og et AI-interview; assistenten kan navngive andre vurderinger eller ingen. Jobopslaget er slået til og bliver offentligt, når AI-indholdstjekket godkender det, normalt inden for et minut. Begrænset til 10 projekter i minuttet og 300 om dagen for din virksomhed. Idempotensnøglen er valgfri: når den udelades, laves en fra argumenterne, så en gentagelse laver aldrig et andet projekt.
Opret en vurdering (create_assessment) Kræver Create assessments (opt-in). Laver én vurdering med AI: et AI-interview, en CV-evaluering, en færdighedstest, en showcase, en teknisk test eller et rollespil, ud fra en jobtitel og en valgfri jobbeskrivelse, navn, projekt og sprog (et tag som en eller vi-VN; en færdighedstest og en teknisk test ignorerer sproget). Tilknyt den til et projekt, så kandidater kan inviteres til en færdighedstest, en teknisk test eller en showcase. Idempotensnøglen er valgfri, som ovenfor.
Publicér et jobopslag (publish_job_post) Kræver Create hiring projects. Slår jobopslaget til og sikrer, at AI-indholdstjekket er kørt. Svaret siger, om siden er live nu, stadig venter på tjekket eller afvist af det. Ansættelsesprojektet skal være aktivt.
Afpublicér et jobopslag (unpublish_job_post) Kræver Create hiring projects. Slår jobopslaget fra, så dets offentlige link stopper med at åbne. Som standard slås boostet også fra (withdraw_boost er sandt).
Boost et jobopslag (boost_job_post) Kræver Create hiring projects. Sætter boostet til off, flowmingo eller extended. Boosting er gratis. Forhøjelse kræver jobopslaget slået til, dets projekt aktivt, en virksomhedslogo og beskrivelse og AI-indholdstjekket; en virksomhed kan hæve 50 boosts om dagen.
Åbn, udkast eller arkivér et projekt (set_project_state) Kræver Create hiring projects. Flytter et rekrutteringsprojekt mellem active, draft og archived. Udkast og arkiverede lukker joblinket. Kandidatdata opbevares.
Annullér en planlagt invitation (cancel_scheduled_invite) Kræver Invite candidates. Annullerer en invitation, der var planlagt til senere og endnu ikke er sendt, ved hjælp af invitations-id fra invitationsresultatet. Ingen får en e-mail. Personen forbliver på din konto og på projektets board.
Slet et ansættelsesprojekt (delete_project) Kræver Create hiring projects (opt-in). Det spørger kun: det sletter ikke med det samme, det anmoder om godkendelse via et link, og intet slettes, før en ejer eller en administrator godkender det. Kun et aktivt projekt kan slettes. Hvis en person godkender det, sletter Flowmingo projektet og dets jobopslag; dets kandidatansøgninger slettes ikke enkeltvis, og kandidatprofiler og kontakter, dine vurderinger og invitationslinks bevares. Der er ingen fortrydelse.

Sikkerhed og tillid

  • Dine data er organisationsafgrænset – assistenten kan aldrig se en anden virksomheds data.
  • Med OAuth modtager assistenten aldrig din API-nøgle. Den får et adgangstoken, der udløber efter en time, opdateret stille, mens den forbliver forbundet. Indlogningen selv varer lige så længe som dens refresh-token, omkring 30 dage som standard fra udstedelse eller sidste opdatering, så den udløber efter omkring 30 dage uden brug, og du logger så ind igen. Med en statisk header (mulighed B) holder din assisterende klient din nøgle og sender den med hver anmodning, så hold den ude af filer, du måske deler eller committer.
  • Afbryd en assistent: slet den API-nøgle, du godkendte den med, i Indstillinger → Integrationer → API-nøgler. Adgang stopper øjeblikkeligt. Der er endnu ingen per-assistent-frakobling, så hvis du vil tilbagekalde dem en ad gangen, giv hver assistent sin egen nøgle.
  • Anmodninger til /mcp-endepunktet kontrolleres for deres oprindelse: en uigennemsigtig null-oprindelse afvises altid, og kontrollen kan låses til en tilladelsesliste, men som standard accepteres enhver reel oprindelse, så beskyttelsen er din legitimationsoplysning, ikke oprindelsen. Hver session er bundet til den legitimationsoplysning, der åbnede den.

For hvordan du godkender, se Godkendelse – to muligheder; for de præcise læsninger, beskyttede skrivninger og handlinger, der sker med det samme, se Hvad du kan gøre. Når du er klar, spring til Forbind din assistent og vælg din klient.

MCP server URL

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

Forbind din assistent

Hvilken assistent bruger du?

Claude Code (CLI)

Én kommando tilføjer Flowmingo over native Streamable HTTP. Start med OAuth; den statiske --header er alternativet.

Trin: 1) tilføj serveren, 2) log ind (browser → indsæt nøgle), 3) claude mcp list for at bekræfte.

# 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

Fælde: flag skal komme før navnet, og brug altid --transport http (aldrig sse). Erstat fl_YOUR_KEY med din fulde nøgle (se Hvordan en fuld nøgle ser ud i afsnittet Authentication ovenfor).

Bekræft, at det virker — spørg: "list mine åbne jobs."