Skip to main content
Nexor usa un tipo de clave distinto para cada superficie de desarrollo. Elige la clave más limitada que permita completar la integración.
Nunca pongas una clave nxr_live_ o nxr_mcp_ en HTML, JavaScript para navegador, una aplicación móvil, una captura, un registro ni un repositorio público. Una clave nxr_pub_ es visible en el navegador y no es secreta; úsala solo en flujos compatibles de Chat web.

​
Crear una clave REST

Crea una clave para cada integración. Así podrás revocarla sin interrumpir las demás:
  1. En Nexor, abre Configuración → Claves API desde el menú de cuenta, abajo en la barra lateral.
  2. Selecciona Nueva clave.
  3. Escribe un nombre que identifique la integración.
  4. Selecciona Crear clave.
  5. Copia la clave y guárdala de forma segura.
Crear una clave no revoca las claves existentes.

​
Usar una clave REST

Envía la clave en el header X-API-Key de cada solicitud directa a la API:
Las claves REST no tienen scopes por operación. Pueden llamar las operaciones públicas para clientes de la cuenta, por lo que conviene crear una clave distinta para cada integración de backend y guardarla en el gestor de secretos de ese servidor.

​
Usar una clave MCP

Las claves MCP comienzan con nxr_mcp_. Crea una desde Ajustes → Servidor MCP, selecciona solo los scopes que necesita el cliente MCP y guarda la clave resultante en la configuración secreta de ese cliente. El servidor MCP aplica los scopes seleccionados para la clave. Las operaciones de la API pública que declaran una comprobación de scope a nivel de ruta vuelven a aplicarla y responden con 403 Forbidden cuando la clave no incluye ese scope. Consulta Conectar el Servidor MCP de Nexor para configurar clientes y ver la lista actual de scopes.

​
Usar una clave publicable de Chat web

Las claves publicables comienzan con nxr_pub_. La pantalla de instalación de Chat web entrega la clave del espacio de trabajo y permite configurar los dominios permitidos. Esta clave es visible en el navegador, no es secreta y está destinada a Chat web. El flujo opcional requestContact del SDK v0.1.44 no está soportado en sitios públicos no confiables mientras esté pendiente el refuerzo del backend para solicitudes de contacto. Usa el flujo normal de captura de Chat web o crea leads desde un servidor confiable con una clave nxr_live_. Consulta Chat web para conocer las opciones de instalación con script alojado y con npm.

​
Revocar una clave REST

Para desactivar una clave:
  1. Abre Configuración → Claves API.
  2. Selecciona Revocar junto a la clave.
  3. Confirma la acción.
Revocar una clave no afecta a las demás. Como las consultas de autenticación usan caché, una clave revocada puede seguir aceptándose hasta 10 segundos durante la operación normal o hasta 5 minutos si la base de datos no está disponible. Si vas a rotar una clave, crea e instala su reemplazo antes de revocar la anterior.

​
Respuestas de error

​
Falta la clave de API

Nexor responde con 401 Unauthorized cuando no se proporciona una clave de API.

​
Clave de API inválida

Nexor responde con 401 Unauthorized cuando la clave es inválida, o después de que una revocación se propaga y la clave deja de aceptarse desde caché.

​
Falta de scope o tipo de clave incorrecto

Nexor responde con 403 Forbidden cuando el servidor MCP o una operación de API con scope rechaza una clave que no incluye el scope requerido. Una ruta que no acepta claves publicables también puede responder con 403 Forbidden. Cambiar el prefijo en una solicitud no modifica el tipo ni los permisos guardados de la clave.
Última modificación el 25 de septiembre de 2026