Cómo configurar el servidor MCP de Get on Board con Codex

Cuando buscas candidatos desde Codex como recruiter o equipo de empresa, el servidor MCP de Get on Board conecta Codex con Talent Database para que puedas buscar profesionales tech de Latinoamérica desde tu sesión de Codex.

También puedes entregarle esta página completa a tu agente y pedirle que instale el servidor por ti. El agente puede seguir los pasos de configuración, agregar el servidor MCP y luego devolverte el paso de autorización en el navegador cuando Get on Board abra el flujo OAuth.

Usa primero la configuración por CLI. Codex guarda la configuración MCP en un archivo compartido, así que el servidor que agregas desde la terminal también queda disponible en la app de Codex.

Antes de comenzar

Necesitas:

• Tener Codex instalado y con sesión iniciada.
• Una cuenta de recruiter en Get on Board con acceso a una empresa aceptada.
• La URL del servidor MCP remoto: https://www.getonbrd.com/mcp.

Agrega el servidor desde la CLI de Codex

Abre una terminal y ejecuta:

codex mcp add getonbrd --url https://www.getonbrd.com/mcp
codex mcp login getonbrd

El primer comando crea un servidor MCP Streamable HTTP llamado getonbrd. El segundo comando abre el flujo de autorización OAuth en tu navegador.

Cuando se abra el navegador:

1. Inicia sesión en Get on Board con tu cuenta de recruiter.
2. Selecciona el contexto de empresa que Codex debe usar.
3. Aprueba el acceso MCP solicitado.

Después de autorizar, reinicia la app de Codex o abre una nueva sesión de Codex para que los tools queden cargados.

Verifica la conexión

En Codex, pide:

Usa el servidor MCP de Get on Board para llamar a whoami y confirmar mi empresa activa.

Codex debería devolver tu identidad de Get on Board, el contexto de empresa activo y los tools MCP disponibles.

Luego prueba una búsqueda en Talent Database, por ejemplo:

Usa Get on Board para encontrar ingenieros senior de Python en México, con inglés C1 y disponibilidad pronta.

Opcional: editar config.toml directamente

Si prefieres editar la configuración de Codex por tu cuenta, agrega solo la URL del servidor:

[mcp_servers.getonbrd]
url = "https://www.getonbrd.com/mcp"

Luego ejecuta:

codex mcp login getonbrd

No agregues API key, client ID, client secret ni un campo de transport personalizado. Codex y Get on Board completan Dynamic Client Registration y OAuth automáticamente en el navegador.

Qué puede hacer Codex con este servidor

Consulta el resumen del servidor MCP de Get on Board para la referencia completa de tools y ejemplos de uso.

Si necesitas reconectar

Usa el mismo nombre de servidor que elegiste al agregarlo. Si usaste getonbrd, puedes reconectar con:

codex mcp logout getonbrd
codex mcp remove getonbrd
codex mcp add getonbrd --url https://www.getonbrd.com/mcp
codex mcp login getonbrd

Si Codex no muestra los tools de Get on Board inmediatamente después del login, inicia una nueva sesión de Codex o reinicia la app de Codex.

Solución de problemas

¿Por qué desaparecieron los tools de Get on Board?

Los access tokens MCP de Get on Board duran 2 horas, y el servidor todavía no emite refresh token. Cuando tu token expira, Codex pierde acceso a los tools de Get on Board hasta que vuelvas a iniciar sesión. Sigue “Si necesitas reconectar” más arriba — es esperable que pase periódicamente en una sesión larga, no es un error. Si volver a autorizar no trae los tools de vuelta, espera unos minutos antes de reintentar — varios intentos seguidos pueden llegar a nuestros límites de tasa.

Llama primero a whoami

Cuando no estés seguro de que la conexión funciona, pídele a Codex que llame a whoami antes que nada. Confirma tu identidad de Get on Board, la empresa activa, los scopes autorizados y los tools disponibles, y es el que necesita menos permisos para funcionar. Si whoami es el único tool que Codex lista, tu autorización actual solo otorgó el permiso base “Confirmar tu identidad en Get on Board” — revisa el permiso de Talent Database más abajo.

Usa la URL exacta del servidor

Ingresa https://www.getonbrd.com/mcp exactamente, igual que en “Antes de comenzar” más arriba. Un error de tipeo en el dominio o en la ruta manda a tu cliente a un servidor que no es el nuestro, y la conexión falla antes de que empiece el flujo OAuth.

La búsqueda de candidatos necesita el permiso de Talent Database

El tool de búsqueda en Talent Database aparece solo cuando tu autorización otorgó el permiso “Buscar profesionales en Talent Database”. La pantalla de autorización lista los permisos que pidió tu cliente — ahí no puedes agregar ninguno. Entonces, si whoami no lista ese permiso, elimina la conexión con Get on Board en Codex y vuelve a agregarla, para que se registre desde cero y pida el permiso.

Artículos relacionados

• ¿Qué es el servidor MCP de Get on Board?
• ¿Cómo puedo usar Get on Board para reclutamiento agéntico?
• Cómo configurar el servidor MCP de Get on Board con Claude Code
• ¿Qué es Talent Database?
• ¿Puedo acceder directamente a los datos de contacto en Talent Database?
• ¿Qué puedo hacer con la API de Get on Board?