Servidor Loxo MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para interactuar con la API de la plataforma de reclutamiento Loxo. Este servidor permite a los asistentes de IA realizar diversas tareas relacionadas con el reclutamiento, como la gestión de candidatos, empleos, actividades y colas de llamadas.

Instalación

# Clone the repository git clone [repository-url] cd loxo-mcp-server # Install dependencies npm install # Build the project npm run build

Related MCP server: LinkedIn Model Context Protocol (MCP) Server

Configuración

Copie el archivo .env.example proporcionado a .env y complete sus valores:

cp .env.example .env

Luego actualice el archivo .env con su configuración:

LOXO_API_KEY=your_api_key LOXO_DOMAIN=app.loxo.co LOXO_AGENCY_SLUG=your_agency_slug

Variables de entorno requeridas:

LOXO_API_KEY : Su clave API de Loxo
LOXO_AGENCY_SLUG : La babosa de tu agencia en Loxo
LOXO_DOMAIN : (opcional) El valor predeterminado es 'app.loxo.co'

Herramientas disponibles

Gestión de actividades

get-activity-types : recupera la lista de tipos de actividad disponibles
spark-search-activity-types : Obtener tipos de actividad de Spark Search
get-todays-tasks : Obtenga todas las tareas y actividades programadas para hoy
schedule-activity : programar una actividad futura (llamada, reunión, etc.)
log-activity : Registrar una actividad para un candidato o trabajo

Gestión de colas de llamadas

get-call-queue : Ver la cola de llamadas actual
add-to-call-queue : agrega un candidato o contacto a la cola de llamadas

Gestión de candidatos

search-candidates : Busca candidatos en Loxo
get-candidate : Obtenga información detallada sobre un candidato específico
add-note : Agregar una nota a un candidato

Gestión de trabajos

search-jobs : Busca empleo en Loxo
get-job : Obtenga información detallada sobre un trabajo específico
add-note : Agregar una nota a un trabajo

Desarrollo

# Run in development mode with watch mode npm run dev # Build the project npm run build # Start the server npm start

Seguridad de tipos

El servidor utiliza Zod para la validación del tipo de tiempo de ejecución de:

Variables de entorno
Parámetros de entrada de la herramienta
Respuestas de API

Manejo de errores

El servidor incluye un manejo integral de errores para:

Validación del entorno
Errores en las solicitudes de API
Parámetros de herramienta no válidos
Solicitudes de herramientas desconocidas

Arquitectura

Construido con el SDK del Protocolo de Contexto de Modelo
Se comunica a través de stdio para una integración perfecta con los asistentes de IA.
Utiliza TypeScript para seguridad de tipos y una mejor experiencia del desarrollador
Implementa llamadas API RESTful a la plataforma de Loxo