Интеграции

Поврзете AI асистенти (MCP)

Поврзете кој било MCP-компатибилен AI асистент — Claude, Claude Code, ChatGPT, Cursor, VS Code и повеќе — со вашите податоци за вработување во Flowmingo, и работете со вашата листа на кандидати со обичен јазик.

Our team is online
Ви треба помош со интеграцијата?

Заглавивте на некој чекор или ви треба техничка поддршка? Нашиот тим со задоволство ќе ви помогне — јавете ни се во кое било време и ќе ве поврземе.

Преглед

Поврзете било кој MCP-компатибилен AI асистент со вашите податоци за вработување во Flowmingo — читајте ги вашите огласи и кандидати и преземајте заштитени дејства (покани, поместување, одбивање, отстранување од проект), безбедно, со ваша дозвола. Со две дополнителни дозволи кои сами ги вклучувате, асистентот може исто така да создава проекти за вработување и проценки и да објавува, затвора или промовира оглас за работа (видете Што можете да направите). Нови во MCP? Тоа е отворен стандард што им овозможува на AI асистентите да комуницираат со алатки како Flowmingo. Дознајте што е MCP.

Транспорт: Streamable HTTP (модерен далечински транспорт). Нема наследен SSE — секогаш насочувајте го вашиот клиент кон /mcp, никогаш кон /sse.

Третирајте го вашиот API клуч како лозинка. Претпочитајте OAuth, внес по поттик или променлива на околината отколку да вметнете суров fl_... клуч во датотека што може да ја испратите во git (на пр. .vscode/mcp.json, ~/.cursor/mcp.json, вашата Continue конфигурација).

Автентикација — две опции

А — Најава со Flowmingo (OAuth, препорачано). Вашиот прелистувач отвора страница за согласност на Flowmingo; таму го вметнувате вашиот API клуч. Асистентот никогаш не го добива вашиот суров клуч. Тој добива токен за пристап и токен за освежување, кои може да ги користи за да добие нов токен за пристап. Најавата не трае вечно. Токенот за освежување трае околу 30 дена стандардно, сметано од моментот на издавање, при најава или при последното освежување, така што најава што не се користи толку долго истекува, а издавање на Flowmingo што менува како се складираат најавите може да бара повторна најава. Потоа асистентот повторно ве замолува да се најавите, а вие повторно го вметнувате клучот. За побрзо прекинување, избришете го тој API клуч. Нема клиентски ID или тајна за создавање (Flowmingo користи Dynamic Client Registration). На клиенти што прикажуваат „Advanced“ OAuth поставки (на пр. Claude.ai), оставете ги Client ID и Secret празни.

Б — Статичен API клуч (заглавје). Испратете го вашиот клуч како било кое заглавје:

x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY

Земете го вашиот клуч во Flowmingo → Поставки → Интеграции → API клучеви. Обележете Read hiring data и Read candidates — првиот покрива огласи, тековни кандидати и резултати, вториот му овозможува на асистентот да пребара кандидат. Додадете Manage pipeline / Invite candidates за заштитените дејства за запишување. За да му овозможите на асистентот да создава проекти и проценки и да објавува или промовира оглас, исто така обележете Create hiring projects и Create assessments. Прво прочитајте Create and publish под Што можете да направите: овие две дозволи се изборни, а создавачот на клучот мора да биде Сопственик или Администратор.

Како изгледа комплетен клуч. Една долга вредност: fl_live_, јавното име на клучот, точка, па долга тајна. Тајната половина се прикажува еднаш, веднаш по создавањето на клучот; подоцна списокот со API клучеви ја прикажува само почетната вредност. Вредност без точка е само име на клучот и ќе биде одбиена. Каде и да пишува ова упатство fl_YOUR_KEY, заменете го целиот со вашиот комплетен клуч, без наводници и без празни места.

Ако не може да се поврзе. Лош или празен клуч се враќа како Missing credential или The Flowmingo API key was rejected; и двете може да значат дека вредноста никогаш не стигнала до нас во целост, затоа прво проверете ја вредноста. Поставка како ${env:FLOWMINGO_API_KEY} работи само ако програмата може да ја види таа променлива, а уредувачот отворен од дното на екранот или од Start менито често не ги чита поставките од терминалот. Или стартувајте го од терминал каде што променливата е поставена, или ставете го комплетниот клуч во датотеката (и чувајте ја таа датотека надвор од git).

Која да се избере? Повеќето клиенти поддржуваат и двете; неколку (на пр. ChatGPT) се само OAuth — секоја јазичка забележува што поддржува тој клиент. Генерално, OAuth одговара на интерактивни асистенти (Claude.ai, ChatGPT, VS Code); API-key заглавјето одговара на CLI, headless/CI и уредувачи каде што претпочитате да вметнете клуч.

