Integrationer

Anslut AI-assistenter (MCP)

Anslut vilken MCP-kompatibel AI-assistent som helst — Claude, Claude Code, ChatGPT, Cursor, VS Code och mer — till dina Flowmingo-rekryteringsdata, och arbeta med din pipeline på vanligt språk.

Our team is online
Behöver du hjälp med integrationen?

Har du fastnat på ett steg eller behöver du teknisk support? Vårt team hjälper dig gärna — hör av dig när som helst, så ser vi till att du kommer vidare.

Översikt

Anslut valfri MCP-kompatibel AI-assistent till din Flowmingo-rekryteringsdata – läs dina jobb och kandidater och vidta säkra åtgärder (bjud in, flytta, avvisa, ta bort från ett projekt) på ett säkert sätt, med din tillåtelse. Med två extra behörigheter som du själv aktiverar kan en assistent också skapa rekryteringsprojekt och bedömningar samt publicera, stänga eller boosta en jobbannons (se Vad du kan göra). Ny på MCP? Det är den öppna standarden som låter AI-assistenter prata med verktyg som Flowmingo. Lär dig vad MCP är.

Transport: Streamable HTTP (den moderna fjärrtransporten). Det finns ingen äldre SSE – peka alltid din klient mot /mcp, aldrig /sse.

Behandla din API-nyckel som ett lösenord. Föredra OAuth, en efterfrågad inmatning eller en miljövariabel framför att klistra in en rå fl_...-nyckel i en fil som du kanske committar till git (t.ex. .vscode/mcp.json, ~/.cursor/mcp.json, din Continue-konfiguration).

Autentisering – två alternativ

A – Logga in med Flowmingo (OAuth, rekommenderas). Din webbläsare öppnar en Flowmingo-samtyckessida; du klistrar in din API-nyckel där. Assistenten får aldrig din råa nyckel. Den får en åtkomsttoken och en uppdateringstoken, som den kan använda för att få en ny åtkomsttoken. Inloggningen varar inte för evigt. Uppdateringstoken lever cirka 30 dagar som standard, räknat från när den utfärdades, vid inloggning eller senaste uppdatering, så en inloggning som inte används under ungefär så lång tid förfaller, och en Flowmingo-version som ändrar hur inloggningar lagras kan också kräva att du loggar in igen. Assistenten ber dig sedan att logga in igen, och du klistrar in din nyckel igen. För att avbryta tidigare, ta bort den API-nyckeln. Det finns ingen klient-ID eller hemlighet att skapa (Flowmingo använder Dynamic Client Registration). På klienter som visar "Avancerade" OAuth-inställningar (t.ex. Claude.ai), lämna Client ID och Secret tomma.

B – Statisk API-nyckel (header). Skicka din nyckel som endera headern:

x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY

Hämta din nyckel i Flowmingo → Inställningar → Integreringar → API-nycklar. Markera Read hiring data och Read candidates – den första täcker jobb, pipeline och resultat, den andra låter en assistent slå upp någon. Lägg till Manage pipeline / Invite candidates för de säkra skrivåtgärderna. För att låta en assistent skapa projekt och bedömningar samt publicera eller boosta en jobbannons, markera även Create hiring projects och Create assessments. Läs Skapa och publicera under Vad du kan göra först: dessa två behörigheter är opt-in, och nyckelns skapare måste vara ägare eller administratör.

Hur en komplett nyckel ser ut. Ett långt värde: fl_live_, nyckelns publika namn, en punkt, sedan en lång hemlighet. Den hemliga delen visas en gång, direkt efter att du skapar nyckeln; senare visar API-nyckellistan bara början av den. Ett värde utan punkt är bara nyckelns namn och kommer att avvisas. Varhelst denna guide skriver fl_YOUR_KEY, ersätt allt med din kompletta nyckel, utan citattecken och mellanslag.

