Visió general
Connecta qualsevol assistent d'IA compatible amb MCP a les teves dades de contractació de Flowmingo: llegeix les teves ofertes i candidats i realitza accions protegides (convidar, moure, rebutjar, eliminar d'un projecte), de manera segura, amb el teu permís. Amb dos permisos addicionals que actives tu mateix, un assistent també pot crear projectes de contractació i avaluacions, i publicar, tancar o promocionar una oferta de feina (consulta Què pots fer). Nou a MCP? És l'estàndard obert que permet als assistents d'IA parlar amb eines com Flowmingo. Aprèn què és MCP.
Transport: Streamable HTTP (el transport remot modern). No hi ha SSE heretat: apunta sempre el teu client a /mcp, mai a /sse.
Tracta la teva clau API com una contrasenya. Prefereix OAuth, una entrada sol·licitada o una variable d'entorn en lloc d'enganxar una clau
fl_...en un fitxer que puguis enviar a git (per exemple,.vscode/mcp.json,~/.cursor/mcp.json, la teva configuració de Continue).
Autenticació — dues opcions
A — Inicia sessió amb Flowmingo (OAuth, recomanat). El teu navegador obre una pàgina de consentiment de Flowmingo; hi enganxes la teva clau API. L'assistent mai rep la teva clau en brut. Rep un token d'accés i un token de refresc, que pot utilitzar per obtenir un nou token d'accés. L'inici de sessió no dura per sempre. El token de refresc dura uns 30 dies per defecte, comptats des de la seva emissió, a l'inici de sessió o al darrer refresc, així que un inici de sessió que no s'utilitza durant aquest temps caduca, i una versió de Flowmingo que canviï com s'emmagatzemen els inicis de sessió també pot requerir que tornis a iniciar sessió. L'assistent et demanarà llavors que tornis a iniciar sessió, i que enganxis la teva clau de nou. Per tallar-ho abans, elimina aquesta clau API. No cal crear cap ID de client o secret (Flowmingo utilitza Dynamic Client Registration). En clients que mostren opcions OAuth "Avançades" (per exemple, Claude.ai), deixa l'ID de client i el Secret en blanc.
B — Clau API estàtica (capçalera). Envia la teva clau com a capçalera:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Obtén la teva clau a Flowmingo → Configuració → Integracions → Claus API. Marca Read hiring data i Read candidates — la primera cobreix ofertes, pipeline i resultats; la segona permet a un assistent buscar algú. Afegeix Manage pipeline / Invite candidates per a les accions d'escriptura protegides. Per permetre que un assistent creï projectes i avaluacions i publiqui o promocioni una oferta, marca també Create hiring projects i Create assessments. Llegeix Crea i publica a Què pots fer primer: aquests dos permisos són opcionals, i el creador de la clau ha de ser un Propietari o un Administrador.
Com és una clau completa. Un valor llarg: fl_live_, el nom públic de la clau, un punt, i després un secret llarg. La meitat secreta es mostra una vegada, just després de crear la clau; després la llista de claus API només mostra el principi. Un valor sense punt és només el nom de la clau, i serà rebutjat. Allà on aquesta guia escriu fl_YOUR_KEY, substitueix-ho tot per la teva clau completa, sense cometes ni espais.
Si no connecta. Una clau dolenta o buida retorna Missing credential o The Flowmingo API key was rejected; tots dos poden significar que el valor no ens va arribar complet, així que primer comprova el valor. Una configuració com ${env:FLOWMINGO_API_KEY} només funciona si el programa pot veure aquesta variable, i un editor obert des del dock o el menú d'inici sovint no llegeix el teu perfil de terminal. O bé l'inicia des d'una terminal on la variable estigui definida, o bé posa la teva clau completa al fitxer (i mantén aquest fitxer fora de git).
Quina triar? La majoria de clients suporten ambdues; alguns (per exemple, ChatGPT) són només OAuth — cada pestanya indica què suporta aquell client. En general, OAuth és adequat per a assistents interactius (Claude.ai, ChatGPT, VS Code); la capçalera de clau API s'adequa a CLIs, entorns headless/CI i editors on prefereixes posar una clau.
Què pots fer
Les lectures no necessiten aprovació. La majoria d'escriptures estan protegides. Una invitació, un rebuig fet amb l'acció Rebutja, una eliminació de candidats d'un projecte, una eliminació d'un projecte o, normalment, un moviment a una etapa que està configurada per enviar un correu al candidat, espera que una persona l'aprovi en un enllaç, amb sessió iniciada a Flowmingo. L'assistent no pot aprovar-ho, i un "sí" escrit al xat no compta. La configuració de correu de l'etapa es comprova quan es sol·licita el moviment. Per a una nota, una valoració, una llista curta, una etiqueta o un moviment a una etapa que no està configurada per enviar correu al candidat, es diu a l'assistent que mostri primer una vista prèvia i que continuï només quan tu hi accedeixis, cosa que és una instrucció per a ell, no un bloqueig. Una sol·licitud que el teu client d'IA mostra abans d'executar una eina és pròpia del client i no és l'aprovació de Flowmingo: una invitació, un rebuig fet amb l'acció Rebutja i un moviment a una etapa amb correu encara esperen l'enllaç d'aprovació, sigui el que sigui el que el client hagi preguntat. Un enllaç d'aprovació caduca després de 15 minuts, i una sol·licitud per a diversos candidats o sol·licituds (com a màxim 50) és una aprovació que els llista tots. Un cop un canvi està programat, l'assistent pot comprovar on es troba, retirar-lo si encara espera i desfer un canvi reversible (una nota, una valoració, una marca de llista curta, una etiqueta o un moviment que no hagi enviat correu a ningú) dins de 24 hores. Una desfer no sempre està disponible: el canvi ha de tornar amb una referència de desfer, registrar-ne una és un esforç màxim, i un moviment per a un candidat sense etapa anterior no en té cap, així que l'assistent ha de comprovar-ho i dir-ho quan no hi hagi manera de tornar enrere. Un correu que s'ha enviat no es pot desfer. Les eines llistades sota Crea i publica són l'excepció a tot això, excepte delete_project: actuen immediatament i no estan programades per a aprovació. Una eliminació i una eliminació de projecte no es poden desfer. Tot està limitat a la teva organització.
Lectura
| Capacitat | Què fa |
|---|---|
| Llista d'ofertes de feina | Navega per les ofertes obertes i tancades de la teva organització. |
| Llista de conjunts d'entrevistes i projectes | Veu les teves avaluacions (conjunts d'entrevistes) de tota mena (entrevistes d'IA, jocs de rol, tests d'habilitats, tests tècnics, avaluacions de CV, showcases i gravacions; qüestionaris quan els demanis) i els teus projectes de contractació. |
| Llista el teu pipeline de candidats | Veu les sol·licituds per etapa en un projecte. |
| Llegeix resultats i puntuacions d'avaluació | Extreu resultats de tota mena: entrevistes d'IA, jocs de rol, tests d'habilitats, tests tècnics, avaluacions de CV, showcases, gravacions i qüestionaris. Cada resultat està etiquetat amb el seu tipus. Només alguns tipus porten una puntuació d'IA: un showcase i un qüestionari mai es puntuen, i un test d'habilitats és un percentatge. |
| Cerca un candidat | Obtén el nom, el correu i el CV d'un candidat. |
| Cerca candidats | Troba candidats per nom o correu. |
| Compara candidats | Alinea de 2 a 10 candidats costat a costat. Necessita el permís Read candidates a més de Read hiring data. |
| Visió general de contractació | L'embut per a tot el que la teva connexió pot accedir (tota l'empresa, tret que la clau l'hagi creada algú limitat a alguns projectes), o reduït quan ho demanis: sol·licituds per etapa, actives vs rebutjades, i, per a cada tipus d'avaluació que tingui resultats, resultats completats vs en curs i la puntuació mitjana. Un projecte redueix tots els comptes, però els seus comptes de resultats cobreixen els resultats de les avaluacions vinculades a aquest projecte, així que un candidat d'un altre projecte que comparteix una d'aquestes avaluacions també pot comptar. Una avaluació redueix només els comptes de resultats: els comptes d'etapa i sol·licituds es mantenen a tot el que la teva connexió pot accedir. Els tipus mai se sumen. |
| Principals candidats | Els resultats més ben classificats, ordenats per puntuació global. Tots els tipus d'avaluació es classifiquen junts tret que demanis un sol tipus o una sola avaluació (conjunt d'entrevistes). |
| Detall de resultat d'avaluació | Les puntuacions per competència d'un resultat més el resum d'IA, per als tipus que en tenen. Un test d'habilitats, un test tècnic, un showcase i un qüestionari en tenen poc o cap. |
| Detall d'oferta de feina | El detall complet d'una sola oferta. |
Una oferta és pública? (get_job_post_publication) |
Si qualsevol pot obrir la pàgina pública d'una oferta: activa, encara esperant la revisió de contingut d'IA, rebutjada per aquesta, marcada, desactivada o el seu projecte no està obert. També la seva adreça pública i la seva promoció (desactivada, flowmingo o estesa). Necessita Read hiring data. |
| Properes entrevistes | Invitacions a qualsevol tipus d'avaluació que s'han enviat o estan programades i encara no s'han completat. No és un recompte de tots els pendents: una invitació el candidat de la qual ha estat recordat, o ha obert o fet clic a l'enllaç, es deixa fora fins que el candidat comença, i també una que no s'ha pogut lliurar. |
Escriptura (protegida)
| Capacitat | Què fa |
|---|---|
| Convida candidats a una avaluació | Prepara les invitacions per a una entrevista d'IA, un joc de rol, un test d'habilitats o un test tècnic, i espera que una persona les aprovi en un enllaç. No s'envia res abans. Una avaluació i com a màxim 50 candidats per sol·licitud; un test d'habilitats o un test tècnic necessita un projecte i un correu per a cada candidat, i un de patrocinat pot carregar el moneder de la teva organització quan un candidat el comença. |
| Mou un candidat a una altra etapa | Un moviment a una etapa configurada per enviar correu al candidat normalment espera que una persona l'aprovi en un enllaç (la configuració de correu de l'etapa es llegeix un cop, just abans del moviment, així que una configuració activada en aquell moment pot fer que un moviment enviï correu sense aprovació). Qualsevol altre moviment: es diu a l'assistent que el previsualitzi i esperi el teu sí, i normalment es pot desfer durant 24 hores, quan torna amb una referència de desfer. Com a màxim 50 sol·licituds per petició. |
| Rebutja una sol·licitud | Sol·licita aprovació en un enllaç. Si una persona l'aprova, Flowmingo intenta moure la sol·licitud a l'etapa de Rebutjat del projecte; comprova el resultat després. Com a màxim 50 sol·licituds per petició. |
Elimina candidats d'un projecte (remove_application) |
Necessita Manage pipeline. Sol·licita aprovació en un enllaç. Si una persona l'aprova, Flowmingo elimina les sol·licituds del projecte; el perfil del candidat es manté al teu viver de talent i en altres projectes. No és un rebuig, i no hi ha desfer. Com a màxim 50 sol·licituds per petició. |
| Afegeix una nota a un resultat | Es diu a l'assistent que previsualitzi la nota proposada i esperi el teu sí abans de desar-la. Una nota pertany a un resultat d'avaluació (de qualsevol tipus), no al candidat en general. |
| Valora un resultat | Es diu a l'assistent que previsualitzi la valoració i esperi el teu sí. La valoració s'aplica a un resultat d'avaluació. |
| Afegeix a la llista curta un resultat | Es diu a l'assistent que previsualitzi el canvi de llista curta i esperi el teu sí. S'aplica a un resultat d'avaluació. |
| Etiqueta / afegeix a col·lecció de talent | Es diu a l'assistent que previsualitzi el canvi d'etiqueta o col·lecció de talent i esperi el teu sí. |
| Comprova, retira o desfés un canvi | Comprova on es troba un canvi programat (esperant, realitzat, fallit, expirat o substituït per una sol·licitud més nova), retira un que encara espera aprovació o desfés un canvi reversible dins de 24 hores, quan torna amb una referència de desfer. |
Crea i publica (actua immediatament, excepte eliminar un projecte)
Aquestes eines creen coses i les obren al públic. Es comporten de manera diferent de les escriptures protegides anteriors:
- Actuen immediatament, excepte
delete_project. Res no està programat perquè una persona ho aprovi en un enllaç, i cap d'elles envia correu a un candidat.delete_projectespera que un Propietari o un Administrador l'aprovi en un enllaç. - El creador de la clau ha de ser un Propietari o un Administrador, per a cada eina aquí excepte la cancel·lació, que només necessita Invite candidates. Les eines actuen amb els permisos de la persona que va crear la clau API. Si aquesta persona és un Membre, la crida és rebutjada.
- Dos permisos són opcionals. Create hiring projects i Create assessments no s'atorguen per defecte. Amb l'inici de sessió (opció A), l'assistent els obté només si es compleixen dues condicions: que el client els esmenti pel seu nom quan es connecta, i que la clau API que enganxeu a la pàgina de consentiment els inclogui. Un client que no enviï cap llista de permisos obté els quatre permisos estàndard (Read hiring data, Read candidates, Manage pipeline, Invite candidates) que té la clau, i cap d'aquests dos, de manera que l'assistent no veu les eines que els requereixen. Amb una clau estàtica (opció B), l'assistent veu aquestes eines independentment dels permisos que tingui la clau, i Flowmingo rebutja qualsevol crida que la clau no permeti.
- Algunes crides triguen una estona. La publicació espera la revisió de contingut d'IA, fins a uns 90 segons. Crear un projecte o una avaluació utilitza generació d'IA i pot trigar més (un test tècnic triga de 3 a 9 minuts). Quan la resposta diu que el treball encara està pendent, l'assistent torna a trucar amb la mateixa clau d'idempotència per llegir on ha arribat. Una reintent mai crea un segon projecte o avaluació.
| Capacitat | Què fa |
|---|---|
Crea un projecte de contractació (create_project) |
Necessita Create hiring projects (opcional). Fa un projecte amb les seves quatre etapes per defecte i una oferta de feina escrita per la mateixa IA que el tauler, a partir d'un títol, la posició i una descripció opcional. Per defecte també fa una Avaluació de CV i una Entrevista d'IA; l'assistent pot nomenar altres avaluacions, o cap. L'oferta s'activa i es fa pública un cop la revisió de contingut d'IA l'aprova, normalment en un minut. Limitat a 10 projectes per minut i 300 al dia per a la teva empresa. La clau d'idempotència és opcional: quan s'omet, se'n fa una a partir dels arguments, així que una reintent mai crea un segon projecte. |
Crea una avaluació (create_assessment) |
Necessita Create assessments (opcional). Fa una avaluació amb la IA: una Entrevista d'IA, una Avaluació de CV, un Test d'Habilitats, un Showcase, un Test Tècnic o un Joc de Rol, a partir d'un títol de feina i una descripció, nom, projecte i llengua opcionals (una etiqueta com en o vi-VN; un Test d'Habilitats i un Test Tècnic ignoren la llengua). Adjunta-la a un projecte perquè els candidats puguin ser convidats a un Test d'Habilitats, un Test Tècnic o un Showcase. La clau d'idempotència és opcional, com abans. |
Publica una oferta de feina (publish_job_post) |
Necessita Create hiring projects. Activa l'oferta i assegura que la revisió de contingut d'IA s'ha executat. La resposta diu si la pàgina és activa ara, encara esperant la revisió o rebutjada per aquesta. El projecte de contractació ha d'estar actiu. |
Deixa de publicar una oferta (unpublish_job_post) |
Necessita Create hiring projects. Desactiva l'oferta, de manera que el seu enllaç públic deixa d'obrir-se. Per defecte, la promoció també es desactiva (withdraw_boost és cert). |
Promociona una oferta (boost_job_post) |
Necessita Create hiring projects. Estableix la promoció a off, flowmingo o extended. Promocionar és gratuït. Augmentar-la necessita l'oferta activada, el seu projecte actiu, un logotip d'empresa i una descripció, i la revisió de contingut d'IA; una empresa pot augmentar 50 promocions al dia. |
Obre, esborrany o arxiva un projecte (set_project_state) |
Necessita Create hiring projects. Mou un projecte de contractació entre active, draft i archived. Els esborranys i els arxivats tanquen l'enllaç de la feina. Les dades del candidat es conserven. |
Cancel·la una invitació programada (cancel_scheduled_invite) |
Necessita Invite candidates. Cancel·la una invitació que estava programada per a més tard i encara no s'ha enviat, utilitzant l'ID d'invitació del resultat d'invitació. No s'envia correu a ningú. La persona es manté al teu compte i al tauler del projecte. |
Elimina un projecte de contractació (delete_project) |
Necessita Create hiring projects (opcional). Només demana: no elimina immediatament, sol·licita aprovació en un enllaç, i res no s'elimina fins que un Propietari o un Administrador ho aprova. Només es pot eliminar un projecte actiu. Si una persona ho aprova, Flowmingo elimina el projecte i les seves ofertes; les sol·licituds de candidats no s'eliminen una a una, i els perfils i contactes dels candidats, les teves avaluacions i els enllaços d'invitació es conserven. No hi ha desfer. |
Seguretat i confiança
- Les teves dades estan limitades a l'organització — l'assistent mai pot veure dades d'una altra empresa.
- Amb OAuth, l'assistent mai rep la teva clau API. Rep un token d'accés que caduca després d'una hora, refrescat silenciosament mentre es manté connectat. L'inici de sessió en si dura tant com el seu token de refresc, uns 30 dies per defecte des de la seva emissió o darrer refresc, així que caduca després d'uns 30 dies sense ús, i llavors tornes a iniciar sessió. Amb una capçalera estàtica (opció B), el client del teu assistent manté la teva clau i l'envia amb cada sol·licitud, així que mantén-la fora de fitxers que puguis compartir o enviar a git.
- Tallar la connexió d'un assistent: elimina la clau API amb què el vas autoritzar, a Configuració → Integracions → Claus API. L'accés s'atura immediatament. Encara no hi ha desconnexió per assistent, així que si vols revocar-los un a un, dona a cada assistent la seva pròpia clau.
- Les sol·licituds a l'endpoint
/mcpes comproven per l'Origen: un origen opacnullsempre es rebutja, i la comprovació es pot bloquejar a una llista blanca, però per defecte s'accepta qualsevol origen real, així que la protecció és la teva credencial, no l'origen. Cada sessió està vinculada a la credencial que la va obrir.
Per saber com autenticar-te, consulta Autenticació — dues opcions; per a les lectures exactes, escriptures protegides i accions que es produeixen immediatament, consulta Què pots fer. Quan estiguis a punt, salta a Connecta el teu assistent i tria el teu client.
URL del servidor MCP
Connecteu el vostre assistent
Claude Code (CLI)
Una ordre afegeix Flowmingo sobre Streamable HTTP natiu. Lidera amb OAuth; l'--header estàtic és l'alternativa.
Passos: 1) afegeix el servidor, 2) inicia sessió (navegador → enganxa la clau), 3) claude mcp list per verificar.
# 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
Avís: les banderes han d'anar abans del nom, i sempre utilitza --transport http (mai sse). Substitueix fl_YOUR_KEY amb la teva clau completa (vegeu Què és una clau completa a la secció d'Autenticació anterior).
Verifica que funciona — pregunta: "llista les meves ofertes de feina obertes."
Cursor
La capçalera estàtica és el camí més senzill. Cursor també pot utilitzar OAuth (admet el registre dinàmic de clients) — per això, elimina el bloc headers.
Passos: 1) afegeix el servidor a ~/.cursor/mcp.json (a continuació), 2) defineix FLOWMINGO_API_KEY amb la teva clau completa al teu perfil de shell, 3) surt de Cursor i inicia'l des d'un terminal on la variable estigui definida, 4) a Configuració → MCP, desactiva i activa el servidor per recarregar-lo.
Cursor ha de poder veure la variable. Cursor llegeix ${env:FLOWMINGO_API_KEY} del seu propi entorn. Si l'inicies des del dock o el menú d'inici, sovint no veu una variable definida al teu perfil de terminal, i llavors la capçalera arriba buida o sense expandir i el servidor respon Missing credential. Si iniciar Cursor des d'un terminal no és pràctic, substitueix ${env:FLOWMINGO_API_KEY} al fitxer amb la teva clau completa (i mantén ~/.cursor/mcp.json fora de git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth en lloc seu — elimina el bloc headers; Cursor executa el registre dinàmic de clients i obre una pàgina de consentiment al navegador en la primera connexió:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Verifica que funciona — pregunta: "llista les meves feines obertes."
VS Code (Copilot, mode agent)
Les eines només apareixen a Copilot Chat → Mode Agent. La clau arrel és servers (no mcpServers) i el tipus és http. El camí de clau de prompt a continuació és la configuració fiable.
Passos: 1) creeu .vscode/mcp.json (o executeu MCP: Afegeix servidor → HTTP), 2) quan inicieu el servidor, VS Code us demana la vostra clau (no s'escriu al fitxer), 3) utilitzeu-la en Mode Agent.
{
"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 també pot intentar OAuth, però la configuració OAuth documentada espera un ID de client; utilitzeu el camí de clau de prompt anterior per a una configuració fiable.
Verifiqueu que funciona — pregunteu: "llista les meves feines obertes."
Claude — claude.ai i Claude Desktop
Ambdós utilitzen la mateixa interfície d'usuari de Connectors i el mateix flux d'enganxar l'URL. Només OAuth (no hi ha camp de capçalera a la interfície d'usuari).
Passos (web o escriptori):
- Obriu Configuració → Connectors i feu clic a Afegir connector personalitzat.
- Doneu-li el nom
Flowmingoi enganxeu l'URL del servidor MCP. Deixeu Avançat → ID de client OAuth / Secret en blanc. - Feu clic a Afegir → Connectar. A la pàgina de consentiment de Flowmingo, enganxeu la vostra clau API
fl_i autoritzeu. - Verifiqueu — pregunteu a Claude: "llista les meves feines obertes."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Equip / Empresa: un Propietari l'afegeix una vegada a Configuració de l'Organització → Connectors → Personalitzat; els membres fan clic a Connectar.
Necessiteu una clau estàtica a Claude Desktop en comptes d'això? Utilitzeu la pestanya Qualsevol client (mcp-remote).
El teu navegador obre una pàgina de consentiment de Flowmingo a la primera connexió: enganxa la teva clau API i autoritza. Per desconnectar més tard, elimina aquesta clau API a Configuració → Integracions → Claus API.
ChatGPT i OpenAI Codex CLI
Tots dos són d'OpenAI. ChatGPT utilitza el Mode de Desenvolupador per a connectors personalitzats (només OAuth); Codex es connecta nativament des de la CLI.
ChatGPT (web)
- A chatgpt.com (Plus / Pro / Business / Enterprise / Edu — no mòbil), obre Configuració → Aplicacions → Avançat i activa el Mode de desenvolupador.
- Aplicacions → Crea → anomena
Flowmingo, enganxa l'URL a sota, transport Streamable HTTP, autenticació OAuth. - Obre l'esborrany, activa les eines i prem Refresca.
- Adjunta-ho mitjançant el menú + en un xat.
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)
El Mode de Desenvolupador de ChatGPT es connecta només amb OAuth — no accepta una capçalera estàtica x-api-key / clau API personalitzada. Els connectors simples i de recerca profunda utilitzen només search + fetch (en tens tots dos). Les eines d'escriptura (convida / mou / rebutja) requereixen el Mode de Desenvolupador. Una indicació que ChatGPT mostra abans d'executar una eina és pròpia de ChatGPT i no és l'aprovació de Flowmingo: una invitació, un rebuig i un moviment a una etapa que envia un correu al candidat sempre esperen que una persona els aprovi en un enllaç de Flowmingo.
OpenAI Codex CLI
No cal cap pont — Codex parla Streamable HTTP de manera nativa.
# ~/.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
Verifica que funciona — pregunta: "llista les meves ofertes obertes."
Gemini CLI i Code Assist
La Gemini CLI (i el mode agent Gemini Code Assist) arriben a un servidor MCP remot mitjançant ~/.gemini/settings.json. L'aplicació Gemini de consumidor no pot afegir connectors MCP personalitzats — aquest camí és només per a CLI / Code Assist.
Passos: 1) afegiu el servidor sota mcpServers a ~/.gemini/settings.json, 2) exporteu FLOWMINGO_API_KEY=fl_..., 3) executeu gemini i /mcp per confirmar que les eines estan llistades.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl selecciona HTTP Streamable natiu. El marcador de posició ${FLOWMINGO_API_KEY} s'expandeix des del vostre entorn, de manera que cap clau crua s'escriu al fitxer. Preferiu OAuth? Gemini CLI pot fer-ho de manera nativa — ometeu el bloc headers i afegiu "authProviderType": "dynamic_discovery" a l'entrada del servidor. La CLI detecta el repte 401, descobreix les nostres metadades OAuth i realitza el registre dinàmic de clients per si sola (cap ID de client per establir).
Verifiqueu que funciona — a
gemini, pregunteu: "llista les meves feines obertes."
Altres clients — Windsurf · Zed · Cline · Continue · Antigravity
Cada client següent funciona amb el mateix servidor; la majoria admeten tant OAuth com una capçalera estàtica. Els fragments utilitzen una clau estàtica mitjançant una variable d'entorn; elimina les headers perquè un client executi OAuth on ho admeti. Vigila les trampes de noms de clau específics de cada client que s'indiquen a continuació.
Google Antigravity
Afegeix https://mcp.flowmingo.ai/mcp com a servidor MCP remot i tria autenticar-lo: s'obre una pàgina de Flowmingo i et demana la clau API completa (consulta Què sembla una clau completa a la secció d'Autenticació anterior). Cada superfície d'Antigravity (l'IDE, la CLI) inicia sessió per separat. A mcp_config.json d'Antigravity, l'adreça va sota serverUrl, i una clau estàtica va en un bloc headers com a Authorization amb Bearer i la teva clau completa, com als exemples MCP d'Antigravity de Google. No hem pogut provar totes les versions d'Antigravity, així que si els teus menús difereixen d'això, la guia de Google té els passos actuals.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf accepta serverUrl o url, i admet OAuth (omet headers per activar-lo).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — la clau és context_servers; omet headers per a OAuth natiu. Configura FLOWMINGO_API_KEY=fl_... al teu entorn en lloc d'enganxar una clau crua.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Servers → Configure — estableix type: "streamableHttp" (camelCase), o el valor per defecte és SSE mort.
{ "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 — connecta't mitjançant el pont mcp-remote. Configura 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 }}"]
Verifica que funciona — pregunta: "llista les meves ofertes actives."
Qualsevol client (mcp-remote)
Per a qualsevol client només stdio (o un client futur sense transport remot natiu), connecteu-vos a Flowmingo amb la comanda stdio mcp-remote. --transport http-only és obligatori — el servidor no té SSE.
Passos: 1) assegureu-vos que Node ≥ 18, 2) executeu el pont com a comanda stdio al vostre client, 3) en el primer OAuth s'obre el navegador — enganxeu la vostra clau.
# 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" }
}
}
}
Rescat: si l'autenticació es bloqueja, executeu rm -rf ~/.mcp-auth i torneu-ho a provar. Substituïu fl_YOUR_KEY amb la vostra clau completa (vegeu Què sembla una clau completa a la secció d'Autenticació anterior). En un args[] JSON, eviteu un espai després dels dos punts de la capçalera (peculiaritat d'escapament de npx).
Verifiqueu que funcioni — pregunteu: "llista les meves ofertes de feina obertes."