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.
Una superficie es una forma de trabajar con Netzo: una persona en la app, un agente por MCP, un programa por la API. Todas trabajan sobre el mismo sistema de registro, con las mismas acciones.
Las superficies
| Superficie | Quién actúa | Credencial | Ofrece |
|---|---|---|---|
| App | Una persona | Su sesión | Acciones, en pantallas |
| WebMCP | El agente del navegador, para la persona | La sesión de la persona | Acciones, como herramientas de la página |
| MCP | Un asistente de IA | Clave API u OAuth | Acciones, como herramientas MCP |
| API | Un programa | Clave API u OAuth | Acciones, como endpoints HTTP |
| CLI | Una persona, un agente o un script | Sesión de la CLI o clave API | Acciones, como comandos |
| Webhooks | Tu servicio, que recibe | Un secreto de firma | Eventos |
| Enlaces públicos | Alguien fuera de tu organización | El enlace, y un código si se pide | Un registro compartido |
Común a todas
| Tema | Lee |
|---|---|
| Credenciales, claves API y OAuth | Autenticación |
| Qué trae un error, reintentos y límites | Errores y límites |
| Probar una escritura sin guardar | Simulación, abajo |
| Nombrar dónde ocurre una acción | Lugar, abajo |
Paridad
Las cinco superficies de acciones (App, WebMCP, MCP, API y CLI) ofrecen las mismas acciones:
- Las mismas acciones. Una acción nueva aparece en todas en el mismo despliegue.
- Los mismos permisos. Cada superficie solo muestra lo que permite la credencial. Ve Accesos.
- Las mismas reglas. La base de datos las aplica a toda superficie. Ve Reglas e integridad.
- Los mismos errores. Un rechazo tiene el mismo código y la misma corrección en todas.
La excepción son las acciones internas: unas pocas acciones solo están en la app, porque necesitan una pantalla o a una persona presente. Cada tabla en Dominios muestra dónde está cada acción.
Simulación
Toda escritura puede correr como simulación: ejecuta las reglas y los cálculos, devuelve lo que cambiaría y los eventos que se enviarían, y luego descarta todo.
| Superficie | Cómo |
|---|---|
| API | Encabezado x-netzo-dry-run: 1 |
| MCP | Argumento dryRun: true |
| CLI | Opción --dry-run |
Lugar
Cada acción puede nombrar su lugar, el módulo y la fila donde ocurre. Ve API.