Om det inte ansluter. En dålig eller tom nyckel returneras som Missing credential eller The Flowmingo API key was rejected; båda kan betyda att värdet aldrig nådde oss i sin helhet, så kontrollera värdet först. En inställning som ${env:FLOWMINGO_API_KEY} fungerar bara om programmet kan se variabeln, och en editor som öppnas från dockan eller Start-menyn läser ofta inte din terminalprofil. Starta antingen från en terminal där variabeln är inställd, eller sätt in din kompletta nyckel i filen (och håll filen utanför git).

Vilket ska du välja? De flesta klienter stödjer båda; några (t.ex. ChatGPT) är OAuth-only – varje flik noterar vad klienten stödjer. Generellt passar OAuth interaktiva assistenter (Claude.ai, ChatGPT, VS Code); API-nyckel-headern passar CLI, headless/CI och editorer där du hellre klistrar in en nyckel.

Vad du kan göra

Läsningar kräver inget godkännande. De flesta skrivningar är skyddade. En inbjudan, ett avvisande gjort med Reject-åtgärden, en borttagning av kandidater från ett projekt, en radering av ett projekt, eller normalt en flytt till ett steg som är inställt på att maila kandidaten, väntar på att en person godkänner det via en länk, inloggad på Flowmingo. Assistenten kan inte godkänna det, och ett "ja" som skrivs i chatten räknas inte. Stegets e-postinställning kontrolleras när flytten begärs. För en anteckning, ett betyg, en shortlist, en tagg eller en flytt till ett steg som inte är inställt på att maila kandidaten, får assistenten instruktionen att visa en förhandsvisning först och bara fortsätta när du samtycker, vilket är en instruktion till den, inte ett lås. En uppmaning som din AI-klient visar innan den kör ett verktyg är klientens egen och är inte Flowmingos godkännande: en inbjudan, ett avvisande gjort med Reject-åtgärden och en flytt till ett mailande steg väntar fortfarande på godkännandelänken, oavsett vad klienten frågade. En godkännandelänk förfaller efter 15 minuter, och en begäran för flera kandidater eller ansökningar (högst 50) är ett godkännande som listar alla. När en ändring är iscensatt kan assistenten kontrollera var den står, dra tillbaka den medan den fortfarande väntar, och ångra en reversibel ändring (en anteckning, ett betyg, en shortlistmarkering, en tagg eller en flytt som inte mailade någon) inom 24 timmar. En ångra är inte alltid tillgänglig: ändringen måste komma tillbaka med en ångra-referens, att spela in en är bästa möjliga, och en flytt för en kandidat utan tidigare steg har ingen, så assistenten bör kontrollera och säga till när det inte finns någon väg tillbaka. Ett e-postmeddelande som har skickats kan inte ångras. Verktygen som listas under Skapa och publicera är undantaget från allt detta, förutom delete_project: de agerar omedelbart och är inte iscensatta för godkännande. En borttagning och en projektradering kan inte ångras. Allt är begränsat till din organisation.

Läs