Што можете да направите

Читањата не бараат одобрение. Повеќето запишувања се заштитени. Покана, одбивање направено со дејството Reject, отстранување кандидати од проект, бришење проект, или, обично, поместување во фаза што е поставена да испрати е-пошта до кандидатот, чека лице да го одобри на линк, најавено во Flowmingo. Асистентот не може да го одобри, а „да“ напишано во разговорот не се брои. Поставката за е-пошта на фазата се проверува кога се бара поместувањето. За белешка, оценка, краток список, ознака или поместување во фаза што не е поставена да испрати е-пошта до кандидатот, на асистентот му е кажано прво да ви покаже преглед и да продолжи само кога ќе се согласите, што е инструкција до него, не брава. Поттик што вашиот AI клиент го прикажува пред да изврши алатка е негова сопственост и не е одобрение од Flowmingo: покана, одбивање направено со дејството Reject и поместување во фаза со е-пошта сепак чекаат линк за одобрение, без разлика што побарал клиентот. Линкот за одобрение истекува по 15 минути, а едно барање за неколку кандидати или апликации (најмногу 50) е едно одобрение што ги наведува сите. Откако ќе се закаже промена, асистентот може да провери каде е, да ја повлече додека чека и да отповика реверзибилна промена (белешка, оценка, ознака на краток список, ознака или поместување што не испратило е-пошта) во рок од 24 часа. Отповикувањето не е секогаш достапно: промената мора да се врати со референца за отповикување, запишувањето е најдобро можно, а поместување за кандидат без претходна фаза нема такво, па асистентот треба да провери и да каже кога нема враќање назад. Испратена е-пошта не може да се отповика. Алатките наведени под Create and publish се исклучок од сето ова, освен delete_project: тие дејствуваат веднаш и не се закажани за одобрение. Отстранување и бришење проект не може да се отповикаат. Сè е ограничено на вашата организација.

Читај

Способност Што прави
Список на огласи за работа Прелистувајте ги отворените и затворените улоги на вашата организација.
Список на интервјуа & проекти Видете ги вашите проценки (интервјуа) од секаков вид (AI интервјуа, игра на улоги, тестови за вештини, технички тестови, евалуации на CV, презентации и снимки; прашалници кога ќе побарате) и вашите проекти за вработување.
Список на вашите тековни кандидати Прегледајте апликации по фаза низ проект.
Читај резултати & оценки од проценки Преземете резултати од секаков вид: AI интервјуа, игра на улоги, тестови за вештини, технички тестови, евалуации на CV, презентации, снимки и прашалници. Секој резултат е означен со свој вид. Само некои видови носат AI оценка: презентација и прашалник никогаш не се оценуваат, а тест за вештини е процент.
Пребарај кандидат Преземете име, е-пошта и CV на еден кандидат.
Пребарувај кандидати Најдете кандидати по име или е-пошта.
Споредувај кандидати Поредете 2 до 10 кандидати еден до друг. Потребна е дозволата Read candidates како и Read hiring data.
Преглед на вработување Функцијата за сè што вашата врска може да достигне (цела компанија, освен ако клучот е создаден од некој ограничен на одредени проекти), или стеснета кога ќе побарате: апликации по фаза, активни наспроти одбиени, и, за секој вид проценка што има резултати, завршени наспроти во тек и просечна оценка. Проект ги стеснува сите броеви, но неговите броеви на резултати ги покриваат резултатите на проценките поврзани со тој проект, па кандидат од друг проект што дели една од тие проценки може исто така да се брои. Проценка ги стеснува само броевите на резултати: броевите на фази и апликации остануваат на сè што вашата врска може да достигне. Видовите никогаш не се собираат заедно.
Топ кандидати Највисоко рангираните резултати, подредени по вкупна оценка. Секој вид проценка се рангира заедно освен ако не побарате еден вид или една проценка (интервју).
Детали за резултат од проценка Оценки по компетенции на еден резултат плус AI резиме, за видовите што ги имаат. Тест за вештини, технички тест, презентација и прашалник имаат малку или ништо.
Детали за оглас за работа Целосните детали на еден оглас за работа.
Дали огласот е јавно достапен? (get_job_post_publication) Дали некој може да ја отвори јавната страница на огласот: активен, се уште чека AI проверка на содржина, одбиен од неа, означен, исклучен или неговиот проект не е отворен. Исто така неговата јавна адреса и неговото промовирање (исклучено, flowmingo или extended). Потребна е Read hiring data.
Претстојни интервјуа Покани за било кој вид проценка што се испратени или закажани и се уште не се завршени. Не е број на сите што се уште чекаат: покана чиј кандидат е потсетен, или ја отворил или кликнал врската, се испушта додека кандидатот не започне, а исто така и онаа што не успеала да се достави.

