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

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

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 y ejecutar el comando de CLI, mientras tú completas la autorización en el navegador cuando Get on Board abra el flujo OAuth.

Esta guía cubre solo la ruta soportada para Claude Code.

Antes de comenzar

Necesitas:

• Tener Claude Code instalado y con sesión iniciada en tu máquina.
• 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 en Claude Code

Abre una terminal en cualquier proyecto y ejecuta:

claude mcp add --transport http getonbrd https://www.getonbrd.com/mcp

Claude Code guarda el servidor localmente, pero OAuth todavía no ocurre.

Confirma que el servidor quedó agregado

Ejecuta:

claude mcp list

Deberías ver getonbrd en la lista. Si el CLI muestra Failed to connect en este punto, es normal. Claude Code está comprobando el servidor antes de que lo autorices.

Reinicia Claude Code

Abre una nueva sesión de Claude Code después de agregar el servidor. El cliente MCP solo carga servidores nuevos al iniciar la sesión.

Autoriza Get on Board

En la primera llamada real a un tool de Get on Board después del reinicio, Claude Code abre el flujo de autorización OAuth en tu navegador. Luego:

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

Después de autorizar, los tools de Get on Board quedan disponibles en Claude Code.

Verifica la conexión

En Claude Code, pide:

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

Claude Code 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.

Qué puede hacer Claude Code 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

Ejecuta:

claude mcp remove getonbrd
claude mcp add --transport http getonbrd https://www.getonbrd.com/mcp

Luego abre una nueva sesión de Claude Code y vuelve a autorizar Get on Board en el primer uso.

Si Claude Code no muestra los tools de Get on Board inmediatamente después de autorizar, inicia otra sesión nueva de Claude Code.

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, Claude Code pierde acceso a los tools de Get on Board hasta que vuelvas a autorizar. 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 Claude Code 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 Claude Code 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 Claude Code 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 Codex
• Cómo configurar el servidor MCP de Get on Board con ChatGPT
• ¿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?