Förmåga Vad den gör
Lista jobbannonser Bläddra bland din organisations öppna och stängda roller.
Lista intervjuuppsättningar & projekt Se dina bedömningar (intervjuuppsättningar) av alla slag (AI-intervjuer, rollspel, färdighetstester, tekniska tester, CV-bedömningar, showcases och inspelningar; enkäter när du ber om dem) och dina rekryteringsprojekt.
Lista din kandidatpipeline Visa ansökningar per steg inom ett projekt.
Läs bedömningsresultat & poäng Hämta resultat av alla slag: AI-intervjuer, rollspel, färdighetstester, tekniska tester, CV-bedömningar, showcases, inspelningar och enkäter. Varje resultat är märkt med sitt slag. Endast vissa slag har en AI-poäng: en showcase och en enkät poängsätts aldrig, och ett färdighetstest är en procentsats.
Slå upp en kandidat Hämta en kandidats namn, e-post och CV.
Sök kandidater Hitta kandidater efter namn eller e-post.
Jämför kandidater Rad upp 2 till 10 kandidater sida vid sida. Kräver Read candidates behörigheten samt Read hiring data.
Rekryteringsöversikt Tratten för allt din anslutning kan nå (hela företaget, om inte nyckeln skapades av någon begränsad till vissa projekt), eller avsmalnad när du frågar: ansökningar per steg, aktiva vs avvisade, och för varje typ av bedömning som har resultat, slutförda vs pågående resultat och genomsnittspoängen. Ett projekt avsmalnar varje räkning, men dess resultaträkningar täcker resultaten på bedömningarna kopplade till det projektet, så en kandidat från ett annat projekt som delar en av dessa bedömningar kan också räknas. En bedömning avsmalnar bara resultaträkningarna: steg- och ansökningsräkningarna förblir på allt din anslutning kan nå. Slagen summeras aldrig.
Toppkandidater De högst rankade resultaten, sorterade efter totalpoäng. Alla typer av bedömningar rankas tillsammans om du inte ber om ett slag eller en bedömning (intervjuuppsättning).
Bedömningsresultatdetalj Ett results poäng per kompetens plus AI-sammanfattningen, för de slag som har dem. Ett färdighetstest, ett tekniskt test, en showcase och en enkät har lite eller inget.
Jobbannonsdetalj Fullständig information om en enskild jobbannons.
Är en jobbannons offentlig? (get_job_post_publication) Om vem som helst kan öppna en jobbannons publika sida: live, fortfarande väntar på AI-innehållskontrollen, avvisad av den, flaggad, avstängd, eller dess projekt är inte öppet. Även dess publika adress och dess boost (av, flowmingo eller utökad). Kräver Read hiring data.
Kommande intervjuer Inbjudningar till alla typer av bedömningar som skickats eller är schemalagda och ännu inte slutförda. Det är inte en räkning av alla som fortfarande är utestående: en inbjudan vars kandidat har påmints, eller har öppnat eller klickat på länken, utelämnas tills kandidaten börjar, och detsamma gäller en som inte levererades.

Skriv (skyddad)

Förmåga Vad den gör
Invite candidates till en bedömning Förbereder inbjudningarna för en AI-intervju, ett rollspel, ett färdighetstest eller ett tekniskt test och väntar på att en person godkänner dem via en länk. Ingenting skickas innan dess. En bedömning och högst 50 kandidater per begäran; ett färdighetstest eller ett tekniskt test kräver ett projekt och en e-post för varje kandidat, och ett sponsrat kan debitera din organisations plånbok när en kandidat påbörjar det.
Flytta en kandidat till ett annat steg En flytt till ett steg som är inställt på att maila kandidaten väntar normalt på att en person godkänner det via en länk (stegets e-postinställning läses en gång, precis innan flytten, så en inställning som slås på i det ögonblicket kan fortfarande låta en flytt maila utan godkännande). Alla andra flyttar: assistenten får instruktionen att förhandsvisa den och vänta på ditt ja, och den kan vanligtvis ångras i 24 timmar, när den kom tillbaka med en ångra-referens. Högst 50 ansökningar per begäran.
Avvisa en ansökan Begär godkännande via en länk. Om en person godkänner det försöker Flowmingo flytta ansökan till projektets avvisade steg; kontrollera resultatet efteråt. Högst 50 ansökningar per begäran.
Ta bort kandidater från ett projekt (remove_application) Kräver Manage pipeline. Begär godkännande via en länk. Om en person godkänner det tar Flowmingo bort ansökningarna från projektet; kandidatens profil finns kvar i din talent pool och i andra projekt. Det är inte ett avvisande, och det finns ingen ångra. Högst 50 ansökningar per begäran.
Lägg till en anteckning till ett resultat Assistenten får instruktionen att förhandsvisa den föreslagna anteckningen och vänta på ditt ja innan den sparar den. En anteckning tillhör ett bedömningsresultat (av vilket slag som helst), inte kandidaten som helhet.
Betygsätt ett resultat Assistenten får instruktionen att förhandsvisa betyget och vänta på ditt ja. Betyget gäller ett bedömningsresultat.
Shortlista ett resultat Assistenten får instruktionen att förhandsvisa shortliständringen och vänta på ditt ja. Den gäller ett bedömningsresultat.
Tagga / lägg till i talent collection Assistenten får instruktionen att förhandsvisa tagg- eller talent-collection-ändringen och vänta på ditt ja.
Kontrollera, dra tillbaka eller ångra en ändring Kontrollera var en iscensatt ändring står (väntar, utförd, misslyckad, utgången eller ersatt av en nyare begäran), dra tillbaka en som fortfarande väntar på godkännande, eller ångra en reversibel ändring inom 24 timmar, när den kom tillbaka med en ångra-referens.