Запиши (заштитено)

Способност Што прави
Покани кандидати на проценка Ги подготвува поканите за AI интервју, игра на улоги, тест за вештини или технички тест, и чека лице да ги одобри на линк. Ништо не се испраќа пред тоа. Една проценка и најмногу 50 кандидати по барање; тест за вештини или технички тест бара проект и е-пошта за секој кандидат, а спонзориран може да ја задолжи вашата организација кога кандидат ќе го започне.
Помести кандидат во друга фаза Поместување во фаза што е поставена да испрати е-пошта до кандидатот обично чека лице да го одобри на линк (поставката за е-пошта на фазата се чита еднаш, точно пред поместувањето, па поставка вклучена во тој момент може сепак да овозможи поместување со е-пошта без одобрение). Било кое друго поместување: на асистентот му е кажано да го прикаже прегледот и да чека вашето „да“, и обично може да се отповика 24 часа, кога ќе се врати со референца за отповикување. Најмногу 50 апликации по барање.
Одбиј апликација Бара одобрение на линк. Ако лице го одобри, Flowmingo се обидува да ја премести апликацијата во фазата „Одбиени“ на проектот; проверете го резултатот потоа. Најмногу 50 апликации по барање.
Отстрани кандидати од проект (remove_application) Потребна е Manage pipeline. Бара одобрение на линк. Ако лице го одобри, Flowmingo ги брише апликациите од проектот; профилот на кандидатот останува во вашиот талент пул и во други проекти. Не е одбивање и нема отповикување. Најмногу 50 апликации по барање.
Додај белешка на резултат На асистентот му е кажано да го прикаже предложениот текст и да чека вашето „да“ пред да го зачува. Белешката припаѓа на еден резултат од проценка (од било кој вид), не на кандидатот како целина.
Оцени резултат На асистентот му е кажано да ја прикаже оценката и да чека вашето „да“. Оценката се однесува на еден резултат од проценка.
Стави во краток список На асистентот му е кажано да ја прикаже промената за краток список и да чека вашето „да“. Се однесува на еден резултат од проценка.
Означи / додај во колекција на таленти На асистентот му е кажано да ја прикаже промената за ознака или колекција на таленти и да чека вашето „да“.
Провери, повлечи или отповикај промена Проверете каде е закажана промена (чека, извршена, неуспешна, истечена или заменета со поново барање), повлечете она што се уште чека одобрение, или отповикајте реверзибилна промена во рок од 24 часа, кога ќе се врати со референца за отповикување.

Create and publish (дејствува веднаш, освен бришење проект)

Овие алатки создаваат работи и ги отвораат за јавност. Тие се однесуваат поинаку од заштитените запишувања погоре:

  • Дејствуваат веднаш, освен delete_project. Ништо не е закажано за одобрение на линк, и ниту едно не испраќа е-пошта до кандидат. delete_project чека Сопственик или Администратор да го одобри на линк.
  • Создавачот на клучот мора да биде Сопственик или Администратор, за секоја алатка овде, освен откажувањето, кое бара само Invite candidates. Алатките дејствуваат со дозволите на лицето што го создало API клучот. Ако тоа лице е Член, повикот е одбиен.
  • Две дозволи се по избор. Create hiring projects и Create assessments не се дадени по дифолт. Со најава (опција А), асистентот ги добива само ако се исполнети и двете: клиентот ги наведува по име при поврзување, и API клучот што го залепите на страницата за согласност ги содржи. Клиент кој не испраќа листа на дозволи ги добива четирите стандардни дозволи (Read hiring data, Read candidates, Manage pipeline, Invite candidates) што ги има клучот, и ниту една од овие две, па асистентот не ги гледа алатките што ги бараат. Со статички клуч (опција Б), асистентот ги гледа овие алатки без разлика кои дозволи ги има клучот, и Flowmingo одбива секој повик што клучот не го дозволува.
  • Некои повици траат подолго. Објавувањето чека AI проверка на содржина, до околу 90 секунди. Создавањето проект или проценка користи AI генерација и може да трае подолго (технички тест трае 3 до 9 минути). Кога одговорот вели дека работата се уште е во тек, асистентот повторно повикува со истиот идемпотентен клуч за да прочита каде е. Повторување никогаш не создава втор проект или проценка.
