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