Skapa och publicera (agerar omedelbart, förutom att radera ett projekt)

Dessa verktyg skapar saker och öppnar dem för allmänheten. De beter sig annorlunda än de skyddade skrivningarna ovan:

  • De agerar omedelbart, förutom delete_project. Ingenting är iscensatt för en person att godkänna via en länk, och ingen av dem mailar en kandidat. delete_project väntar på att en ägare eller administratör godkänner det via en länk.
  • Nyckelns skapare måste vara ägare eller administratör, för alla verktyg här förutom avbrytandet, som bara kräver Invite candidates. Verktygen agerar med behörigheterna för personen som skapade API-nyckeln. Om den personen är medlem nekas anropet.
  • Två behörigheter är frivilliga. Create hiring projects och Create assessments ges inte som standard. Vid inloggning (alternativ A) får assistenten dem bara om båda villkoren är uppfyllda: klienten listar dem vid namn när den ansluter, och API-nyckeln du klistrar in på samtyckessidan innehar dem. En klient som inte skickar någon lista över behörigheter får de fyra standardbehörigheterna (Read hiring data, Read candidates, Manage pipeline, Invite candidates) som nyckeln innehar, och ingen av dessa två, så assistenten ser inte verktygen som kräver dem. Med en statisk nyckel (alternativ B) visas dessa verktyg för assistenten oavsett vilka behörigheter nyckeln innehar, och Flowmingo nekar alla anrop som nyckeln inte tillåter.
  • Vissa anrop tar tid. Publicering väntar på AI-innehållskontrollen, upp till cirka 90 sekunder. Att skapa ett projekt eller en bedömning använder AI-generering och kan ta längre tid (ett tekniskt test tar 3 till 9 minuter). När svaret säger att arbetet fortfarande är pågående anropar assistenten igen med samma idempotensnyckel för att läsa var den har kommit. En nytt försök skapar aldrig ett andra projekt eller en andra bedömning.
