MCP de analistas

El MCP de analistas (@magneto/mcp-recruiting) expone capacidades relacionadas con vacantes, pipelines y procesos de selección en Magneto Empleos, orientadas a analistas.

• Administración de vacantes (vacant_create, vacant_search)
• Pipelines y stages (vacant_stages)
• Búsqueda y recomendación de candidatos (candidate_search, candidate_suggestions)
• Importación de candidatos al pipeline (candidate_import)

El MCP de analistas 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/recruiting

2. Registrar en el cliente MCP

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

3. Autenticación

El gateway valida un access token OAuth 2.1 con audiencia CRM. El JWT del analista viaja en params._meta.auth.bearerToken en cada tools/call.

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

Este MCP requiere un JWT de analista (audiencia CRM), propagado vía params._meta.auth.bearerToken en cada tools/call. El servidor no almacena credenciales.

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

• recruiting.vacant_create requiere los scopes VC-02-1 / VC-02-2.
• recruiting.candidate_import requiere el scope vacantsImportAccess.

Sin token válido, la tool responde UNAUTHORIZED sin llegar al API upstream.