Evaluar MCP Server

Servidor MCP (Model Context Protocol) para autenticarse en Evaluar y lanzar procesos eTalent desde tu IDE.

Instalación

1. Clonar y compilar

git clone <repository-url>
cd evaluar-mcp
npm install
npm run build

2. Configurar en tu MCP Host

Obtén la ruta absoluta del proyecto:

# En Windows
cd
# Resultado ejemplo: C:\Users\tu-usuario\proyectos\evaluar-mcp

# En Mac/Linux  
pwd
# Resultado ejemplo: /Users/tu-usuario/proyectos/evaluar-mcp

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "evaluar": {
      "command": "node",
      "args": ["C:\\Users\\tu-usuario\\proyectos\\evaluar-mcp\\dist\\index.js"],
      "env": {
        "EVALUAR_AUTH_URL": "https://auth.evaluar.com/auth/realms/evcore/protocol/openid-connect/token",
        "EVALUAR_API_URL": "https://apis.evaluar.com",
        "EVALUAR_GRAPHQL_URL": "https://apis.evaluar.com/v2/graphql",
        "EVALUAR_CLIENT_ID": "evcap"
      }
    }
  }
}

Cursor

Edita .cursor/mcp.json:

{
  "mcpServers": {
    "evaluar": {
      "command": "node",
      "args": ["C:\\Users\\tu-usuario\\proyectos\\evaluar-mcp\\dist\\index.js"],
      "env": {
        "EVALUAR_AUTH_URL": "https://auth.evaluar.com/auth/realms/evcore/protocol/openid-connect/token",
        "EVALUAR_API_URL": "https://apis.evaluar.com",
        "EVALUAR_GRAPHQL_URL": "https://apis.evaluar.com/v2/graphql",
        "EVALUAR_CLIENT_ID": "evcap"
      }
    }
  }
}

3. Reiniciar tu IDE

Reinicia Claude Desktop, Cursor o tu IDE preferido para que cargue el nuevo MCP server.

Herramientas Disponibles

Autenticación

• auth_login: Iniciar sesión con usuario y contraseña
• auth_refresh: Refrescar el token de autenticación

Gestión de Empresas

• company_list: Listar empresas disponibles
• company_select: Seleccionar empresa activa

Búsqueda de Positions

• position_search: Buscar positions por nombre (soporta wildcard)

Procesos eTalent

• process_create: Crear proceso eTalent (estado DRAFT)
• process_assign_position: Asignar position a un proceso
• process_launch: Lanzar proceso (devuelve URL de summary)

Flujo de Uso Típico

1. Iniciar sesión:

   Usa auth_login con tus credenciales de Evaluar
   

2. Seleccionar empresa (si tienes más de una):

   Usa company_list para ver opciones
   Usa company_select para elegir una
   

3. Buscar position:

   Usa position_search con el nombre del cargo
   

4. Crear y lanzar proceso:

   Usa process_create
   Usa process_assign_position
   Usa process_launch
   

5. Acceder al proceso:

   Copia la URL de summary devuelta por process_launch
   

Ejemplo de Uso

"Necesito lanzar un proceso eTalent para un asesor de ventas"

El MCP te guiará paso a paso:

1. Pedirá tus credenciales
2. Si tienes varias empresas, te mostrará opciones
3. Buscará positions relacionadas con "asesor ventas"
4. Creará el proceso y te dará la URL de summary

Variables de Entorno

• EVALUAR_AUTH_URL: URL de autenticación Keycloak
• EVALUAR_API_URL: Base URL de APIs REST
• EVALUAR_GRAPHQL_URL: URL de endpoint GraphQL
• EVALUAR_CLIENT_ID: Client ID OAuth (default: evcap)

Rate Limiting

El servidor implementa un límite de 1 solicitud por segundo para evitar sobrecargar las APIs de Evaluar.

Manejo de Errores

• 401: Requiere autenticación o refresh de token
• 403: Permisos insuficientes
• 5xx: Error del servidor Evaluar
• Rate limit: Espera requerida antes de siguiente solicitud

Soporte

Este MCP solo soporta procesos tipo etalent. Otros tipos como cap360 o trust están fuera del alcance actual.

Estructura del Proyecto

evaluar-mcp/
├── src/
│   ├── index.ts          # Entry point MCP server
│   ├── tools/            # MCP tools implementations
│   ├── api/              # HTTP client
│   └── types.ts          # TypeScript types
├── dist/                 # Compiled output
├── package.json
└── tsconfig.json