Resumen
Conecta cualquier asistente de IA compatible con MCP a tus datos de contratación de Flowmingo: lee tus puestos y candidatos y realiza acciones protegidas (invitar, mover, rechazar, eliminar de un proyecto) de forma segura y con tu permiso. Con dos permisos adicionales que activas tú mismo, un asistente también puede crear proyectos de contratación y evaluaciones, y publicar, cerrar o impulsar una oferta de empleo (consulta Qué puedes hacer). ¿Nuevo en MCP? Es el estándar abierto que permite a los asistentes de IA hablar con herramientas como Flowmingo. Aprende qué es MCP.
Transporte: Streamable HTTP (el transporte remoto moderno). No hay SSE heredado: apunta siempre tu cliente a /mcp, nunca a /sse.
Trata tu clave de API como una contraseña. Prefiere OAuth, una entrada solicitada o una variable de entorno antes que pegar una clave
fl_...en un archivo que puedas enviar a git (por ejemplo,.vscode/mcp.json,~/.cursor/mcp.json, tu configuración de Continue).
Autenticación: dos opciones
A — Inicia sesión con Flowmingo (OAuth, recomendado). Tu navegador abre una página de consentimiento de Flowmingo; pegas tu clave de API allí. El asistente nunca recibe tu clave. Recibe un token de acceso y un token de actualización, que puede usar para obtener un nuevo token de acceso. El inicio de sesión no dura para siempre. El token de actualización dura unos 30 días por defecto, contados desde que se emitió, al iniciar sesión o en la última renovación, por lo que un inicio de sesión que no se use durante ese tiempo caduca, y una versión de Flowmingo que cambie cómo se almacenan los inicios de sesión puede requerir que vuelvas a iniciar sesión. Entonces el asistente te pedirá que inicies sesión de nuevo y volverás a pegar tu clave. Para cortarlo antes, elimina esa clave de API. No hay ID de cliente ni secreto que crear (Flowmingo usa Dynamic Client Registration). En clientes que muestran ajustes OAuth "Avanzados" (por ejemplo, Claude.ai), deja el ID de cliente y el secreto en blanco.
B — Clave de API estática (cabecera). Envía tu clave como cualquiera de estas cabeceras:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Obtén tu clave en Flowmingo → Ajustes → Integraciones → Claves de API. Marca Read hiring data y Read candidates — la primera cubre puestos, pipeline y resultados; la segunda permite que un asistente busque a alguien. Añade Manage pipeline / Invite candidates para las acciones de escritura protegidas. Para permitir que un asistente cree proyectos y evaluaciones y publique o impulse una oferta, también marca Create hiring projects y Create assessments. Lee primero Crear y publicar en Qué puedes hacer: estos dos permisos son opcionales y el creador de la clave debe ser un Propietario o un Administrador.
Cómo es una clave completa. Un valor largo: fl_live_, el nombre público de la clave, un punto, y luego un secreto largo. La mitad secreta se muestra una vez, justo después de crear la clave; más tarde la lista de Claves de API solo muestra el principio. Un valor sin punto es solo el nombre de la clave y será rechazado. Donde esta guía escriba fl_YOUR_KEY, reemplázalo todo por tu clave completa, sin comillas ni espacios.
Si no conecta. Una clave incorrecta o vacía devuelve Missing credential o The Flowmingo API key was rejected; ambos pueden significar que el valor nunca llegó completo, así que verifica el valor primero. Un ajuste como ${env:FLOWMINGO_API_KEY} solo funciona si el programa puede ver esa variable, y un editor abierto desde el dock o el menú Inicio a menudo no lee tu perfil de terminal. O bien inícialo desde una terminal donde la variable esté definida, o pon tu clave completa en el archivo (y mantén ese archivo fuera de git).
¿Cuál elegir? La mayoría de los clientes admiten ambas; algunos (por ejemplo, ChatGPT) son solo OAuth — cada pestaña indica qué admite ese cliente. En general, OAuth es adecuado para asistentes interactivos (Claude.ai, ChatGPT, VS Code); la cabecera de clave de API es adecuada para CLI, headless/CI y editores donde prefieres insertar una clave.
Qué puedes hacer
Las lecturas no necesitan aprobación. La mayoría de las escrituras están protegidas. Una invitación, un rechazo hecho con la acción Rechazar, una eliminación de candidatos de un proyecto, una eliminación de proyecto o, normalmente, un movimiento a una etapa que esté configurada para enviar un correo al candidato, espera a que una persona lo apruebe en un enlace, con sesión iniciada en Flowmingo. El asistente no puede aprobarlo, y un "sí" escrito en el chat no cuenta. El ajuste de correo de la etapa se comprueba cuando se solicita el movimiento. Para una nota, una calificación, una lista corta, una etiqueta o un movimiento a una etapa que no esté configurada para enviar un correo, se le indica al asistente que te muestre una vista previa primero y que proceda solo cuando estés de acuerdo, lo cual es una instrucción para él, no un bloqueo. Un aviso que tu cliente de IA muestra antes de ejecutar una herramienta es propio del cliente y no es la aprobación de Flowmingo: una invitación, un rechazo hecho con la acción Rechazar y un movimiento a una etapa que envía correos aún esperan el enlace de aprobación, sin importar lo que pida el cliente. Un enlace de aprobación caduca después de 15 minutos, y una solicitud para varios candidatos o solicitudes (como máximo 50) es una aprobación que los lista a todos. Una vez que un cambio está en espera, el asistente puede comprobar su estado, retirarlo mientras aún espera y deshacer un cambio reversible (una nota, una calificación, una marca de lista corta, una etiqueta o un movimiento que no haya enviado un correo a nadie) dentro de las 24 horas. Deshacer no siempre está disponible: el cambio debe devolver una referencia de deshacer, registrarla es un esfuerzo máximo, y un movimiento para un candidato sin etapa anterior no la tiene, por lo que el asistente debe comprobarlo y decirlo cuando no haya vuelta atrás. Un correo que se ha enviado no se puede deshacer. Las herramientas listadas bajo Crear y publicar son la excepción a todo esto, excepto delete_project: actúan de inmediato y no se ponen en espera para aprobación. Una eliminación y un borrado de proyecto no se pueden deshacer. Todo está limitado a tu organización.
Lectura
| Capacidad | Qué hace |
|---|---|
| Listar ofertas de empleo | Explora los puestos abiertos y cerrados de tu organización. |
| Listar conjuntos de entrevistas y proyectos | Ve tus evaluaciones (conjuntos de entrevistas) de todo tipo (entrevistas de IA, role-plays, pruebas de habilidades, pruebas técnicas, evaluaciones de CV, showcases y grabaciones; cuestionarios cuando los pidas) y tus proyectos de contratación. |
| Listar tu pipeline de candidatos | Ve las solicitudes por etapa en un proyecto. |
| Leer resultados y puntuaciones de evaluaciones | Obtén resultados de todo tipo: entrevistas de IA, role-plays, pruebas de habilidades, pruebas técnicas, evaluaciones de CV, showcases, grabaciones y cuestionarios. Cada resultado está etiquetado con su tipo. Solo algunos tipos llevan una puntuación de IA: un showcase y un cuestionario nunca se puntúan, y una prueba de habilidades es un porcentaje. |
| Buscar un candidato | Obtén el nombre, correo electrónico y CV de un candidato. |
| Buscar candidatos | Encuentra candidatos por nombre o correo electrónico. |
| Comparar candidatos | Coloca de 2 a 10 candidatos lado a lado. Necesita el permiso Read candidates además de Read hiring data. |
| Visión general de contratación | El embudo para todo lo que tu conexión puede alcanzar (toda la empresa, a menos que la clave la haya creado alguien limitado a algunos proyectos), o reducido cuando lo pidas: solicitudes por etapa, activas vs. rechazadas, y, para cada tipo de evaluación con resultados, completados vs. en progreso y la puntuación media. Un proyecto reduce todos los recuentos, pero sus recuentos de resultados cubren los resultados de las evaluaciones vinculadas a ese proyecto, por lo que un candidato de otro proyecto que comparta una de esas evaluaciones también puede contarse. Una evaluación reduce solo los recuentos de resultados: los recuentos de etapas y solicitudes permanecen en todo lo que tu conexión puede alcanzar. Los tipos nunca se suman entre sí. |
| Mejores candidatos | Los resultados mejor clasificados, ordenados por puntuación general. Todos los tipos de evaluación se clasifican juntos a menos que pidas un tipo o una evaluación (conjunto de entrevistas). |
| Detalle de resultado de evaluación | Las puntuaciones por competencia de un resultado más el resumen de IA, para los tipos que los tienen. Una prueba de habilidades, una prueba técnica, un showcase y un cuestionario tienen poco o nada. |
| Detalle de oferta de empleo | El detalle completo de una sola oferta de empleo. |
¿Está una oferta abierta al público? (get_job_post_publication) |
Si alguien puede abrir la página pública de una oferta: en vivo, aún esperando la revisión de contenido de IA, rechazada por ella, marcada, desactivada, o su proyecto no está abierto. También su dirección pública y su impulso (off, flowmingo o extendido). Necesita Read hiring data. |
| Próximas entrevistas | Invitaciones a cualquier tipo de evaluación que se enviaron o están programadas y aún no se han completado. No es un recuento de todos los pendientes: una invitación cuyo candidato ha sido recordado, o ha abierto o hecho clic en el enlace, se omite hasta que el candidato comienza, y también la que no se pudo entregar. |
Escritura (protegida)
| Capacidad | Qué hace |
|---|---|
| Invitar candidatos a una evaluación | Prepara las invitaciones para una entrevista de IA, un role-play, una prueba de habilidades o una prueba técnica, y espera a que una persona las apruebe en un enlace. No se envía nada antes de eso. Una evaluación y como máximo 50 candidatos por solicitud; una prueba de habilidades o una prueba técnica necesita un proyecto y un correo para cada candidato, y una patrocinada puede cargar a la billetera de tu organización cuando un candidato la comienza. |
| Mover un candidato a otra etapa | Un movimiento a una etapa que esté configurada para enviar un correo al candidato normalmente espera a que una persona lo apruebe en un enlace (el ajuste de correo de la etapa se lee una vez, justo antes del movimiento, por lo que un ajuste activado en ese momento aún puede permitir que un movimiento envíe un correo sin aprobación). Cualquier otro movimiento: se le indica al asistente que lo vea y espere tu "sí", y generalmente se puede deshacer durante 24 horas, cuando devuelva una referencia de deshacer. Como máximo 50 solicitudes por solicitud. |
| Rechazar una solicitud | Solicita aprobación en un enlace. Si una persona lo aprueba, Flowmingo intenta mover la solicitud a la etapa Rechazado del proyecto; comprueba el resultado después. Como máximo 50 solicitudes por solicitud. |
Eliminar candidatos de un proyecto (remove_application) |
Necesita Manage pipeline. Solicita aprobación en un enlace. Si una persona lo aprueba, Flowmingo elimina las solicitudes del proyecto; el perfil del candidato permanece en tu pool de talento y en otros proyectos. No es un rechazo y no hay deshacer. Como máximo 50 solicitudes por solicitud. |
| Añadir una nota a un resultado | Se le indica al asistente que vea la nota propuesta y espere tu "sí" antes de guardarla. Una nota pertenece a un resultado de evaluación (de cualquier tipo), no al candidato en general. |
| Puntuar un resultado | Se le indica al asistente que vea la puntuación y espere tu "sí". La puntuación se aplica a un resultado de evaluación. |
| Poner en lista corta un resultado | Se le indica al asistente que vea el cambio de lista corta y espere tu "sí". Se aplica a un resultado de evaluación. |
| Etiquetar / añadir a colección de talento | Se le indica al asistente que vea el cambio de etiqueta o colección de talento y espere tu "sí". |
| Comprobar, retirar o deshacer un cambio | Comprueba dónde está un cambio en espera (esperando, realizado, fallido, caducado o reemplazado por una solicitud más reciente), retira uno que aún espera aprobación o deshaz un cambio reversible dentro de las 24 horas, cuando devuelva una referencia de deshacer. |
Crear y publicar (actúa de inmediato, excepto eliminar un proyecto)
Estas herramientas crean cosas y las abren al público. Se comportan de manera diferente a las escrituras protegidas anteriores:
- Actúan de inmediato, excepto
delete_project. Nada se pone en espera para que una persona lo apruebe en un enlace, y ninguna envía un correo a un candidato.delete_projectespera a que un Propietario o un Administrador lo apruebe en un enlace. - El creador de la clave debe ser un Propietario o un Administrador, para cada herramienta aquí excepto la cancelación, que solo necesita Invite candidates. Las herramientas actúan con los permisos de la persona que creó la clave de API. Si esa persona es un Miembro, la llamada se rechaza.
- Dos permisos son opcionales. Create hiring projects y Create assessments no se otorgan por defecto. Con el inicio de sesión (opción A), el asistente los obtiene solo si se cumplen ambas condiciones: el cliente los enumera por su nombre al conectarse, y la clave API que pegas en la página de consentimiento los incluye. Un cliente que no envía una lista de permisos obtiene los cuatro permisos estándar (Read hiring data, Read candidates, Manage pipeline, Invite candidates) que tiene la clave, y ninguno de estos dos, por lo que el asistente no ve las herramientas que los necesitan. Con una clave estática (opción B), el asistente ve estas herramientas independientemente de los permisos que tenga la clave, y Flowmingo rechaza cualquier llamada que la clave no permita.
- Algunas llamadas tardan un tiempo. Publicar espera la revisión de contenido de IA, hasta unos 90 segundos. Crear un proyecto o una evaluación usa generación de IA y puede tardar más (una prueba técnica tarda de 3 a 9 minutos). Cuando la respuesta dice que el trabajo aún está pendiente, el asistente vuelve a llamar con la misma clave de idempotencia para leer dónde ha llegado. Un reintento nunca crea un segundo proyecto o evaluación.
| Capacidad | Qué hace |
|---|---|
Crear un proyecto de contratación (create_project) |
Necesita Create hiring projects (opcional). Crea un proyecto con sus cuatro etapas por defecto y una oferta de empleo escrita por la misma IA que el panel, a partir de un título, el puesto y una descripción opcional. Por defecto también crea una Evaluación de CV y una Entrevista de IA; el asistente puede nombrar otras evaluaciones, o ninguna. La oferta se activa y se vuelve pública una vez que la revisión de contenido de IA la aprueba, normalmente en un minuto. Limitado a 10 proyectos por minuto y 300 al día para tu empresa. La clave de idempotencia es opcional: cuando se omite, se crea una a partir de los argumentos, por lo que un reintento nunca crea un segundo proyecto. |
Crear una evaluación (create_assessment) |
Necesita Create assessments (opcional). Crea una evaluación con la IA: una Entrevista de IA, una Evaluación de CV, una Prueba de Habilidades, un Showcase, una Prueba Técnica o un Role-play, a partir de un título de puesto y una descripción de puesto opcional, nombre, proyecto e idioma (una etiqueta como en o vi-VN; una Prueba de Habilidades y una Prueba Técnica ignoran el idioma). Adjúntala a un proyecto para que los candidatos puedan ser invitados a una Prueba de Habilidades, una Prueba Técnica o un Showcase. La clave de idempotencia es opcional, como antes. |
Publicar una oferta de empleo (publish_job_post) |
Necesita Create hiring projects. Activa la oferta y asegura que la revisión de contenido de IA se haya ejecutado. La respuesta indica si la página está en vivo ahora, aún esperando la revisión, o rechazada por ella. El proyecto de contratación debe estar activo. |
Despublicar una oferta de empleo (unpublish_job_post) |
Necesita Create hiring projects. Desactiva la oferta, por lo que su enlace público deja de abrir. Por defecto, el impulso también se desactiva (withdraw_boost es true). |
Impulsar una oferta de empleo (boost_job_post) |
Necesita Create hiring projects. Establece el impulso en off, flowmingo o extended. Impulsar es gratis. Aumentarlo requiere que la oferta esté activada, su proyecto activo, un logotipo y descripción de empresa, y la revisión de contenido de IA; una empresa puede aumentar 50 impulsos al día. |
Abrir, borrador o archivar un proyecto (set_project_state) |
Necesita Create hiring projects. Mueve un proyecto de contratación entre active, draft y archived. Los borradores y archivados cierran el enlace de la oferta. Los datos de los candidatos se conservan. |
Cancelar una invitación programada (cancel_scheduled_invite) |
Necesita Invite candidates. Cancela una invitación que estaba programada para más tarde y aún no se ha enviado, usando el id de invitación del resultado de invitación. No se envía un correo a nadie. La persona permanece en tu cuenta y en el tablero del proyecto. |
Eliminar un proyecto de contratación (delete_project) |
Necesita Create hiring projects (opcional). Solo solicita: no elimina de inmediato, solicita aprobación en un enlace, y nada se elimina hasta que un Propietario o un Administrador lo apruebe. Solo se puede eliminar un proyecto activo. Si una persona lo aprueba, Flowmingo elimina el proyecto y sus ofertas de empleo; sus solicitudes de candidatos no se eliminan una por una, y los perfiles y contactos de candidatos, tus evaluaciones y enlaces de invitación se conservan. No hay deshacer. |
Seguridad y confianza
- Tus datos están limitados a la organización: el asistente nunca puede ver datos de otra empresa.
- Con OAuth, el asistente nunca recibe tu clave de API. Obtiene un token de acceso que caduca después de una hora, renovado silenciosamente mientras esté conectado. El inicio de sesión en sí dura tanto como su token de actualización, unos 30 días por defecto desde que se emitió o se actualizó por última vez, por lo que caduca después de unos 30 días sin uso, y entonces vuelves a iniciar sesión. Con una cabecera estática (opción B), el cliente de tu asistente tiene tu clave y la envía con cada solicitud, así que mantenla fuera de archivos que puedas compartir o enviar a git.
- Cortar la conexión de un asistente: elimina la clave de API con la que lo autorizaste, en Ajustes → Integraciones → Claves de API. El acceso se detiene de inmediato. Aún no hay desconexión por asistente, así que si quieres revocarlos uno a uno, da a cada asistente su propia clave.
- Las solicitudes al endpoint
/mcpse verifican por su Origen: un origennullopaco siempre se rechaza, y la verificación se puede bloquear a una lista de permitidos, pero por defecto se acepta cualquier origen real, así que la protección es tu credencial, no el origen. Cada sesión está vinculada a la credencial que la abrió.
Para saber cómo autenticarte, consulta Autenticación: dos opciones; para las lecturas exactas, escrituras protegidas y acciones que ocurren a la vez, consulta Qué puedes hacer. Cuando estés listo, salta a Conecta tu asistente y elige tu cliente.
URL del servidor MCP
Conecta tu asistente
Claude Code (CLI)
Un solo comando añade Flowmingo sobre Streamable HTTP nativo. Lidera con OAuth; el --header estático es la alternativa.
Pasos: 1) añade el servidor, 2) inicia sesión (navegador → pega la 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: las banderas deben ir antes del nombre, y usa siempre --transport http (nunca sse). Reemplaza fl_YOUR_KEY con tu clave completa (consulta Cómo es una clave completa en la sección de Autenticación anterior).
Verifica que funciona — pregunta: "lista mis trabajos abiertos."
Cursor
La cabecera estática es la ruta más sencilla. Cursor también puede usar OAuth (admite Registro Dinámico de Clientes); para ello, elimina el bloque headers.
Pasos: 1) añade el servidor a ~/.cursor/mcp.json (abajo), 2) establece FLOWMINGO_API_KEY con tu clave completa en el perfil de tu shell, 3) cierra Cursor y ábrelo desde una terminal donde la variable esté definida, 4) en Configuración → MCP, desactiva y reactiva el servidor para recargarlo.
Cursor debe poder ver la variable. Cursor lee ${env:FLOWMINGO_API_KEY} desde su propio entorno. Si se inicia desde el dock o el menú Inicio, a menudo no ve la variable definida en el perfil de la terminal, y entonces la cabecera llega vacía o sin expandir y el servidor responde Missing credential. Si iniciar Cursor desde una terminal no es práctico, sustituye ${env:FLOWMINGO_API_KEY} en el archivo por tu clave completa (y mantén ~/.cursor/mcp.json fuera de git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
Alternativa con OAuth — elimina el bloque headers; Cursor ejecuta el Registro Dinámico de Clientes y abre una página de consentimiento en el navegador al conectar por primera vez:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Verifica que funciona — pregunta: "lista mis ofertas de empleo abiertas."
VS Code (Copilot, modo agente)
Las herramientas aparecen solo en Copilot Chat → Modo Agente. La clave raíz es servers (no mcpServers) y el tipo es http. La ruta de clave solicitada a continuación es la configuración fiable.
Pasos: 1) crea .vscode/mcp.json (o ejecuta MCP: Añadir Servidor → HTTP), 2) cuando inicies el servidor, VS Code te pedirá tu clave (no se escribirá en el archivo), 3) úsala en Modo Agente.
{
"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 también puede intentar OAuth, pero la configuración OAuth documentada espera un ID de cliente; usa la ruta de clave solicitada arriba para una configuración fiable.
Verifica que funciona — pregunta: "lista mis trabajos abiertos."
Claude — claude.ai y Claude Desktop
Ambos utilizan la misma interfaz de Conectores y el mismo flujo de pegar la URL. Solo OAuth (no hay campo de encabezado en la interfaz).
Pasos (web o escritorio):
- Abre Configuración → Conectores y haz clic en Añadir conector personalizado.
- Nómbralo
Flowmingoy pega la URL del servidor MCP de arriba. Deja en blanco Avanzado → ID de cliente OAuth / Secreto. - Haz clic en Añadir → Conectar. En la página de consentimiento de Flowmingo, pega tu clave API
fl_y autoriza. - Verifica — pregunta a Claude: "lista mis trabajos abiertos."
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 lo añade una vez en Configuración de la organización → Conectores → Personalizado; los miembros luego hacen clic en Conectar.
¿Necesitas una clave estática en Claude Desktop en su lugar? Usa la pestaña Cualquier cliente (mcp-remote).
Tu navegador abrirá una página de consentimiento de Flowmingo en la primera conexión: pega tu clave API y autoriza. Para desconectar más tarde, elimina esa clave API en Ajustes → Integraciones → Claves API.
ChatGPT y OpenAI Codex CLI
Ambos son OpenAI. ChatGPT usa el modo de desarrollador para conectores personalizados (solo OAuth); Codex se conecta de forma nativa desde la CLI.
ChatGPT (web)
- En chatgpt.com (Plus / Pro / Business / Enterprise / Edu — no móvil), abre Configuración → Apps → Avanzado y activa Modo desarrollador.
- Apps → Crear → nombra
Flowmingo, pega la URL a continuación, transporte Streamable HTTP, autenticación OAuth. - Abre el borrador, activa las herramientas y pulsa Actualizar.
- Adjúntalo mediante el menú + en un 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)
El modo desarrollador de ChatGPT se conecta solo con OAuth — no acepta una x-api-key estática ni una cabecera de clave de API personalizada. Los conectores simples y de investigación profunda usan solo search y fetch (tienes ambos). Las herramientas de escritura (invitar / mover / rechazar) requieren el modo desarrollador. Una instrucción que ChatGPT muestra antes de ejecutar una herramienta es propia de ChatGPT y no es la aprobación de Flowmingo: una invitación, un rechazo y un movimiento a una fase que envíe un correo al candidato siempre esperan a que una persona lo apruebe en un enlace de Flowmingo.
OpenAI Codex CLI
No se necesita puente — Codex habla Streamable HTTP de forma 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: "lista mis ofertas de trabajo abiertas."
Gemini CLI y Asistencia de Código
La Gemini CLI (y el modo de agente Gemini Code Assist) acceden a un servidor MCP remoto a través de ~/.gemini/settings.json. La aplicación Gemini de consumidor no puede añadir conectores MCP personalizados — esta ruta es solo para CLI / Code Assist.
Pasos: 1) añade el servidor bajo mcpServers en ~/.gemini/settings.json, 2) exporta FLOWMINGO_API_KEY=fl_..., 3) ejecuta gemini y /mcp para confirmar que las herramientas están listadas.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl selecciona HTTP Transmitible nativo. El marcador ${FLOWMINGO_API_KEY} se expande desde tu entorno, por lo que no se escribe ninguna clave original en el archivo. ¿Prefieres OAuth? Gemini CLI puede hacerlo de forma nativa — omite el bloque headers y añade "authProviderType": "dynamic_discovery" a la entrada del servidor. La CLI detecta el desafío 401, descubre nuestros metadatos OAuth y realiza el registro dinámico de clientes por sí sola (no hay ID de cliente que configurar).
Verifica que funciona — en
gemini, pregunta: "lista mis trabajos abiertos."
Otros clientes — Windsurf · Zed · Cline · Continue · Antigravity
Cada cliente que aparece a continuación funciona con el mismo servidor; la mayoría admite tanto OAuth como una cabecera estática. Los fragmentos usan una clave estática mediante una variable de entorno; elimina las headers para que el cliente ejecute OAuth cuando lo admita. Presta atención a las trampas de nombres de clave específicas de cada cliente que se indican a continuación.
Google Antigravity
Añade https://mcp.flowmingo.ai/mcp como servidor MCP remoto y elige autenticarlo: se abre una página de Flowmingo que solicita tu clave API completa (consulta Qué aspecto tiene una clave completa en la sección Autenticación más arriba). Cada superficie de Antigravity (el IDE, la CLI) inicia sesión por separado. En el mcp_config.json de Antigravity, la dirección va en serverUrl, y una clave estática va en un bloque headers como Authorization con Bearer y tu clave completa, como en los ejemplos de MCP de Antigravity de Google. No hemos podido probar todas las versiones de Antigravity, así que si tus menús difieren, la guía de Google tiene los pasos actuales.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf acepta serverUrl o url, y admite OAuth (omite headers para activarlo).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — la clave es context_servers; omite headers para OAuth nativo. Establece FLOWMINGO_API_KEY=fl_... en tu entorno en lugar de pegar una clave 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" (en camelCase), o se utilizará por defecto SSE no funcional.
{ "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 el puente 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 mis ofertas de empleo activas."
Cualquier cliente (mcp-remote)
Para cualquier cliente solo stdio (o un futuro cliente sin transporte remoto nativo), conéctate a Flowmingo con el comando stdio mcp-remote. Se requiere --transport http-only — el servidor no tiene SSE.
Pasos: 1) asegúrate de tener Node ≥ 18, 2) ejecuta el puente como comando stdio en tu cliente, 3) en la primera ejecución de OAuth, el navegador se abrirá — pega tu 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: si la autenticación se atasca, ejecuta rm -rf ~/.mcp-auth y vuelve a intentarlo. Reemplaza fl_YOUR_KEY con tu clave completa (consulta Qué aspecto tiene una clave completa en la sección de Autenticación más arriba). En un args[] JSON, evita un espacio después de los dos puntos del encabezado (peculiaridad de escape de npx).
Verifica que funciona — pregunta: "lista mis ofertas de empleo abiertas."