MCP de candidatos

El MCP de candidatos (@magneto/mcp-candidates) es un servidor MCP que expone capacidades inteligentes sobre candidatos y perfiles profesionales dentro de Magneto Empleos.

• Búsqueda y búsqueda semántica de candidatos
• Scoring y fit_analysis
• Resúmenes de perfil (profile_summary)
• Gestión: save_profile, save_opt_in
• Aplicaciones: move_stage, get_pipeline_status, get_applications
• Memoria contextual e historial conversacional

El MCP de candidatos se expone vía Streamable HTTP. Para conectarlo solo necesitás la URL del endpoint y un token de acceso.

1. URL del endpoint

https://api.magneto365.com/mcp/candidates

2. Registrar en el cliente MCP

En Cursor, Claude Desktop o cualquier cliente HTTP, apuntá a la URL con transporte http:

{
  "mcpServers": {
    "magneto-candidates": {
      "url": "https://api.magneto365.com/mcp/candidates",
      "transport": "http"
    }
  }
}

3. Autenticación

El gateway valida un access token OAuth 2.1. Para las tools de candidato, el JWT viaja en params._meta.auth.bearerToken en cada tools/call; si falta, la tool responde UNAUTHORIZED.

• Protected resource: /.well-known/oauth-protected-resource
• Authorization server: /.well-known/oauth-authorization-server

Las tools de candidato operan con el JWT propio del candidato. Se propaga vía params._meta.auth.bearerToken en cada tools/call. El servidor no almacena credenciales.

{
  "method": "tools/call",
  "params": {
    "name": "candidate.search",
    "arguments": {},
    "_meta": {
      "requestId": "req-uuid",
      "auth": { "bearerToken": "eyJ..." }
    }
  }
}

Si falta bearerToken, la tool responde UNAUTHORIZED sin llegar al API upstream.