Інтеграції

Підключити AI-асистентів (MCP)

Підключіть будь-якого сумісного з MCP AI-асистента — Claude, Claude Code, ChatGPT, Cursor, VS Code та інші — до ваших даних про найм у Flowmingo та працюйте з вашим пайплайном простою мовою.

Our team is online
Потрібна допомога з інтеграцією?

Застрягли на якомусь кроці чи потрібна технічна підтримка? Наша команда радо допоможе — звертайтеся будь-коли, і ми вас підключимо.

Огляд

Підключіть будь-який AI-асистент, сумісний з MCP, до ваших даних про найм у Flowmingo — читайте ваші вакансії та кандидатів і виконуйте контрольовані дії (запрошення, переміщення, відхилення, видалення з проєкту) безпечно, з вашого дозволу. З двома додатковими дозволами, які ви вмикаєте самостійно, асистент також може створювати проєкти найму та оцінювання, публікувати, закривати або просувати вакансію (див. Що ви можете робити). Новачок у MCP? Це відкритий стандарт, який дозволяє AI-асистентам взаємодіяти з такими інструментами, як Flowmingo. Дізнайтеся, що таке MCP.

Транспорт: Streamable HTTP (сучасний віддалений транспорт). Легасі SSE немає — завжди вказуйте клієнту /mcp, а не /sse.

Ставтеся до вашого API-ключа як до пароля. Надавайте перевагу OAuth, введенню за запитом або змінній середовища, а не вставлянню сирого ключа fl_... у файл, який ви можете закомітити в git (напр. .vscode/mcp.json, ~/.cursor/mcp.json, ваш конфіг Continue).

Автентифікація — два варіанти

A — Вхід через Flowmingo (OAuth, рекомендовано). Ваш браузер відкриває сторінку згоди Flowmingo; ви вставляєте свій API-ключ там. Асистент ніколи не отримує ваш сирий ключ. Він отримує токен доступу та токен оновлення, які може використати для отримання нового токена доступу. Вхід не триває вічно. Токен оновлення за замовчуванням живе близько 30 днів, відлічуючи від моменту видачі, при вході або останньому оновленні, тому вхід, який не використовувався приблизно цей час, втрачає чинність, а реліз Flowmingo, який змінює спосіб зберігання входів, також може вимагати повторного входу. Асистент тоді попросить вас увійти знову, і ви знову вставите ключ. Щоб перервати раніше, видаліть цей API-ключ. Не потрібно створювати Client ID або секрет (Flowmingo використовує Dynamic Client Registration). На клієнтах, які показують "Додаткові" налаштування OAuth (напр. Claude.ai), залиште Client ID і Secret порожніми.

B — Статичний 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. Спочатку прочитайте Створення та публікація у розділі "Що ви можете робити": ці два дозволи є добровільними, і творець ключа має бути Власником або Адміністратором.

Як виглядає повний ключ. Одне довге значення: fl_live_, публічна назва ключа, крапка, потім довгий секрет. Секретна половина показується один раз, одразу після створення ключа; пізніше список API-ключів показує лише його початок. Значення без крапки — це лише назва ключа, і воно буде відхилено. Усюди, де в цьому посібнику написано fl_YOUR_KEY, замініть усе це на ваш повний ключ, без лапок і пробілів.

Якщо не вдається підключитися. Поганий або порожній ключ повертається як Missing credential або The Flowmingo API key was rejected; обидва можуть означати, що значення не дійшло до нас повністю, тому спершу перевірте значення. Таке налаштування, як ${env:FLOWMINGO_API_KEY}, працює лише якщо програма може бачити цю змінну, а редактор, відкритий із дока або меню "Пуск", часто не читає ваш профіль термінала. Або запустіть його з термінала, де змінна встановлена, або вставте повний ключ у файл (і тримайте цей файл поза git).

