Интеграции

Подключить 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).

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

A — Вход через Flowmingo (OAuth, рекомендуется). В вашем браузере откроется страница согласия Flowmingo; вы вставляете туда свой API-ключ. Ассистент никогда не получает ваш сырой ключ. Он получает токен доступа и токен обновления, которые можно использовать для получения нового токена доступа. Вход не действует вечно. Срок действия токена обновления — около 30 дней по умолчанию, считая с момента его выдачи, при входе или последнем обновлении, поэтому вход, который не использовался примерно столько времени, истекает, и выпуск Flowmingo, который меняет способ хранения входов, также может потребовать повторного входа. Затем ассистент попросит вас снова войти, и вы снова вставите свой ключ. Чтобы оборвать доступ раньше, удалите этот API-ключ. Не нужно создавать идентификатор клиента или секрет (Flowmingo использует динамическую регистрацию клиентов). В клиентах, которые показывают «Дополнительные» настройки 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, удаление кандидатов из проекта, удаление проекта или, как правило, перемещение на этап, который настроен на отправку письма кандидату, ожидает одобрения человека по ссылке, вошедшего в Flowmingo. Ассистент не может одобрить это, и «да», напечатанное в чате, не считается. Настройка письма этапа проверяется при запросе перемещения. Для заметки, оценки, шорт-листа, тега или перемещения на этап, который не настроен на отправку письма кандидату, ассистенту предписано сначала показать вам предварительный просмотр и действовать только после вашего согласия — это инструкция для него, а не блокировка. Подсказка, которую ваш AI-клиент показывает перед запуском инструмента, является собственностью клиента и не является одобрением Flowmingo: приглашение, отклонение с помощью действия Reject и перемещение на этап с отправкой письма по-прежнему ожидают ссылки одобрения, независимо от того, что спросил клиент. Ссылка одобрения истекает через 15 минут, и один запрос на несколько кандидатов или откликов (максимум 50) — это одно одобрение, в котором перечислены все. После того как изменение запланировано, ассистент может проверить его статус, отозвать его, пока оно ожидает, и отменить обратимое изменение (заметку, оценку, отметку в шорт-листе, тег или перемещение, которое не отправило писем) в течение 24 часов. Отмена доступна не всегда: изменение должно вернуться со ссылкой на отмену, запись такой ссылки — это best effort, и для перемещения кандидата без предыдущего этапа её нет, поэтому ассистент должен проверить и сказать, если пути назад нет. Отправленное письмо нельзя отменить. Инструменты, перечисленные в разделе Создание и публикация, являются исключением из всего этого, кроме delete_project: они действуют немедленно и не ожидают одобрения. Удаление и удаление проекта нельзя отменить. Всё ограничено вашей организацией.

Чтение

Возможность Что делает
Список вакансий Просмотр открытых и закрытых ролей вашей организации.
Список интервью-наборов и проектов Просмотр ваших оценок (интервью-наборов) всех видов (AI-интервью, ролевые игры, тесты навыков, технические тесты, оценка CV, шоукейсы и записи; анкеты по запросу) и ваших проектов найма.
Список вашей воронки кандидатов Просмотр откликов по этапам в рамках проекта.
Чтение результатов оценок и баллов Получение результатов всех видов: AI-интервью, ролевые игры, тесты навыков, технические тесты, оценка CV, шоукейсы, записи и анкеты. Каждый результат помечен своим видом. Только некоторые виды имеют AI-оценку: шоукейс и анкета никогда не оцениваются, а тест навыков — это процент.
Поиск кандидата Получение имени, email и CV одного кандидата.
Поиск кандидатов Поиск кандидатов по имени или email.
Сравнение кандидатов Сопоставление от 2 до 10 кандидатов рядом. Требуется разрешение Read candidates, а также Read hiring data.
Обзор найма Воронка для всего, что доступно вашему подключению (вся компания, если ключ создан не ограниченным пользователем), или суженная по запросу: отклики по этапам, активные vs отклонённые, и для каждого вида оценки с результатами — завершённые vs в процессе и средний балл. Проект сужает все подсчёты, но его подсчёты результатов охватывают результаты оценок, связанных с этим проектом, поэтому кандидат из другого проекта, который использует одну из этих оценок, также может быть учтён. Оценка сужает только подсчёты результатов: количество этапов и откликов остаётся на уровне всего, что доступно вашему подключению. Виды никогда не суммируются.
Лучшие кандидаты Самые высокие результаты, упорядоченные по общему баллу. Все виды оценок ранжируются вместе, если вы не запросите один вид или одну оценку (интервью-набор).
Детали результата оценки Баллы по компетенциям одного результата плюс AI-резюме, для видов, у которых они есть. Тест навыков, технический тест, шоукейс и анкета имеют мало или не имеют их.
Детали вакансии Полная информация об одной вакансии.
Открыта ли вакансия для публики? (get_job_post_publication) Может ли кто-либо открыть публичную страницу вакансии: активна, всё ещё ожидает проверки AI-контентом, отклонена им, помечена флагом, отключена или её проект не открыт. Также её публичный адрес и её продвижение (выкл, flowmingo или расширенное). Требуется Read hiring data.
Предстоящие интервью Приглашения на любой вид оценки, которые были отправлены или запланированы и ещё не завершены. Это не количество всех, кто ещё не завершил: приглашение, по которому кандидату напомнили, или он открыл или перешёл по ссылке, исключается, пока кандидат не начнёт, и то же самое для не доставленных приглашений.

