Visión xeral
Conecta calquera asistente de IA compatible con MCP aos teus datos de contratación de Flowmingo — le as túas ofertas de emprego e candidatos e realiza accións protexidas (invitar, mover, rexeitar, eliminar dun proxecto), de forma segura, co teu permiso. Con dous permisos extra que activas ti mesmo, un asistente tamén pode crear proxectos de contratación e avaliacións, e publicar, pechar ou impulsar unha oferta de emprego (consulta O que podes facer). Novo en MCP? É o estándar aberto que permite que os asistentes de IA falen con ferramentas como Flowmingo. Aprende o que é MCP.
Transporte: Streamable HTTP (o transporte remoto moderno). Non hai SSE legado — apunta sempre o teu cliente a /mcp, nunca a /sse.
Trata a túa chave de API como un contrasinal. Prefire OAuth, unha entrada solicitada ou unha variable de contorno sobre pegar unha chave
fl_...en bruto nun ficheiro que poidas commit a git (por exemplo,.vscode/mcp.json,~/.cursor/mcp.json, a túa configuración de Continue).
Autenticación — dúas opcións
A — Inicia sesión con Flowmingo (OAuth, recomendado). O teu navegador abre unha páxina de consentimento de Flowmingo; pegas a túa chave de API alí. O asistente nunca recibe a túa chave en bruto. Recibe un token de acceso e un token de actualización, que pode usar para obter un novo token de acceso. O inicio de sesión non dura para sempre. O token de actualización vive uns 30 días por defecto, contados desde a súa emisión, no inicio de sesión ou na última actualización, polo que un inicio de sesión que non se use durante ese tempo caduca, e unha versión de Flowmingo que cambie como se almacenan os inicios de sesión pode requirir que volvas iniciar sesión. Entón o asistente pídete que inicies sesión de novo e pegas a túa chave outra vez. Para cortalo antes, elimina esa chave de API. Non hai ID de cliente nin segredo que crear (Flowmingo usa Dynamic Client Registration). En clientes que mostran opcións de OAuth "Avanzadas" (por exemplo, Claude.ai), deixa o Client ID e o Secret en branco.
B — Chave de API estática (cabeceira). Envía a túa chave como calquera das dúas cabeceiras:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Obtén a túa chave en Flowmingo → Configuración → Integracións → Chaves de API. Marca Read hiring data e Read candidates — a primeira cobre ofertas de emprego, pipeline e resultados, a segunda é a que permite que un asistente busque a alguén. Engade Manage pipeline / Invite candidates para as accións de escritura protexidas. Para permitir que un asistente cree proxectos e avaliacións e publique ou impulse unha oferta de emprego, marca tamén Create hiring projects e Create assessments. Le Crear e publicar baixo O que podes facer primeiro: estes dous permisos son opcionais, e o creador da chave debe ser un Propietario ou un Administrador.
Como é unha chave completa. Un valor longo: fl_live_, o nome público da chave, un punto, e despois un segredo longo. A metade secreta móstrase unha vez, xusto despois de crear a chave; despois a lista de Chaves de API mostra só o comezo. Un valor sen punto é só o nome da chave e será rexeitado. Onde este guía escriba fl_YOUR_KEY, substitúe todo por túa chave completa, sen comiñas nin espazos.
Se non conecta. Unha chave mala ou baleira devólvese como Missing credential ou The Flowmingo API key was rejected; ambos poden significar que o valor nunca chegou completo, así que comproba o valor primeiro. Unha configuración como ${env:FLOWMINGO_API_KEY} só funciona se o programa pode ver esa variable, e un editor aberto desde o dock ou o menú Inicio moitas veces non le o teu perfil de terminal. Ou iníciao desde un terminal onde a variable estea definida, ou pon a túa chave completa no ficheiro (e mantén ese ficheiro fóra de git).
Cal elixir? A maioría dos clientes soportan ambas; algúns (por exemplo, ChatGPT) son só OAuth — cada lapela indica o que soporta ese cliente. En xeral, OAuth é axeitado para asistentes interactivos (Claude.ai, ChatGPT, VS Code); a cabeceira de chave de API é axeitada para CLIs, headless/CI e editores onde prefires poñer unha chave.
O que podes facer
As lecturas non requiren aprobación. A maioría das escrituras están protexidas. Unha invitación, un rexeitamento feito coa acción Rexeitar, unha eliminación de candidatos dun proxecto, unha eliminación dun proxecto ou, normalmente, un movemento a unha fase que estea configurada para enviar correo ao candidato, espera a que unha persoa o aprobe nunha ligazón, coa sesión iniciada en Flowmingo. O asistente non pode aprobalo, e un si escrito no chat non conta. A configuración de correo da fase compróbase cando se solicita o movemento. Para unha nota, unha valoración, unha lista curta, unha etiqueta ou un movemento a unha fase que non está configurada para enviar correo ao candidato, o asistente ten instrucións de mostrarche unha vista previa primeiro e de proceder só cando aceptes, o que é unha instrución para el, non un bloqueo. Unha mensaxe que o teu cliente de IA mostra antes de executar unha ferramenta é propia do cliente e non é aprobación de Flowmingo: unha invitación, un rexeitamento feito coa acción Rexeitar e un movemento a unha fase con envío de correo seguen esperando a ligazón de aprobación, independentemente do que pida o cliente. Unha ligazón de aprobación caduca despois de 15 minutos, e unha solicitude para varios candidatos ou solicitudes (como máximo 50) é unha aprobación que lista a todos. Unha vez que un cambio está en espera, o asistente pode comprobar como vai, retirarlo mentres aínda espera e desfacer un cambio reversible (unha nota, unha valoración, unha marca de lista curta, unha etiqueta ou un movemento que non enviou correo a ninguén) dentro de 24 horas. Un desfacer non está sempre dispoñible: o cambio ten que volver cunha referencia de desfacer, rexistrar unha é o mellor esforzo, e un movemento para un candidato sen fase anterior non ten ningunha, así que o asistente debería comprobar e dicilo cando non haxa volta atrás. Un correo que se enviou non se pode desfacer. As ferramentas listadas baixo Crear e publicar son a excepción a todo isto, excepto delete_project: actúan de inmediato e non están en espera de aprobación. Unha eliminación e unha eliminación de proxecto non se poden desfacer. Todo está limitado á túa organización.
Lectura
| Capacidade | Que fai |
|---|---|
| Listar ofertas de emprego | Navega polos roles abertos e pechados da túa organización. |
| Listar conxuntos de entrevistas e proxectos | Ve as túas avaliacións (conxuntos de entrevistas) de todo tipo (entrevistas AI, role-plays, Skill Tests, Technical Tests, avaliacións de CV, Showcases e gravacións; cuestionarios cando os pidas) e os teus proxectos de contratación. |
| Listar o teu pipeline de candidatos | Ver solicitudes por fase nun proxecto. |
| Ler resultados de avaliacións e puntuacións | Saca resultados de todo tipo: entrevistas AI, role-plays, Skill Tests, Technical Tests, avaliacións de CV, Showcases, gravacións e cuestionarios. Cada resultado está etiquetado co seu tipo. Só algúns tipos levan unha puntuación AI: un Showcase e un cuestionario nunca se puntúan, e un Skill Test é unha porcentaxe. |
| Buscar un candidato | Obter o nome, correo e CV dun candidato. |
| Buscar candidatos | Atopar candidatos por nome ou correo. |
| Comparar candidatos | Aliñar de 2 a 10 candidatos lado a lado. Necesita o permiso Read candidates ademais de Read hiring data. |
| Visión xeral de contratación | O funil para todo o que a túa conexión pode alcanzar (toda a empresa, a menos que a chave fose creada por alguén limitado a algúns proxectos), ou estreitado cando pidas: solicitudes por fase, activos vs rexeitados e, para cada tipo de avaliación que teña resultados, resultados completados vs en curso e a puntuación media. Un proxecto estreita todas as contas, pero as súas contas de resultados cobren os resultados nas avaliacións vinculadas a ese proxecto, polo que un candidato doutro proxecto que comparta unha desas avaliacións tamén se pode contar. Unha avaliación estreita só as contas de resultados: as contas de fase e solicitudes quedan en todo o que a túa conexión pode alcanzar. Os tipos nunca se suman. |
| Principais candidatos | Os resultados máis altos, ordenados por puntuación xeral. Cada tipo de avaliación clasifícase xunto a menos que pidas un tipo ou unha avaliación (conxunto de entrevistas). |
| Detalle de resultado de avaliación | As puntuacións por competencia dun resultado máis o resumo AI, para os tipos que os teñen. Un Skill Test, un Technical Test, un Showcase e un cuestionario teñen pouco ou ningún. |
| Detalle de oferta de emprego | O detalle completo dunha oferta de emprego individual. |
Unha oferta de emprego está aberta ao público? (get_job_post_publication) |
Se calquera pode abrir a páxina pública dunha oferta de emprego: activa, aínda agardando a comprobación de contido AI, rexeitada por ela, marcada, apagada, ou o seu proxecto non está aberto. Tamén o seu enderezo público e o seu impulso (desactivado, flowmingo ou estendido). Necesita Read hiring data. |
| Próximas entrevistas | Invitacións a calquera tipo de avaliación que foron enviadas ou están programadas e aínda non se completaron. Non é unha conta de todos os pendentes: unha invitación cuxo candidato foi lembrado, ou abriu ou fixo clic na ligazón, déixase fóra ata que o candidato comece, e tamén unha que fallou na entrega. |
Escritura (protexida)
| Capacidade | Que fai |
|---|---|
| Invitar candidatos a unha avaliación | Prepara as invitacións para unha entrevista AI, un role-play, un Skill Test ou un Technical Test, e espera a que unha persoa as aprobe nunha ligazón. Nada se envía antes. Unha avaliación e como máximo 50 candidatos por solicitude; un Skill Test ou un Technical Test necesita un proxecto e un correo para cada candidato, e un patrocinado pode debitar da carteira da túa organización cando un candidato o comeza. |
| Mover un candidato a outra fase | Un movemento a unha fase que está configurada para enviar correo ao candidato normalmente espera a que unha persoa o aprobe nunha ligazón (a configuración de correo da fase lese unha vez, xusto antes do movemento, polo que unha configuración activada nese momento pode aínda deixar que un movemento envíe correo sen aprobación). Calquera outro movemento: o asistente ten instrucións de mostralo en vista previa e esperar o teu si, e normalmente pódese desfacer durante 24 horas, cando volveu cunha referencia de desfacer. Como máximo 50 solicitudes por solicitude. |
| Rexeitar unha solicitude | Solicita aprobación nunha ligazón. Se unha persoa a aproba, Flowmingo tenta mover a solicitude á fase de Rexeitado do proxecto; comproba o resultado despois. Como máximo 50 solicitudes por solicitude. |
Eliminar candidatos dun proxecto (remove_application) |
Necesita Manage pipeline. Solicita aprobación nunha ligazón. Se unha persoa a aproba, Flowmingo elimina as solicitudes do proxecto; o perfil do candidato queda no teu grupo de talento e noutros proxectos. Non é un rexeitamento e non hai desfacer. Como máximo 50 solicitudes por solicitude. |
| Engadir unha nota a un resultado | O asistente ten instrucións de mostrar a nota proposta en vista previa e esperar o teu si antes de gardala. Unha nota pertence a un resultado de avaliación (de calquera tipo), non ao candidato como conxunto. |
| Valorar un resultado | O asistente ten instrucións de mostrar a valoración en vista previa e esperar o teu si. A valoración aplícase a un resultado de avaliación. |
| Engadir a lista curta un resultado | O asistente ten instrucións de mostrar o cambio de lista curta en vista previa e esperar o teu si. Aplícase a un resultado de avaliación. |
| Etiquetar / engadir a colección de talento | O asistente ten instrucións de mostrar a etiqueta ou o cambio de colección de talento en vista previa e esperar o teu si. |
| Comprobar, retirar ou desfacer un cambio | Comprobar onde está un cambio en espera (agardando, executado, fallado, expirado ou substituído por unha solicitude máis nova), retirar un que aínda agarda aprobación, ou desfacer un cambio reversible dentro de 24 horas, cando volveu cunha referencia de desfacer. |
Crear e publicar (actúa de inmediato, excepto eliminar un proxecto)
Estas ferramentas crean cousas e ábrenas ao público. Compórtanse de xeito diferente ás escrituras protexidas anteriores:
- Actúan de inmediato, excepto
delete_project. Nada está en espera para que unha persoa o aprobe nunha ligazón, e ningunha delas envía correo a un candidato.delete_projectespera a que un Propietario ou un Administrador o aprobe nunha ligazón. - O creador da chave debe ser un Propietario ou un Administrador, para cada ferramenta aquí excepto a cancelación, que só necesita Invite candidates. As ferramentas actúan cos permisos da persoa que creou a chave de API. Se esa persoa é un Membro, a chamada é rexeitada.
- Dous permisos son optativos. Create hiring projects e Create assessments non se conceden por defecto. Co inicio de sesión (opción A), o asistente só os recibe se se cumpren ambas as dúas condicións: o cliente os lista polo seu nome ao conectarse e a clave API que pegas na páxina de consentimento os inclúe. Un cliente que non envía unha lista de permisos recibe os catro permisos estándar (Read hiring data, Read candidates, Manage pipeline, Invite candidates) que ten a clave, e ningún destes dous, polo que o asistente non ve as ferramentas que os requiren. Cunha clave estática (opción B), o asistente ve estas ferramentas independentemente dos permisos que teña a clave, e Flowmingo rexeita calquera chamada que a clave non permita.
- Algunhas chamadas tardan un pouco. Publicar espera a comprobación de contido AI, ata uns 90 segundos. Crear un proxecto ou unha avaliación usa xeración AI e pode tardar máis (un Technical Test leva de 3 a 9 minutos). Cando a resposta di que o traballo aínda está pendente, o asistente chama de novo coa mesma chave de idempotencia para ler onde chegou. Un reintento nunca crea un segundo proxecto ou avaliación.
| Capacidade | Que fai |
|---|---|
Crear un proxecto de contratación (create_project) |
Necesita Create hiring projects (opcional). Fai un proxecto cos seus catro fases predeterminadas e unha oferta de emprego escrita pola mesma IA que o panel, a partir dun título, a posición e unha descrición opcional. Por defecto tamén fai unha avaliación de CV e unha entrevista AI; o asistente pode nomear outras avaliacións, ou ningunha. A oferta de emprego actívase e faise pública unha vez que a comprobación de contido AI a aprobe, normalmente nun minuto. Limitado a 10 proxectos por minuto e 300 ao día para a túa empresa. A chave de idempotencia é opcional: cando se omite, fai unha a partir dos argumentos, polo que un reintento nunca crea un segundo proxecto. |
Crear unha avaliación (create_assessment) |
Necesita Create assessments (opcional). Fai unha avaliación coa IA: unha entrevista AI, unha avaliación de CV, un Skill Test, un Showcase, un Technical Test ou un Role-play, a partir dun título de traballo e unha descrición opcional, nome, proxecto e idioma (unha etiqueta como en ou vi-VN; un Skill Test e un Technical Test ignoran o idioma). Anexa a un proxecto para que os candidatos poidan ser invitados a un Skill Test, un Technical Test ou un Showcase. A chave de idempotencia é opcional, como arriba. |
Publicar unha oferta de emprego (publish_job_post) |
Necesita Create hiring projects. Activa a oferta de emprego e asegúrate de que a comprobación de contido AI se executou. A resposta di se a páxina está activa agora, aínda agardando a comprobación, ou rexeitada por ela. O proxecto de contratación debe estar activo. |
Despublicar unha oferta de emprego (unpublish_job_post) |
Necesita Create hiring projects. Desactiva a oferta de emprego, para que a súa ligazón pública deixe de abrir. Por defecto o impulso tamén se desactiva (withdraw_boost é verdadeiro). |
Impulsar unha oferta de emprego (boost_job_post) |
Necesita Create hiring projects. Establece o impulso a off, flowmingo ou extended. Impulsar é gratuíto. Aumentalo necesita a oferta activa, o seu proxecto activo, un logo e descrición da empresa, e a comprobación de contido AI; unha empresa pode aumentar 50 impulsos ao día. |
Abrir, borrador ou arquivar un proxecto (set_project_state) |
Necesita Create hiring projects. Move un proxecto de contratación entre active, draft e archived. Os borradores e os arquivados pechan a ligazón do posto. Os datos dos candidatos consérvanse. |
Cancelar unha invitación programada (cancel_scheduled_invite) |
Necesita Invite candidates. Cancela unha invitación que foi programada para máis tarde e aínda non se enviou, usando o ID de invitación do resultado de invitación. Ninguén recibe correo. A persoa queda na túa conta e no taboleiro do proxecto. |
Eliminar un proxecto de contratación (delete_project) |
Necesita Create hiring projects (opcional). Só pide: non elimina de inmediato, solicita aprobación nunha ligazón, e nada se elimina ata que un Propietario ou un Administrador o aprobe. Só un proxecto activo pode eliminarse. Se unha persoa o aproba, Flowmingo elimina o proxecto e as súas ofertas de emprego; as súas solicitudes de candidatos non se eliminan unha a unha, e os perfís e contactos de candidatos, as túas avaliacións e ligazóns de invitación consérvanse. Non hai desfacer. |
Seguridade e confianza
- Os teus datos están limitados á organización — o asistente nunca pode ver datos doutra empresa.
- Con OAuth, o asistente nunca recibe a túa chave de API. Obtén un token de acceso que caduca despois dunha hora, refrescado silenciosamente mentres permanece conectado. O inicio de sesión en si dura tanto como o seu token de actualización, uns 30 días por defecto desde a súa emisión ou última actualización, polo que caduca despois duns 30 días sen uso, e entón inicias sesión de novo. Cunha cabeceira estática (opción B) o cliente do teu asistente garda a túa chave e envíaa con cada solicitude, así que mantéñaa fóra de ficheiros que poidas compartir ou commit.
- Cortar a un asistente: elimina a chave de API coa que o autorizaches, en Configuración → Integracións → Chaves de API. O acceso detense inmediatamente. Non hai desconexión por asistente aínda, así que se queres revogalos un a un, dálle a cada asistente a súa propia chave.
- As solicitudes ao endpoint
/mcpson comprobadas pola súa orixe: unha orixe opacanullsempre é rexeitada, e a comprobación pode bloquearse a unha lista de permitidos, pero por defecto toda orixe real é aceptada, así que a protección é a túa credencial, non a orixe. Cada sesión está vinculada á credencial que a abriu.
Para saber como autenticarte, consulta Autenticación — dúas opcións; para as lecturas exactas, escrituras protexidas e accións que ocorren de inmediato, consulta O que podes facer. Cando esteas listo, salta a Conecta o teu asistente e escolle o teu cliente.
URL do servidor MCP
Conecta o teu asistente
Claude Code (CLI)
Un só comando engade Flowmingo sobre Streamable HTTP nativo. Lidera con OAuth; o --header estático é a alternativa.
Pasos: 1) engade o servidor, 2) inicia sesión (navegador → pega a clave), 3) claude mcp list para 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
Atención: as opcións deben ir antes do nome, e usa sempre --transport http (nunca sse). Substitúe fl_YOUR_KEY pola túa clave completa (consulta Que aspecto ten unha clave completa na sección Autenticación anterior).
Verifica que funciona — pregunta: "lista os meus empregos abertos."
Cursor
A cabeceira estática é o camiño máis sinxelo. Cursor tamén pode usar OAuth (admite o rexistro dinámico de clientes) — para iso, elimina o bloque headers.
Pasos: 1) engade o servidor a ~/.cursor/mcp.json (debaixo), 2) establece FLOWMINGO_API_KEY coa túa clave completa no teu perfil do shell, 3) sae de Cursor e arrinca desde un terminal onde a variable estea definida, 4) en Configuración → MCP, activa e desactiva o servidor para recargalo.
Cursor debe poder ver a variable. Cursor le ${env:FLOWMINGO_API_KEY} do seu propio entorno. Se se arrinca desde o dock ou desde o menú Inicio, moitas veces non ve unha variable definida no teu perfil de terminal, e entón a cabeceira chega baleira ou sen expandir e o servidor responde Missing credential. Se arrincar Cursor desde un terminal non é práctico, substitúe ${env:FLOWMINGO_API_KEY} no ficheiro coa túa clave completa (e mantén ~/.cursor/mcp.json fóra de git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
Alternativa con OAuth — elimina o bloque headers; Cursor executa o rexistro dinámico de clientes e abre unha páxina de consentimento no navegador na primeira conexión:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Verifica que funciona — pregunta: "lista as miñas ofertas de traballo abertas."
As ferramentas aparecen só en Copilot Chat → Modo Axente. A clave raíz é servers (non mcpServers) e o tipo é http. O camiño de clave solicitada abaixo é a configuración fiable.
Pasos: 1) crea .vscode/mcp.json (ou executa MCP: Engadir Servidor → HTTP), 2) cando inicies o servidor, VS Code solicitará a túa clave (non se escribe no ficheiro), 3) úsaa en Modo Axente.
{
"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 tamén pode tentar OAuth, pero a configuración OAuth documentada espera un ID de cliente; usa o camiño de clave solicitada arriba para unha configuración fiable.
Verifícao — pregunta: "lista os meus empregos abertos."
Ambos usan a mesma interface de Conectores e o mesmo fluxo de pegar a URL. Só OAuth (non hai campo de cabecera na interface).
Pasos (web ou escritorio):
- Abre Configuración → Conectores e fai clic en Engadir conector personalizado.
- Nomea como
Flowmingoe pega o URL do servidor MCP de arriba. Deixa Avanzado → ID/Segredo do Cliente OAuth en branco. - Fai clic en Engadir → Conectar. Na páxina de consentimento de Flowmingo, pega a túa clave API
fl_e autoriza. - Verifica — pregúntalle a Claude: "lista os meus empregos abertos."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Equipo / Empresa: Un propietario engádeo unha vez en Configuración da Organización → Conectores → Personalizado; os membros despois fan clic en Conectar.
Necesitas unha clave estática en Claude Desktop en vez diso? Usa a pestana Calquera cliente (mcp-remote).
O teu navegador abrirá unha páxina de consentimento de Flowmingo na primeira conexión: pega a túa clave API e autoriza. Para desconectar máis tarde, elimina esa clave API en Configuración → Integracións → Claves API.
ChatGPT e OpenAI Codex CLI
Ambos son de OpenAI. ChatGPT usa o Modo Desenvolvedor para conectores personalizados (só OAuth); Codex conéctase nativamente desde a CLI.
ChatGPT (web)
- En chatgpt.com (Plus / Pro / Business / Enterprise / Edu — non móbil), abre Configuración → Aplicacións → Avanzado e activa o Modo desenvolvedor.
- Aplicacións → Crear → ponlle o nome
Flowmingo, pega o URL de abaixo, transporte Streamable HTTP, autenticación OAuth. - Abre o borrador, activa as ferramentas e Actualiza.
- Engádeo a través do menú + nun chat.
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)
O Modo Desenvolvedor de ChatGPT conéctase só con OAuth — non acepta unha cabeceira estática x-api-key / clave de API personalizada. Os conectores simples e de investigación profunda usan só search + fetch (ti tes ambos). As ferramentas de escritura (invitar / mover / rexeitar) requiren o Modo Desenvolvedor. Un aviso que ChatGPT mostra antes de executar unha ferramenta é propio de ChatGPT e non é a aprobación de Flowmingo: unha invitación, un rexeitamento e unha mudanza a unha fase que envía un correo ao candidato sempre agardan a que unha persoa os aprobe nunha ligazón de Flowmingo.
OpenAI Codex CLI
Non precisa ponte — Codex fala Streamable HTTP nativamente.
# ~/.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
Comproba que funciona — pregunta: "lista os meus traballos abertos."
A Gemini CLI (e o modo axente de Gemini Code Assist) chegan a un servidor MCP remoto a través de ~/.gemini/settings.json. A aplicación Gemini de consumidor non pode engadir conectores MCP personalizados — este camiño é só para CLI / Code Assist.
Pasos: 1) engade o servidor baixo mcpServers en ~/.gemini/settings.json, 2) exporta FLOWMINGO_API_KEY=fl_..., 3) executa gemini e /mcp para confirmar que as ferramentas están listadas.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl selecciona HTTP Transmisible nativo. O marcador ${FLOWMINGO_API_KEY} expándese dende o teu contorno, polo que non se escribe ningunha clave en texto plano no ficheiro. Prefires OAuth? Gemini CLI pode facelo de forma nativa — omite o bloque headers e engade "authProviderType": "dynamic_discovery" á entrada do servidor. A CLI detecta o desafío 401, descobre os nosos metadatos OAuth e realiza o rexistro dinámico de clientes por si soa (non hai ID de cliente que configurar).
Verifícao — en
gemini, pregunta: "lista os meus empregos abertos."
Outros clientes — Windsurf · Zed · Cline · Continue · Antigravity
Cada cliente de abaixo funciona contra o mesmo servidor — a maioría soporta tanto OAuth como un cabeceiro estático. Os fragmentos usan unha chave estática mediante unha variable de ambiente; elimina os headers para que un cliente execute OAuth onde o soporte. Vixía as trampas de nomes de chave específicas de cada cliente que se indican a continuación.
Google Antigravity
Engade https://mcp.flowmingo.ai/mcp como servidor MCP remoto e escolle autenticalo: ábrese unha páxina de Flowmingo que pide a túa chave API completa (consulta Que aspecto ten unha chave completa na sección de Autenticación anterior). Cada superficie de Antigravity (o IDE, o CLI) inicia sesión por separado. No mcp_config.json de Antigravity, o enderezo vai baixo serverUrl, e unha chave estática vai nun bloque headers como Authorization con Bearer e a túa chave completa, como nos exemplos de MCP de Antigravity de Google. Non puidemos probar todas as versións de Antigravity, así que se os teus menús difiren disto, a guía de Google ten os pasos actuais.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf acepta serverUrl ou url, e soporta OAuth (omite headers para activalo).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — a chave é context_servers; omite headers para OAuth nativo. Establece FLOWMINGO_API_KEY=fl_... no teu ambiente en lugar de pegar unha chave en bruto.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
Servidores MCP → Configurar — establece type: "streamableHttp" (camelCase), ou se non por defecto usa SSE morto.
{ "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 — conéctate mediante a ponte mcp-remote. Establece 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: "lista as miñas ofertas de emprego abertas."
Calquera cliente (mcp-remote)
Para calquera cliente só stdio (ou un futuro cliente sen transporte remoto nativo), conecta con Flowmingo mediante o comando stdio mcp-remote. Requírese --transport http-only — o servidor non ten SSE.
Pasos: 1) asegúrate de ter Node ≥ 18, 2) executa a ponte como un comando stdio no teu cliente, 3) na primeira execución OAuth, o navegador ábrese — pega a túa clave.
# 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" }
}
}
}
Rescate: se a autenticación se traba, executa rm -rf ~/.mcp-auth e téntao de novo. Substitúe fl_YOUR_KEY pola túa clave completa (ver Que aspecto ten unha clave completa na sección Autenticación anterior). Nun args[] JSON, evita un espazo despois dos dous puntos da cabeceira (peculiaridade do escape de npx).
Verifica que funciona — pregunta: "lista os meus traballos abertos."