Що обрати? Більшість клієнтів підтримують обидва; деякі (напр. ChatGPT) є лише OAuth — кожна вкладка зазначає, що підтримує цей клієнт. Загалом OAuth підходить для інтерактивних асистентів (Claude.ai, ChatGPT, VS Code); заголовок API-ключа підходить для CLI, headless/CI та редакторів, де ви радше вставите ключ.

Що ви можете робити

Читання не потребує схвалення. Більшість записів є контрольованими. Запрошення, відхилення через дію Reject, видалення кандидатів із проєкту, видалення проєкту або, зазвичай, переміщення на етап, який налаштовано на надсилання email кандидату, чекає, поки людина схвалить це за посиланням, увійшовши в Flowmingo. Асистент не може це схвалити, а "так", надруковане в чаті, не зараховується. Налаштування email етапу перевіряється, коли надсилається запит на переміщення. Для нотатки, оцінки, шортліста, тега або переміщення на етап, який не налаштовано на надсилання email кандидату, асистенту вказано спочатку показати попередній перегляд і діяти лише за вашою згодою, що є інструкцією для нього, а не блокуванням. Підказка, яку ваш AI-клієнт показує перед запуском інструмента, є власною підказкою клієнта, а не схваленням Flowmingo: запрошення, відхилення через дію Reject і переміщення на етап із надсиланням email все одно чекають на посилання схвалення, що б не питав клієнт. Посилання схвалення втрачає чинність через 15 хвилин, а один запит на кількох кандидатів або заявок (не більше 50) — це одне схвалення, яке перелічує всіх. Після того як зміну поставлено в чергу, асистент може перевірити її статус, відкликати, поки вона ще чекає, і скасувати оборотну зміну (нотатку, оцінку, позначку шортліста, тег або переміщення, яке нікому не надіслало email) протягом 24 годин. Скасування доступне не завжди: зміна має повернутися з посиланням на скасування, запис якого є найкращою спробою, а для кандидата без попереднього етапу його немає, тому асистент повинен перевірити та сказати, коли шляху назад немає. Надісланий email не можна скасувати. Інструменти, перелічені в Create and publish, є винятком із цього всього, крім delete_project: вони діють одразу і не ставляться в чергу на схвалення. Видалення та видалення проєкту не можна скасувати. Усе обмежено вашою організацією.

Читання

Можливість Що вона робить
Перелік вакансій Перегляд відкритих і закритих ролей вашої організації.
Перелік інтерв’ю-наборів і проєктів Перегляд ваших оцінювань (інтерв’ю-наборів) усіх видів (AI-інтерв’ю, рольові ігри, тести навичок, технічні тести, оцінювання CV, презентації та записи; анкети, якщо попросите) і ваших проєктів найму.
Перелік вашого конвеєра кандидатів Перегляд заявок за етапами в межах проєкту.
Читання результатів оцінювання та балів Отримання результатів усіх видів: AI-інтерв’ю, рольові ігри, тести навичок, технічні тести, оцінювання CV, презентації, записи та анкети. Кожен результат позначено його видом. Лише деякі види мають AI-бал: презентація та анкета ніколи не оцінюються, а тест навичок — це відсоток.
Пошук кандидата Отримання імені, email і CV одного кандидата.
Пошук кандидатів Пошук кандидатів за іменем або email.
Порівняння кандидатів Вирівнювання від 2 до 10 кандидатів поруч. Потребує дозволу Read candidates, а також Read hiring data.
Огляд найму Воронка для всього, що може досягти ваше підключення (уся компанія, якщо ключ не створено кимось, обмеженим певними проєктами), або звужена за вашим запитом: заявки за етапами, активні проти відхилених, і для кожного виду оцінювання з результатами — завершені проти в процесі, а також середній бал. Проєкт звужує всі підрахунки, але його підрахунки результатів охоплюють результати оцінювань, прив’язаних до цього проєкту, тому кандидат іншого проєкту, який має спільне одне з цих оцінювань, також може бути врахований. Оцінювання звужує лише підрахунки результатів: підрахунки етапів і заявок залишаються для всього, що може досягти ваше підключення. Види ніколи не додаються разом.
Топ-кандидати Найвищі результати, відсортовані за загальним балом. Усі види оцінювань ранжуються разом, якщо ви не попросите один вид або одне оцінювання (інтерв’ю-набір).
Деталі результату оцінювання Оцінки за компетенціями одного результату плюс AI-резюме, для видів, які їх мають. Тест навичок, технічний тест, презентація та анкета мають мало або взагалі нічого.
Деталі вакансії Повні деталі однієї вакансії.
Чи відкрита вакансія для публіки? (get_job_post_publication) Чи може будь-хто відкрити публічну сторінку вакансії: активна, ще чекає на AI-перевірку контенту, відхилена нею, позначена, вимкнена або її проєкт не відкритий. Також її публічна адреса та просування (вимкнено, flowmingo або extended). Потребує Read hiring data.
Майбутні інтерв’ю Запрошення на будь-який вид оцінювання, які були надіслані або заплановані й ще не завершені. Це не підрахунок усіх, хто ще не відповів: запрошення, де кандидату нагадали, або він відкрив чи натиснув посилання, пропускається, доки кандидат не почне, так само як і те, що не вдалося доставити.

