Преглед
Свържете всеки MCP-съвместим AI асистент с вашите данни за наемане във Flowmingo — четете вашите обяви и кандидати и извършвайте защитени действия (покана, преместване, отхвърляне, премахване от проект) сигурно, с ваше разрешение. С две допълнителни разрешения, които включвате сами, асистент може също да създава проекти за наемане и оценки и да публикува, затваря или популяризира обява за работа (вижте Какво можете да правите). Нов в MCP? Това е отвореният стандарт, който позволява на AI асистентите да комуникират с инструменти като Flowmingo. Научете какво е MCP.
Транспорт: Streamable HTTP (модерният отдалечен транспорт). Няма стар SSE — винаги насочвайте клиента си към /mcp, никога към /sse.
Отнасяйте се към API ключа си като към парола. Предпочитайте OAuth, подканен вход или environment variable пред поставянето на суров
fl_...ключ във файл, който може да запишете в git (напр..vscode/mcp.json,~/.cursor/mcp.json, вашата Continue конфигурация).
Удостоверяване — две опции
A — Вход с Flowmingo (OAuth, препоръчително). Вашият браузър отваря страница за съгласие на Flowmingo; там поставяте вашия API ключ. Асистентът никога не получава суровия ви ключ. Той получава access token и refresh token, които може да използва за получаване на нов access token. Входът не е вечен. Refresh tokenът живее около 30 дни по подразбиране, считано от издаването му, при входа или при последното обновяване, така че вход, който не се използва толкова време, изтича, и версия на Flowmingo, която променя начина на съхранение на входовете, може също да изисква повторен вход. След това асистентът ви моли да влезете отново и вие отново поставяте ключа си. За да прекъснете по-рано, изтрийте този API ключ. Няма client ID или secret за създаване (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} работи само ако програмата вижда тази променлива, а редактор, отворен от dock или менюто Start, често не чете профила на терминала. Или го стартирайте от терминал, където променливата е зададена, или поставете пълния ключ във файла (и пазете този файл извън 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 оценка: шоукейс и въпросник никога не се оценяват, а тестът за умения е процент. |
| Търсене на кандидат | Извличайте име, имейл и CV на един кандидат. |
| Търсене на кандидати | Намерете кандидати по име или имейл. |
| Сравняване на кандидати | Подредете 2 до 10 кандидати един до друг. Изисква разрешение Read candidates, както и Read hiring data. |
| Преглед на наемане | Фунията за всичко, до което връзката ви може да достигне (цялата компания, освен ако ключът не е създаден от някой, ограничен до определени проекти), или стеснена, когато поискате: кандидатури по етапи, активни срещу отхвърлени, и за всеки вид оценка с резултати — завършени срещу текущи резултати и средна оценка. Проект стеснява всички бройки, но неговите бройки за резултати покриват резултатите от оценките, свързани с проекта, така че кандидат от друг проект, който споделя една от тези оценки, също може да бъде броен. Оценка стеснява само бройките за резултати: бройките за етапи и кандидатури остават за всичко, до което връзката ви може да достигне. Видовете никога не се сумират. |
| Топ кандидати | Най-високо класираните резултати, подредени по обща оценка. Всички видове оценки се класират заедно, освен ако не поискате един вид или една оценка (интервю). |
| Детайли за резултат от оценка | Резултатите по компетенции на един резултат плюс AI резюмето, за видовете, които ги имат. Тест за умения, технически тест, шоукейс и въпросник имат малко или никакви. |
| Детайли за обява за работа | Пълните детайли на една обява за работа. |
Отворена ли е обявата за работа към публиката? (get_job_post_publication) |
Дали всеки може да отвори публичната страница на обява: активна, все още чакаща AI проверка на съдържанието, отказана от нея, маркирана, изключена или проектът ѝ не е отворен. Също и публичният адрес и популяризирането (изключено, flowmingo или разширено). Изисква Read hiring data. |
| Предстоящи интервюта | Покани за какъвто и да е вид оценка, които са изпратени или насрочени и още не са завършени. Това не е брой на всички неизпълнени: покана, чийто кандидат е напомнен, или е отворил/кликнал на линка, се пропуска, докато кандидатът не започне, както и такава, която не е доставена. |
Запис (защитен)
| Възможност | Какво прави |
|---|---|
| Покана на кандидати за оценка | Подготвя поканите за AI интервю, ролева игра, тест за умения или технически тест и изчаква одобрение от човек на линк. Нищо не се изпраща преди това. Една оценка и най-много 50 кандидати на заявка; тест за умения или технически тест изисква проект и имейл за всеки кандидат, и спонсориран може да дебитира портфейла на организацията ви, когато кандидат започне. |
| Преместване на кандидат на друг етап | Преместване на етап, който е настроен да изпраща имейл на кандидата, по принцип изчаква одобрение от човек на линк (настройката за имейл на етапа се чете веднъж, точно преди преместването, така че настройка, включена в този момент, може все пак да позволи имейл без одобрение). Всяко друго преместване: на асистента е указано да покаже преглед и да изчака вашето „да“, и обикновено може да бъде отменено за 24 часа, когато се е върнало с референция за отмяна. Най-много 50 кандидатури на заявка. |
| Отхвърляне на кандидатура | Изисква одобрение на линк. Ако човек одобри, Flowmingo се опитва да премести кандидатурата в етапа Rejected на проекта; проверете резултата след това. Най-много 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 ключ. Той получава access token, който изтича след час, обновяван тихо, докато остава свързан. Самият вход трае колкото refresh token-а му, около 30 дни по подразбиране от издаването или последното обновяване, така че изтича след около 30 дни без употреба и след това влизате отново. Със статична заглавка (опция B) клиентът на вашия асистент държи ключа и го изпраща с всяка заявка, така че го пазете извън файлове, които може да споделите или запишете.
- Прекъсване на асистент: изтрийте API ключа, с който сте го упълномощили, в Настройки → Интеграции → API ключове. Достъпът спира незабавно. Все още няма прекъсване за отделен асистент, така че ако искате да ги оттеглите един по един, дайте на всеки асистент собствен ключ.
- Заявките към
/mcpкрайната точка се проверяват за техния Origin: непрозраченnullorigin винаги се отказва, и проверката може да бъде заключена към allowlist, но по подразбиране всеки реален 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
Статичният header е най-простият път. Cursor може също да използва OAuth (поддържа Dynamic Client Registration) — за това, премахнете блока headers.
Стъпки: 1) добавете сървъра към ~/.cursor/mcp.json (по-долу), 2) задайте FLOWMINGO_API_KEY с вашия пълен ключ в профила на вашата обвивка, 3) затворете Cursor и го стартирайте от терминал, където променливата е зададена, 4) в Settings → MCP, изключете и включете сървъра, за да го презаредите.
Cursor трябва да вижда променливата. Cursor чете ${env:FLOWMINGO_API_KEY} от собствената си среда. Стартиран от Dock или менюто Start, често не вижда променлива, зададена в профила на терминала, и тогава header-ът пристига празен или неразширен, а сървърът отговаря 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 изпълнява Dynamic Client Registration и отваря браузър с екран за съгласие при първо свързване:
{
"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
И двата използват един и същ UI за конектори и един и същ поток с поставяне на URL. Само OAuth (няма поле за хедър в UI).
Стъпки (уеб или десктоп):
- Отворете Настройки → Конектори и щракнете върху Добавяне на персонализиран конектор.
- Наименувайте го
Flowmingoи поставете MCP URL адреса по-горе. Оставете Разширени → 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)
Екип / Корпоративен: Собственик добавя това веднъж под Настройки на организацията → Конектори → Персонализирани; членовете след това щракват върху Свързване.
Нуждаете се от статичен ключ на 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 — не mobile), отворете Settings → Apps → Advanced и включете Developer mode.
- Apps → Create → име
Flowmingo, поставете URL-а по-долу, транспорт Streamable HTTP, auth OAuth. - Отворете черновата, включете инструментите и Refresh.
- Прикачете я чрез менюто + в чат.
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)
Developer Mode на ChatGPT се свързва само чрез OAuth — не приема статичен x-api-key / персонализиран API-key header. Обикновените и deep-research конектори използват само search + fetch (имате и двете). Write инструментите (invite / move / reject) изискват Developer Mode. Подкана, която 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 избира нативен Поточен 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 и вашия пълен ключ, както в примерите на Google за Antigravity MCP. Не сме успели да тестваме всяка версия на 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-only клиент (или бъдещ клиент без собствен отдалечен транспорт), свържете се с Flowmingo чрез командата mcp-remote stdio. Изисква се --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).
Проверете дали работи — попитайте: „изброй моите отворени позиции.“