Обзор
Подключите любого 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
Подключите вашего ассистента
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 на ваш полный ключ (см. Как выглядит полный ключ в разделе «Аутентификация» выше).
Проверьте, что работает — спросите: «Список моих открытых вакансий»
Cursor
Статический заголовок — самый простой путь. Cursor также может использовать OAuth (он поддерживает динамическую регистрацию клиентов) — для этого удалите блок headers.
Шаги: 1) добавьте сервер в ~/.cursor/mcp.json (ниже), 2) установите FLOWMINGO_API_KEY в вашем профиле оболочки, 3) закройте Cursor и запустите его из терминала, где переменная установлена, 4) в Настройки → MCP выключите и включите сервер для перезагрузки.
Cursor должен видеть переменную. Cursor читает ${env:FLOWMINGO_API_KEY} из своего окружения. При запуске из дока или меню «Пуск» он часто не видит переменную, установленную в профиле терминала, и тогда заголовок приходит пустым или неразвернутым, а сервер отвечает Missing credential. Если запуск Cursor из терминала невозможен, замените ${env:FLOWMINGO_API_KEY} в файле на ваш полный ключ (и держите ~/.cursor/mcp.json вне git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth вместо этого — удалите блок headers; Cursor запускает динамическую регистрацию клиентов и открывает страницу согласия в браузере при первом подключении:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Убедитесь, что работает — спросите: "покажи мои открытые вакансии".
VS Code (Copilot, режим агента)
Инструменты появляются только в Copilot Chat → Режим агента. Корневой ключ — servers (а не mcpServers), а тип — http. Путь с запросом ключа ниже — это надежная настройка.
Шаги: 1) создайте .vscode/mcp.json (или выполните MCP: Add Server → HTTP), 2) при запуске сервера VS Code запросит ваш ключ (он не будет записан в файл), 3) используйте его в Режиме агента.
{
"servers": {
"flowmingo": {
"type": "http",
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${input:flowmingo_key}" }
}
},
"inputs": [
{ "id": "flowmingo_key", "type": "promptString", "description": "Flowmingo API key (fl_...)", "password": true }
]
}
VS Code также может попытаться использовать OAuth, но документированная конфигурация OAuth ожидает client ID; используйте путь с запросом ключа выше для надежной настройки.
Проверьте, работает ли это — спросите: "list my open jobs."
Claude — claude.ai и Claude Desktop
Оба используют один и тот же интерфейс коннекторов и тот же процесс вставки URL. Только OAuth (в интерфейсе нет поля для заголовка).
Шаги (веб или настольное приложение):
- Откройте Настройки → Коннекторы и нажмите Добавить пользовательский коннектор.
- Назовите его
Flowmingoи вставьте URL сервера MCP выше. Оставьте Дополнительно → OAuth Client ID / Secret пустыми. - Нажмите Добавить → Подключить. На странице согласия Flowmingo вставьте свой API-ключ
fl_и авторизуйтесь. - Проверьте — спросите Claude: "list my open jobs."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Команда / Enterprise: Владелец добавляет его один раз в разделе Настройки организации → Коннекторы → Пользовательские; затем участники нажимают Подключить.
Нужен статический ключ в Claude Desktop вместо этого? Используйте вкладку Любой клиент (mcp-remote).
При первом подключении ваш браузер откроет страницу согласия Flowmingo — вставьте ваш API-ключ и авторизуйтесь. Чтобы отключить доступ позже, удалите этот API-ключ в разделе Настройки → Интеграции → API-ключи.
ChatGPT и OpenAI Codex CLI
Оба являются продуктами OpenAI. ChatGPT использует Developer Mode для пользовательских коннекторов (только OAuth); Codex подключается нативно из CLI.
ChatGPT (веб)
- На chatgpt.com (Plus / Pro / Business / Enterprise / Edu — не мобильная версия) откройте Настройки → Приложения → Дополнительно и включите Режим разработчика.
- Приложения → Создать → назовите
Flowmingo, вставьте URL ниже, транспорт Streamable HTTP, авторизация OAuth. - Откройте черновик, включите инструменты и нажмите Обновить.
- Подключите его через меню + в чате.
Connector URL: https://mcp.flowmingo.ai/mcp
Transport: Streamable HTTP
Auth: OAuth (leave any static OAuth client ID / secret blank — Flowmingo uses Dynamic Client Registration)
Режим разработчика ChatGPT подключается только через OAuth — он не принимает статический x-api-key / пользовательский заголовок API-ключа. Обычные и глубокие исследовательские коннекторы используют только search + fetch (у вас есть оба). Инструменты записи (пригласить / переместить / отклонить) требуют режима разработчика. Подсказка, которую ChatGPT показывает перед запуском инструмента, принадлежит самому ChatGPT и не является одобрением Flowmingo: приглашение, отклонение и перемещение на этап, который отправляет письмо кандидату, всегда ожидают одобрения человека по ссылке Flowmingo.
OpenAI Codex CLI
Мост не нужен — Codex нативно поддерживает Streamable HTTP.
# ~/.codex/config.toml — static fl_ key as a bearer (simplest)
[mcp_servers.flowmingo]
url = "https://mcp.flowmingo.ai/mcp"
bearer_token_env_var = "FLOWMINGO_API_KEY" # export FLOWMINGO_API_KEY=fl_...
startup_timeout_sec = 20
tool_timeout_sec = 120
# Static API key (bearer from env) — simplest:
codex mcp add flowmingo --url https://mcp.flowmingo.ai/mcp --bearer-token-env-var FLOWMINGO_API_KEY
# export FLOWMINGO_API_KEY=fl_... (or set it in ~/.codex/config.toml [mcp_servers.flowmingo])
# OAuth instead (no key stored):
codex mcp add flowmingo --url https://mcp.flowmingo.ai/mcp
codex mcp login flowmingo
codex mcp list
Проверьте, что всё работает — спросите: "список моих открытых вакансий."
Gemini CLI и Code Assist
Gemini CLI (и режим агента Gemini Code Assist) обращаются к удаленному серверу MCP через ~/.gemini/settings.json. Потребительское приложение Gemini не может добавлять пользовательские коннекторы MCP — этот путь предназначен только для CLI / Code Assist.
Шаги: 1) добавьте сервер в mcpServers в ~/.gemini/settings.json, 2) экспортируйте FLOWMINGO_API_KEY=fl_..., 3) запустите gemini и /mcp, чтобы убедиться, что инструменты перечислены.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl выбирает нативный Streamable HTTP. Заполнитель ${FLOWMINGO_API_KEY} расширяется из вашей среды, поэтому необработанный ключ не записывается в файл. Предпочитаете OAuth? Gemini CLI может сделать это нативно — удалите блок headers и добавьте "authProviderType": "dynamic_discovery" к записи сервера. CLI обнаруживает вызов 401, находит наши метаданные OAuth и самостоятельно выполняет динамическую регистрацию клиента (без необходимости установки client ID).
Проверьте, работает ли это — в
geminiспросите: "list my open jobs."
Другие клиенты — Windsurf · Zed · Cline · Continue · Antigravity
Каждый клиент ниже работает с тем же сервером — большинство поддерживают и OAuth, и статический заголовок. В примерах используется статический ключ через переменную окружения; уберите headers, чтобы клиент мог использовать OAuth, если он это поддерживает. Обратите внимание на особенности имен ключей для каждого клиента, указанные ниже.
Google Antigravity
Добавьте https://mcp.flowmingo.ai/mcp как удаленный MCP-сервер и выберите аутентификацию: откроется страница Flowmingo, где запросят полный API-ключ (см. Что такое полный ключ в разделе «Аутентификация» выше). Каждая поверхность Antigravity (IDE, CLI) входит в систему отдельно. В mcp_config.json Antigravity адрес указывается в serverUrl, а статический ключ — в блоке headers как Authorization с Bearer и вашим полным ключом, как в примерах MCP для Antigravity от Google. Мы не смогли протестировать все версии Antigravity, поэтому, если ваши меню отличаются, в руководстве Google есть актуальные шаги.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf принимает serverUrl или url и поддерживает OAuth (уберите headers, чтобы его активировать).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — ключ — context_servers; уберите headers для нативного OAuth. Установите FLOWMINGO_API_KEY=fl_... в переменных окружения, а не вставляйте ключ напрямую.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP-серверы → Настройка — укажите type: "streamableHttp" (в camelCase), иначе по умолчанию будет нерабочий SSE.
{ "mcpServers": { "flowmingo": {
"type": "streamableHttp",
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" },
"disabled": false, "autoApprove": []
} } }
Continue.dev
~/.continue/config.yaml — подключитесь через мост mcp-remote. Установите FLOWMINGO_AUTH_HEADER = Bearer fl_YOUR_KEY.
name: Flowmingo MCP
version: 0.0.1
schema: v1
mcpServers:
- name: Flowmingo
command: npx
args: ["-y", "mcp-remote", "https://mcp.flowmingo.ai/mcp", "--transport", "http-only", "--header", "Authorization:${{ secrets.FLOWMINGO_AUTH_HEADER }}"]
Проверьте работу — спросите: «Список моих открытых вакансий».
Любой клиент (mcp-remote)
Для любого клиента, поддерживающего только stdio (или будущего клиента без нативного удаленного транспорта), подключитесь к Flowmingo с помощью команды stdio mcp-remote. Требуется --transport http-only — на сервере нет SSE.
Шаги: 1) убедитесь, что Node ≥ 18, 2) запустите мост как stdio-команду в вашем клиенте, 3) при первом запуске OAuth откроется браузер — вставьте ваш ключ.
# Bare terminal — OAuth, caches the token in ~/.mcp-auth:
npx -y mcp-remote https://mcp.flowmingo.ai/mcp --transport http-only
# Static key (no browser): --header on its own arg is fine
npx -y mcp-remote https://mcp.flowmingo.ai/mcp --transport http-only \
--header "x-api-key: fl_YOUR_KEY"
{
"mcpServers": {
"flowmingo": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.flowmingo.ai/mcp",
"--transport", "http-only", "--header", "x-api-key:${FLOWMINGO_KEY}"],
"env": { "FLOWMINGO_KEY": "fl_YOUR_KEY" }
}
}
}
Спасение: если авторизация зависла, выполните rm -rf ~/.mcp-auth и повторите попытку. Замените fl_YOUR_KEY на ваш полный ключ (см. Как выглядит полный ключ в разделе Аутентификация выше). В JSON args[] избегайте пробела после двоеточия в заголовке (особенность экранирования npx).
Проверьте, что всё работает — спросите: "список моих открытых вакансий."