Запись (защищено)

Возможность Что делает
Приглашение кандидатов на оценку Подготавливает приглашения для AI-интервью, ролевой игры, теста навыков или технического теста и ожидает одобрения человека по ссылке. Ничего не отправляется до этого. Одна оценка и максимум 50 кандидатов на запрос; тест навыков или технический тест требует проекта и email для каждого кандидата, и спонсируемый тест может списать средства с кошелька вашей организации, когда кандидат его начнёт.
Перемещение кандидата на другой этап Перемещение на этап, который настроен на отправку письма кандидату, обычно ожидает одобрения человека по ссылке (настройка письма этапа считывается один раз, непосредственно перед перемещением, поэтому настройка, включённая в этот момент, всё ещё может позволить перемещению отправить письмо без одобрения). Любое другое перемещение: ассистенту предписано показать предварительный просмотр и дождаться вашего «да», и его обычно можно отменить в течение 24 часов, если оно вернулось со ссылкой на отмену. Максимум 50 откликов на запрос.
Отклонение отклика Запрашивает одобрение по ссылке. Если человек одобряет, Flowmingo пытается переместить отклик на этап «Отклонено» проекта; проверьте результат после. Максимум 50 откликов на запрос.
Удаление кандидатов из проекта (remove_application) Требуется Manage pipeline. Запрашивает одобрение по ссылке. Если человек одобряет, Flowmingo удаляет отклики из проекта; профиль кандидата остаётся в вашем кадровом резерве и в других проектах. Это не отклонение, и отмены нет. Максимум 50 откликов на запрос.
Добавление заметки к результату Ассистенту предписано показать предварительный просмотр предлагаемой заметки и дождаться вашего «да» перед сохранением. Заметка относится к одному результату оценки (любого вида), а не к кандидату в целом.
Оценка результата Ассистенту предписано показать предварительный просмотр оценки и дождаться вашего «да». Оценка применяется к одному результату оценки.
Добавление в шорт-лист Ассистенту предписано показать предварительный просмотр изменения шорт-листа и дождаться вашего «да». Это относится к одному результату оценки.
Тег / добавление в коллекцию талантов Ассистенту предписано показать предварительный просмотр изменения тега или коллекции талантов и дождаться вашего «да».
Проверка, отзыв или отмена изменения Проверка статуса запланированного изменения (ожидает, выполнено, не удалось, истекло или заменено более новым запросом), отзыв того, что всё ещё ожидает одобрения, или отмена обратимого изменения в течение 24 часов, если оно вернулось со ссылкой на отмену.

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

Эти инструменты создают объекты и открывают их для публики. Они ведут себя иначе, чем защищённые записи выше:

  • Они действуют немедленно, кроме delete_project. Ничего не ожидает одобрения человека по ссылке, и ни один из них не отправляет письма кандидату. 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 приглашения из результата приглашения. Никому не отправляется письмо. Кандидат остаётся в вашем аккаунте и на доске проекта.
Удаление проекта найма (delete_project) Требуется Create hiring projects (добровольно). Он только запрашивает: не удаляет сразу, а запрашивает одобрение по ссылке, и ничего не удаляется, пока владелец или администратор не одобрит. Можно удалить только активный проект. Если человек одобряет, Flowmingo удаляет проект и его вакансии; кандидатские отклики не удаляются по одному, а профили и контакты кандидатов, ваши оценки и ссылки на приглашения сохраняются. Отмены нет.

Безопасность и доверие

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

О том, как аутентифицироваться, см. Аутентификация — два варианта; о точных операциях чтения, защищённых записях и действиях, которые выполняются сразу, см. Что вы можете делать. Когда будете готовы, переходите к Подключение вашего ассистента и выберите свой клиент.

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 на ваш полный ключ (см. Как выглядит полный ключ в разделе «Аутентификация» выше).

Проверьте, что работает — спросите: «Список моих открытых вакансий»