Запис (контрольований)

Можливість Що вона робить
Invite candidates до оцінювання Підготовка запрошень для AI-інтерв’ю, рольової гри, тесту навичок або технічного тесту та очікування, поки людина схвалить їх за посиланням. Нічого не надсилається до цього. Одне оцінювання і не більше 50 кандидатів на запит; тест навичок або технічний тест потребує проєкту та email для кожного кандидата, а спонсорований може списати кошти з гаманця вашої організації, коли кандидат почне його.
Переміщення кандидата на інший етап Переміщення на етап, який налаштовано на надсилання email кандидату, зазвичай чекає, поки людина схвалить це за посиланням (налаштування email етапу зчитується один раз, безпосередньо перед переміщенням, тому налаштування, увімкнене в цей момент, може все ж дозволити переміщенню надіслати email без схвалення). Будь-яке інше переміщення: асистенту вказано показати попередній перегляд і чекати вашого "так", і його зазвичай можна скасувати протягом 24 годин, якщо воно повернулося з посиланням на скасування. Не більше 50 заявок на запит.
Відхилення заявки Запит схвалення за посиланням. Якщо людина схвалить, Flowmingo намагається перемістити заявку на етап "Відхилено" проєкту; перевірте результат після цього. Не більше 50 заявок на запит.
Видалення кандидатів із проєкту (remove_application) Потребує Manage pipeline. Запит схвалення за посиланням. Якщо людина схвалить, Flowmingo видаляє заявки з проєкту; профіль кандидата залишається у вашому кадровому резерві та в інших проєктах. Це не відхилення, і скасування немає. Не більше 50 заявок на запит.
Додавання нотатки до результату Асистенту вказано показати попередній перегляд запропонованої нотатки та чекати вашого "так" перед збереженням. Нотатка належить одному результату оцінювання (будь-якого виду), а не кандидату загалом.
Оцінка результату Асистенту вказано показати попередній перегляд оцінки та чекати вашого "так". Оцінка застосовується до одного результату оцінювання.
Додавання до шортліста результату Асистенту вказано показати попередній перегляд зміни шортліста та чекати вашого "так". Вона застосовується до одного результату оцінювання.
Тег / додавання до колекції талантів Асистенту вказано показати попередній перегляд зміни тега або колекції талантів та чекати вашого "так".
Перевірка, відкликання або скасування зміни Перевірка, де стоїть зміна в черзі (очікує, виконана, не вдалася, минула або замінена новішим запитом), відкликання тієї, що ще чекає на схвалення, або скасування оборотної зміни протягом 24 годин, якщо вона повернулася з посиланням на скасування.