Förmåga Vad den gör
Skapa ett rekryteringsprojekt (create_project) Kräver Create hiring projects (opt-in). Skapar ett projekt med dess fyra standardsteg och en jobbannons skriven av samma AI som instrumentpanelen, från en titel, positionen och en valfri beskrivning. Som standard skapar det också en CV-bedömning och en AI-intervju; assistenten kan namnge andra bedömningar, eller inga. Jobbannonsen är påslagen och blir offentlig när AI-innehållskontrollen godkänner den, normalt inom en minut. Begränsat till 10 projekt per minut och 300 per dag för ditt företag. Idempotensnyckeln är valfri: när den utelämnas skapas en från argumenten, så ett nytt försök skapar aldrig ett andra projekt.
Skapa en bedömning (create_assessment) Kräver Create assessments (opt-in). Skapar en bedömning med AI:n: en AI-intervju, en CV-bedömning, ett färdighetstest, en showcase, ett tekniskt test eller ett rollspel, från en jobbtitel och en valfri jobbbeskrivning, namn, projekt och språk (en tagg som en eller vi-VN; ett färdighetstest och ett tekniskt test ignorerar språket). Koppla den till ett projekt så att kandidater kan bjudas in till ett färdighetstest, ett tekniskt test eller en showcase. Idempotensnyckeln är valfri, som ovan.
Publicera en jobbannons (publish_job_post) Kräver Create hiring projects. Slår på jobbannonsen och säkerställer att AI-innehållskontrollen har körts. Svaret säger om sidan är live nu, fortfarande väntar på kontrollen eller avvisad av den. Rekryteringsprojektet måste vara aktivt.
Avpublicera en jobbannons (unpublish_job_post) Kräver Create hiring projects. Stänger av jobbannonsen, så dess publika länk slutar öppnas. Som standard stängs boosten också av (withdraw_boost är true).
Boost en jobbannons (boost_job_post) Kräver Create hiring projects. Ställer in boosten på off, flowmingo eller extended. Boosting är gratis. Att höja den kräver att jobbannonsen är påslagen, dess projekt aktivt, en företagslogotyp och beskrivning, och AI-innehållskontrollen; ett företag kan höja 50 boostar per dag.
Öppna, utkast eller arkivera ett projekt (set_project_state) Kräver Create hiring projects. Flyttar ett rekryteringsprojekt mellan active, draft och archived. Utkast och arkiverade stänger jobblänken. Kandidatdata behålls.
Avbryt en schemalagd inbjudan (cancel_scheduled_invite) Kräver Invite candidates. Avbryter en inbjudan som var schemalagd för senare och ännu inte skickats, med hjälp av inbjudnings-ID:t från inbjudningsresultatet. Ingen mailas. Personen finns kvar på ditt konto och på projektets anslagstavla.
Radera ett rekryteringsprojekt (delete_project) Kräver Create hiring projects (opt-in). Den frågar bara: den raderar inte omedelbart, den begär godkännande via en länk, och ingenting raderas förrän en ägare eller administratör godkänner det. Endast ett aktivt projekt kan raderas. Om en person godkänner det raderar Flowmingo projektet och dess jobbannonser; dess kandidatansökningar raderas inte en och en, och kandidatprofiler och kontakter, dina bedömningar och inbjudningslänkar behålls. Det finns ingen ångra.

Säkerhet & förtroende

  • Din data är organisationsbegränsad – assistenten kan aldrig se ett annat företags data.
  • Med OAuth får assistenten aldrig din API-nyckel. Den får en åtkomsttoken som upphör efter en timme, uppdateras tyst medan den förblir ansluten. Själva inloggningen varar lika länge som dess uppdateringstoken, cirka 30 dagar som standard från när den utfärdades eller senast uppdaterades, så den förfaller efter cirka 30 dagar utan användning, och du loggar sedan in igen. Med en statisk header (alternativ B) håller din assistents klient din nyckel och skickar den med varje begäran, så håll den borta från filer du kan dela eller committa.
  • Koppla bort en assistent: ta bort API-nyckeln du auktoriserade den med, i Inställningar → Integreringar → API-nycklar. Åtkomst upphör omedelbart. Det finns ingen per-assistent frånkoppling ännu, så om du vill återkalla dem en i taget, ge varje assistent sin egen nyckel.
  • Förfrågningar till slutpunkten /mcp kontrolleras för deras ursprung: en ogenomskinlig null-ursprung nekas alltid, och kontrollen kan låsas till en tillåtelselista, men som standard accepteras varje riktigt ursprung, så skyddet är din autentisering, inte ursprunget. Varje session är bunden till autentiseringen som öppnade den.

För hur du autentiserar, se Autentisering – två alternativ; för exakta läsningar, skyddade skrivningar och åtgärder som sker omedelbart, se Vad du kan göra. När du är redo, hoppa till Anslut din assistent och välj din klient.

MCP-server-URL

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

Anslut din assistent

Vilken assistent använder du?

Claude Code (CLI)

Ett kommando lägger till Flowmingo över inbyggd Streamable HTTP. Börja med OAuth; den statiska --header är alternativet.

Steg: 1) lägg till servern, 2) logga in (webbläsare → klistra in nyckel), 3) claude mcp list för att verifiera.

# 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

OBS: flaggor måste komma före namnet, och använd alltid --transport http (aldrig sse). Ersätt fl_YOUR_KEY med din fullständiga nyckel (se Vad en fullständig nyckel består av i avsnittet Autentisering ovan).

Verifiera att det fungerar — fråga: "lista mina öppna jobb."