Autenticación

Las credenciales de cada superficie, cómo crear y cuidar una clave API, y cómo se conecta un cliente con OAuth.

Cada solicitud a Netzo lleva una credencial. La credencial dice quién actúa y en qué organización. Lo que esa persona o programa puede hacer lo deciden sus permisos: ve Accesos.

Credenciales

Credencial	Quién la usa	Superficies	Cómo se envía
Sesión	Una persona con sesión iniciada	App, WebMCP, CLI	La app la guarda. En la CLI: `netzo login`
Clave API	Un programa, un agente o un script	API, MCP, CLI	Encabezado `x-api-key: <clave>`. En la CLI: variable `NETZO_API_KEY`
OAuth	Un cliente que actúa por una persona	API, MCP	Encabezado `Authorization: Bearer <token>`. El cliente lo obtiene solo
Secreto de firma	Tu servicio, para revisar un webhook	Webhooks	Netzo firma; tú revisas. Ve Webhooks
Enlace	Alguien fuera de tu organización	Enlaces públicos	El enlace mismo, y un código si se pide

Una credencial pertenece a una sola organización. Netzo toma la organización de la credencial, nunca de la solicitud.

Claves API

Crea una clave en Administración → Integraciones → Claves API.

Un rol por clave. Da a cada clave un rol con solo lo que necesita su programa o agente. Una clave sin un permiso no ve esa tabla ni esa acción.
Se muestra una vez. Copia la clave al crearla. Netzo guarda solo su huella y no la puede mostrar otra vez.
Siempre vence. Una clave vence a los 90 días si no eliges otra fecha, y a lo más en 365 días. Crea la nueva antes de que venza la anterior.
Revoca al momento. Elimina una clave que ya no usas o que se filtró: la siguiente solicitud con ella falla.
Queda registrada. Cada cambio hecho con una clave queda en la bitácora a su nombre. Ve Eventos.

Guarda la clave en un gestor de secretos o en una variable de entorno, nunca en el código ni en un archivo del repositorio.

OAuth

Un cliente compatible con OAuth, como un asistente de IA con MCP, se conecta solo con la dirección del servidor (https://app.netzo.ai/mcp). Descubre cómo autenticarse, abre el inicio de sesión de Netzo y la persona aprueba el acceso. Desde ahí, el cliente actúa con los permisos de esa persona. Ve MCP.

Usa	Cuando
OAuth	El agente trabaja para una persona y debe ver solo lo que ella ve
Clave API	El agente o programa trabaja por su cuenta, con su propio rol, por ejemplo una integración o un proceso nocturno

CLI

netzo login abre el navegador para iniciar sesión como tú. Sin navegador, como en CI, define NETZO_API_KEY. Ve CLI.

Resumen

Las siete superficies de Netzo, quién actúa en cada una, y por qué todas ofrecen las mismas acciones con los mismos permisos.

Errores y límites

Qué devuelve Netzo cuando rechaza una solicitud, cómo corregirla o reintentarla, y cuántas solicitudes acepta.