Способност Што прави
Создај проект за вработување (create_project) Потребна е Create hiring projects (изборна). Создава проект со четирите стандардни фази и оглас за работа напишан од истиот AI како и контролната табла, од наслов, позиција и опционален опис. Стандардно, исто така создава CV евалуација и AI интервју; асистентот може да именува други проценки, или ниедна. Огласот е вклучен и станува јавен откако AI проверката на содржина го одобри, обично во рок од една минута. Ограничено на 10 проекти во минута и 300 дневно за вашата компанија. Идемпотентниот клуч е опционален: кога е изоставен, се создава од аргументите, па повторување никогаш не создава втор проект.
Создај проценка (create_assessment) Потребна е Create assessments (изборна). Создава една проценка со AI: AI интервју, CV евалуација, тест за вештини, презентација, технички тест или игра на улоги, од наслов за работа и опционален опис, име, проект и јазик (ознака како en или vi-VN; тест за вештини и технички тест го игнорираат јазикот). Прикачете го на проект за да може кандидатите да бидат поканети на тест за вештини, технички тест или презентација. Идемпотентниот клуч е опционален, како погоре.
Објави оглас (publish_job_post) Потребна е Create hiring projects. Го вклучува огласот и осигурува дека AI проверката на содржина е извршена. Одговорот кажува дали страницата е активна сега, се уште чека проверка или е одбиена од неа. Проектот за вработување мора да е активен.
Отстрани оглас (unpublish_job_post) Потребна е Create hiring projects. Го исклучува огласот, па јавниот линк престанува да работи. Стандардно, промовирањето е исто така исклучено (withdraw_boost е true).
Промовирај оглас (boost_job_post) Потребна е Create hiring projects. Ја поставува промоцијата на off, flowmingo или extended. Промовирањето е бесплатно. Зголемувањето бара вклучен оглас, активен проект, лого на компанијата и опис, и AI проверка; компанија може да зголеми 50 промоции дневно.
Отвори, скицирај или архивирај проект (set_project_state) Потребни Create hiring projects. Го движи проектот за вработување помеѓу active, draft и archived. Нацрт и архивирано ја затвораат врската за работата. Податоците за кандидатите се задржуваат.
Откажи закажана покана (cancel_scheduled_invite) Потребна е Invite candidates. Откажува покана што била закажана за подоцна и се уште не е испратена, користејќи го ID-то на поканата од резултатот. Никој не е известен преку е-пошта. Лицето останува во вашата сметка и на таблата на проектот.
Избриши проект за вработување (delete_project) Потребна е Create hiring projects (изборна). Само бара: не брише веднаш, бара одобрение на линк, и ништо не се брише додека Сопственик или Администратор не го одобри. Само активен проект може да се избрише. Ако лице го одобри, Flowmingo го брише проектот и неговите огласи; неговите апликации не се бришат една по една, а профилите и контактите на кандидатите, вашите проценки и линковите за покани се задржуваат. Нема отповикување.

Безбедност & доверба

  • Вашите податоци се организациски ограничени — асистентот никогаш не може да види податоци на друга компанија.
  • Со OAuth, асистентот никогаш не го добива вашиот API клуч. Тој добива токен за пристап што истекува по еден час, освежен тивко додека останува поврзан. Самата најава трае колку и нејзиниот токен за освежување, околу 30 дена стандардно од моментот на издавање или последно освежување, па истекува по околу 30 дена без употреба, и потоа повторно се најавувате. Со статично заглавје (опција Б), клиентот на вашиот асистент го држи вашиот клуч и го испраќа со секое барање, затоа чувајте го подалеку од датотеки што може да ги споделите или испратите.
  • Прекин на асистент: избришете го API клучот со кој сте го овластиле, во Поставки → Интеграции → API клучеви. Пристапот престанува веднаш. Се уште нема одвојување по асистент, па ако сакате да ги отповикате еден по еден, дајте му на секој асистент свој клуч.
  • Барањата до /mcp крајната точка се проверуваат за нивното потекло: непроѕирно null потекло секогаш се одбива, и проверката може да се заклучи на листа на дозволени, но стандардно секое вистинско потекло е прифатено, па заштитата е вашата акредитива, не потеклото. Секоја сесија е врзана за акредитивата што ја отворила.

За тоа како да се автентицирате, видете Автентикација — две опции; за точните читања, заштитени запишувања и дејства што се случуваат веднаш, видете Што можете да направите. Кога сте подготвени, скокнете на Поврзете го вашиот асистент и изберете го вашиот клиент.

MCP сервер URL

MCP сервер URLhttps://mcp.flowmingo.ai/mcp

Поврзете го вашиот асистент

Кој асистент го користите?

Claude Code (CLI)

Една команда додава Flowmingo преку нативниот Streamable HTTP. Водечки е OAuth; статичкиот --header е алтернатива.

Чекори: 1) додајте го серверот, 2) најавете се (прелистувач → залепете го клучот), 3) claude mcp list за проверка.

# 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

Важно: знамињата мора да дојдат пред името, и секогаш користете --transport http (никогаш sse). Заменете го fl_YOUR_KEY со вашиот целосен клуч (видете Како изгледа целосниот клуч во делот за автентикација погоре).

Проверете дали работи — прашајте: "наведи ги моите отворени позиции."