Створення та публікація (діє одразу, крім видалення проєкту)

Ці інструменти створюють речі та відкривають їх для публіки. Вони поводяться інакше, ніж контрольовані записи вище:

  • Вони діють одразу, крім delete_project. Нічого не ставиться в чергу для схвалення людиною за посиланням, і жоден із них не надсилає email кандидату. delete_project чекає, поки Власник або Адміністратор схвалить його за посиланням.
  • Творець ключа має бути Власником або Адміністратором, для кожного інструмента тут, крім скасування, яке потребує лише Invite candidates. Інструменти діють із дозволами особи, яка створила API-ключ. Якщо ця особа є Учасником, виклик буде відхилено.
  • Два дозволи є необов’язковими. Create hiring projects та Create assessments не надаються за замовчуванням. З входом у систему (варіант A) асистент отримує їх лише якщо виконуються обидві умови: клієнт явно вказує їх у списку при підключенні, а ключ API, який ви вставляєте на сторінці згоди, містить ці дозволи. Якщо клієнт не надсилає список дозволів, він отримує чотири стандартні дозволи (Read hiring data, Read candidates, Manage pipeline, Invite candidates), які містить ключ, але не ці два, тому асистент не бачить інструменти, що їх потребують. Зі статичним ключем (варіант B) асистенту показуються ці інструменти незалежно від дозволів ключа, а 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 запрошення з результату запрошення. Нікому не надсилається email. Особа залишається у вашому обліковому записі та на дошці проєкту.
Видалення проєкту найму (delete_project) Потребує Create hiring projects (добровільний). Він лише просить: не видаляє одразу, а запитує схвалення за посиланням, і нічого не видаляється, доки Власник або Адміністратор не схвалить. Лише активний проєкт можна видалити. Якщо людина схвалить, Flowmingo видаляє проєкт та його вакансії; заявки кандидатів не видаляються по одній, а профілі кандидатів і контакти, ваші оцінювання та посилання на запрошення зберігаються. Скасування немає.

Безпека та довіра

  • Ваші дані обмежені організацією — асистент ніколи не може бачити дані іншої компанії.
  • Із OAuth асистент ніколи не отримує ваш API-ключ. Він отримує токен доступу, який закінчується через годину, тихо оновлюючись, поки він залишається підключеним. Сам вхід триває стільки, скільки його токен оновлення, за замовчуванням близько 30 днів від моменту видачі або останнього оновлення, тому він втрачає чинність приблизно через 30 днів без використання, і ви тоді входите знову. Зі статичним заголовком (варіант B) клієнт вашого асистента зберігає ваш ключ і надсилає його з кожним запитом, тому тримайте його поза файлами, які ви можете поширювати або комітити.
  • Вимкнення асистента: видаліть API-ключ, яким ви його авторизували, у Налаштування → Інтеграції → API-ключі. Доступ припиняється негайно. Поки немає окремого відключення для кожного асистента, тому якщо ви хочете відкликати їх по одному, дайте кожному асистенту власний ключ.
  • Запити до кінцевої точки /mcp перевіряються на походження: непрозоре походження null завжди відхиляється, і перевірка може бути заблокована списком дозволених, але за замовчуванням приймається будь-яке реальне походження, тому захистом є ваш обліковий запис, а не походження. Кожна сесія прив’язана до облікового запису, який її відкрив.

Про автентифікацію див. Автентифікація — два варіанти; про точні читання, контрольовані записи та дії, які відбуваються одразу, див. Що ви можете робити. Коли будете готові, перейдіть до Підключіть свого асистента і оберіть клієнта.

URL сервера MCP

URL сервера MCPhttps://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 на ваш повний ключ (див. розділ Що таке повний ключ в розділі Автентифікація вище).

Перевірте, що все працює — запитайте: "список моїх відкритих вакансій."