Seguridad y privacidad de la CLI de MAX
Consulta los permisos, las credenciales, el almacenamiento local y las confirmaciones de la CLI de MAX.
Elige lo que puede hacer tu agente y conoce dónde se guardan los datos de acceso y mensajes. Aquí se explican las protecciones, sus límites y los ajustes que puedes comprobar antes de permitir envíos u otros cambios.
Lea esta página antes de darle acceso a un agente o script de IA a su cuenta MAX a través de max, o cuando quiera saber qué almacena max en su computadora. Ella explica dónde se almacena la entrada, qué escribe max en el disco, con qué servidores contacta, qué detiene el envío no deseado y qué hacer si se filtra el token. Después de leerlo, podrás evaluar lo que puede hacer alguien con acceso a esta computadora, o un agente con acceso a max.
Palabras que aparecen en la página:
- Token es una cadena que te mantiene en tu cuenta MAX. Quien la tiene usa la cuenta.
- Archivo local compartida: una base de datos en su computadora donde
maxytgalmacenan los mensajes leídos. Es común a ambas herramientas y no está cifrado. - Protección contra envío: verifica que cada cambio se realice antes de ingresar a MAX: derechos, lista de destinatarios permitidos y límite de envío por hora.
Lo común a max y tg (el archivo local de las conversaciones, la protección de envíos, los permisos del agente, el texto ajeno en pantalla, lo que ven otros en el comando y cómo informar de una vulnerabilidad) se describe en la página común de seguridad. Aquí está lo que afecta solo a MAX.
Resumen: qué protege
Lo que protege cualquier herramienta de WireCat está en la página común. Particularidades de MAX:
- El servidor en segundo plano también aplica los límites del perfil. Los permisos, los destinatarios y el límite por hora se comprueban en el comando y en
max personal serve, incluso para programas que conectan directamente a su socket (abajo). - Token.
maxno guarda un token deMAX_TOKENni lo pasa al servidor. El servidor no entrega tokens a los clientes del socket (abajo). - Red. Los archivos se descargan por HTTP(S) mediante el transporte de red normal, incluida la red local, dentro del límite de tamaño configurado. Los frames MAX y los datos descomprimidos tienen límites; las conexiones tienen tiempos de espera (abajo).
- Cuenta.
maxno es una aplicación oficial, y las condiciones de MAX no permiten este tipo de programas sin consentimiento de la empresa (abajo).
Dónde se guarda el token
En el almacén de claves del sistema, servicio max-cli, entrada con nombre del perfil. No se guarda en configuración, argumentos, variables de shell ni historial.
Si no hay almacén, se guarda en ~/.config/max-cli/credentials.json con 0600 y se avisa por stderr. max personal doctor también indica que procede de archivo.
MAX_TOKEN tiene prioridad sobre el almacén, para CI. El token de la variable permanece solo en ella:
- Si MAX renueva el token,
maxno lo guarda en almacén ni archivo; avisa por stderr. Así no queda un token activo en archivos de compilación que puedan acabar en cachés o artefactos. - Con
MAX_TOKENno iniciamax personal serveni le transmite la variable; evita que un token de un comando siga activo quince minutos en segundo plano.
El token de max sales bot está separado en el servicio max-cli, entrada bot:<профиль>; sin almacén, en el mismo archivo con 0600. MAX_BOT_TOKEN tiene prioridad, igual que MAX_TOKEN. max sales bot auth set valida a qué bot pertenece antes de guardar, para no sustituir un token válido por una errata. Nunca guarda el de MAX_BOT_TOKEN.
La configuración no admite secretos: no hay campos para token, teléfono ni identificador de chat.
Otros datos en disco
| Contenido | Ubicación | Permisos |
|---|---|---|
estado del perfil: dispositivo, accesos y viewerId | ~/.local/share/max-cli/profiles/<профиль>.json | 0600 |
| configuración | ~/.config/max-cli/config.json | carpeta 0700, archivo 0600; doctor nombra los abiertos |
registros de ejecución, de cada ejecución: las correctas 7 días, las fallidas 30 (record false deja solo las fallidas): palabras del comando, identificadores, tiempos y código de error; la línea de comandos tal como la escribiste, sin secretos (record_input false oculta lo escrito, diagnóstico) | ~/.local/share/max-cli/runs/… | carpeta 0700, archivos 0600 |
| registro de envíos, siempre: chat, hora, identificador, longitud y resultado, sin texto | ~/.local/share/max-cli/sends/<профиль>.jsonl | carpeta 0700, archivos 0600 |
| destinatarios permitidos, si está activo | ~/.local/share/max-cli/profiles/<профиль>.recipients.json | 0600 |
reglas de moderación tras el primer chats rules set | ~/.local/share/max-cli/profiles/<профиль>.moderation.json | 0600 |
bot: chats vistos, envíos, destinatarios y punto de watch | ~/.local/share/max-cli/bots/… | carpeta 0700, archivos 0600 |
copia compartida de mensajes de cuenta personal, bot y tg, con textos, transcripciones, rutas de adjuntos descargados y su texto extraído | ~/.local/share/WireCat/wirecat.db | carpeta 0700, archivo 0600 |
socket y registro de max personal serve | ~/.local/share/max-cli/profiles/<профиль>.sock, .serve.log | 0600 |
| copia anterior del perfil; ya no se abre | ~/.cache/max-cli/<профиль>.db y sus -wal, -shm | carpeta 0700, archivos 0600 |
exportación, solo max personal store export --output | destino indicado | 0600 |
archivos descargados, max personal messages download o max personal attachments extract --download --output-dir | carpeta actual o --output | 0600 |
informe, solo max personal doctor reports create | carpeta actual o --output | 0600 |
modelos de voz, solo tras max personal models download | ~/.local/share/WireCat/models/audio/… | carpeta 0700, archivos 0600 |
⚠ La copia compartida contiene texto de mensajes y transcripciones de voz: sirve para responder sin red. max personal session end no la elimina. max personal store clear --left --allow-dangerous solo borra datos de chats abandonados; no hay una orden que elimine toda la copia compartida.
Los archivos antiguos de caché del perfil ya no se abren. Si quedan, max personal doctor muestra su ruta; puedes borrarlos aparte sin afectar a la copia compartida.
También hay contenido de conversaciones en la copia del bot, exportaciones y descargas; la lista de chats del bot contiene títulos. El resto no contiene conversaciones.
Si el comando cae en otras manos
Frente a quien extrae el disco solo protege el cifrado completo del disco: consulta la página común. En Windows, el acceso a los archivos depende de los permisos del directorio del usuario y de los directorios MAX_*_DIR elegidos; los permisos numéricos de la tabla corresponden a Unix.
Protección de envíos
Por qué hace falta la protección de envíos y cómo funciona se explica en la página común. Antes de cada escritura (mensajes, reacciones, ediciones, reenvíos, eliminaciones), max comprueba todo lo que figura en la tabla de abajo y después escribe una línea en el registro.
En los ejemplos de abajo, agent es el nombre de un perfil que creaste aparte para el agente; pon el tuyo.
La prohibición por nivel o por MAX_READ_ONLY actúa antes de conectarse a MAX. El chat no se busca, así que la línea de la negativa
en el registro es más corta: la clave del comando (messages.send) y el tipo de escritura, y el chat solo si el comando indica su id numérico.
--dry-run con MAX_READ_ONLY da la misma negativa y no escribe en el registro.
Los bots tienen claves propias bot.*, como bot.messages.send. Usan los mismos niveles. Los ajustes comunes y las capas bot.defaults/bot.profiles se resuelven en el mismo orden; config show --bot muestra los permisos efectivos.
Cada bot tiene destinatarios (max <имя> bot recipients add <чат>) y registro (max <имя> bot sends list) propios. Toda escritura pasa por ellos, incluidos messages send, messages pin y bot api, para evitar eludir controles con API genérica. Edición y eliminación reciben primero el chat; max consulta el mensaje y rechaza si pertenece a otro. No hace esa comprobación para user:<id>. Registra chat, tipo, resultado y longitud, nunca texto. No hay límite por hora de bots hasta definirlo en bot: max <имя> config set --bot sends_per_hour 200.
El servidor en segundo plano max personal serve realiza las mismas comprobaciones para todo lo que pasa por él, incluidas las solicitudes de programas conectados directamente a su socket en lugar de mediante max. Solo acepta solicitudes que conoce max, con la forma en que las envía max; por ejemplo, rechaza eliminar un chat completo. Los cambios mediante config set se aplican de inmediato sin reiniciar el servidor.
Contactos, perfil, carpetas y sesiones también respetan solo lectura. No usan destinatarios ni límite por hora porque no envían a chats. Se registran como account y acción, sin nombres, teléfonos ni títulos.
La lista es opcional: sin destinatarios añadidos, cualquier chat; activa pero vacía significa ninguno. Si está activa, chats create <название> <люди…> y chats members add solo admiten personas cuyo chat individual esté permitido. Un nuevo miembro no ve mensajes anteriores salvo con --history. Un mensaje programado cuenta en la hora del envío. Dos comandos simultáneos no superan juntos el límite: se reserva desde la comprobación hasta la respuesta. Eliminar datos de chats abandonados no modifica el registro de envíos.
⚠ Limitaciones de los controles. Están dentro de max: un agente con shell puede quitarlos por sí mismo. Qué límite poner desde fuera se explica en la página común. Para max: MAX_PROFILE_LOCK fija el perfil, MAX_PROFILE no; --file y bot uploads put rechazan archivos y carpetas conocidos de credenciales, los directorios de max y el almacén de mensajes mientras no se indique --allow-any-file. Se permiten las carpetas de trabajo ocultas normales; MCP no permite eludir esta protección.
Qué no hace la herramienta
- No marca como leído sin preguntar. “Obtener historial” y “marcar como leído” son operaciones de protocolo diferentes. El segundo lo envían únicamente
max personal chats mark-read; leerlo no lo envía. - No envía cambios sin que se soliciten. Las operaciones que cambian el estado remoto son
messages send|edit|delete|forward|pin|unpin|press,reactions add|remove,polls vote|close|create,contacts add|remove|import|rename|block|unblock,account update,account sessions end,session end,chats join|leave|create|update|start|app,chats members|admins …,chats requests confirm|reject,chats links reset,chats folders create|update|delete|order,chats moderate(dentro de las reglas del grupo) ychats mark-read. Cada una realiza la acción indicada.max commands --jsonlas identifica medianteeffects.remote: "write". - La eliminación por defecto requiere confirmación. El nivel
askparamessages.deleterequiere una respuesta en el terminal o--allow-dangerous; explícitoallowrealiza la eliminación sin lugar a dudas. Para eliminar a todos también necesitas--for-everyone; La herramienta MCP general no lo permite. - No toma el número de teléfono de la línea de comando.
contacts lookuplo solicita o lo lee desde la tubería,contacts import- desde el archivo: la línea de comando es vista porpsy el historial del shell. No hay ningún número en los errores, el registro de envío y los registros de inicio, ymax personal session startymax personal account showlo muestran oculto. - No escribe mensajes en el registro. Ni en forma recortada ni en hash - consulte diagnóstico.
Excepción: el texto que tú mismo escribiste en la línea de comandos puede quedar en el
argvdel registro de ejecución mientrasrecord_inputno esté desactivado (lo que escribiste). - No pasa por intermediarios. Donde se conecta exactamente el
maxes en el apartado “Qué entra a la red”.maxno tiene telemetría propia;max personal serveenvía MAX un evento de servicio, como una pestaña oculta de la versión web; consulte en el mismo lugar. - Mantiene la conexión sólo en
max personal serve. Se inicia en segundo plano con el primer comando que necesita MAX; se detiene solo después de 15 minutos sin nada que hacer. No ejecutar -max personal config set serve false.
Texto ajeno en pantalla
Los nombres, títulos y textos de otras personas no controlan la terminal: los caracteres de control e invisibles aparecen como texto, los nombres se imprimen en una línea y el autocompletado solo introduce números. Más detalles en la página común.
Qué ven otros procesos
El token no se pasa como argumento, pero el texto de un mensaje sí, y se ve en ps y en el historial de la shell (página común). Los archivos de estado y el socket del servidor en segundo plano están protegidos con permisos 0600 y carpetas 0700. config set escribe config.json con permisos 0600; un archivo de una versión anterior puede seguir con 0644 hasta que se reescriba, y max doctor nombra ese archivo y el comando chmod que lo corrige. Al mover archivos o redirigir la salida, comprueba los permisos por separado.
Qué sale por la red
max personal messages download usa HTTP(S) y redirecciones normales sin comprobar las direcciones DNS. El comando no prohíbe VPN, proxies ni direcciones locales. Límite de archivos: 4 GiB; voz para transcripción: 32 MiB.
Las solicitudes de max sales bot se identifican como max-cli/<версия>: MAX ya conoce al bot por su token. El certificado de platform-api2.max.ru está firmado por una raíz del Ministerio de Desarrollo Digital ausente en Node. En Node, max la añade a los certificados de confianza de todo el proceso: desde la primera solicitud del bot, todas las conexiones TLS de esa ejecución de max confían en ella, no solo las de Bot API. En Bun se añade únicamente para las solicitudes de Bot API. El sistema no cambia.
Para las cuentas personales, las solicitudes de red no contienen el nombre de esta herramienta ni un user-agent propio: el user-agent y la descripción del dispositivo proceden del cliente web de MAX. Las tramas también usan la dirección, el formato binario y la compresión del cliente web. max personal serve reproduce la telemetría del cliente web tal como la envía una pestaña oculta: un evento «lista de chats mostrada» 20 segundos después de iniciar sesión, y nada más. Solo contiene el número de tu cuenta y la hora, sin mensajes ni nombres de chats. Los comandos de una sola ejecución no envían telemetría. Tras iniciar sesión, max personal serve solicita los mismos tipos de datos que la pestaña web: carpetas, banners, historial de llamadas, conjuntos de stickers y reacciones, y las fichas y el estado en línea de los contactos de chats personales. Tras el primer inicio también solicita historias, chats que faltan en las carpetas y la siguiente página de chats. Son peticiones de lectura; las respuestas no se muestran ni se guardan. Los comandos puntuales no las realizan. Hay diferencias: max no se suscribe a notificaciones push ni solicita emojis animados. La pestaña decide qué pedir según su caché del navegador, que max no tiene, por lo que el número de peticiones difiere. MAX puede distinguir max de su cliente web.
Condiciones de MAX y tu cuenta
max no es una aplicación oficial de MAX. El acuerdo de usuario de MAX (versión del 09/09/2026, apartado 4.3.7) no permite programas automatizados sin el consentimiento de la empresa. Por tanto, una cuenta usada con max puede sufrir restricciones, y esa cuenta también puede estar vinculada a servicios públicos y a la comunicación con tus seres queridos.
Prácticas recomendadas:
- Usa MAX como siempre, en el navegador o en el teléfono, junto con
max. Una cuenta que solo responde a solicitudes demaxtiene un comportamiento distinto del de una cuenta usada por una persona. - No conviertas
maxen un flujo continuo de peticiones. Lee cuando lo necesites, no cada minuto por programación.
Se avisa una vez por stderr al iniciar sesión por primera vez con max personal setup o max personal session start.
Inicio de sesión con navegador
session start qr-chrome y sms abren un perfil temporal, separado de tus contraseñas y cookies. Contiene una sesión de web.max.ru y se elimina al terminar, cerrar ventana, alcanzar --timeout o pulsar Ctrl-C. El token se lee por canal de depuración entre proceso y navegador (--remote-debugging-pipe), sin puerto de red ni acceso de otros usuarios.
session start qr dibuja el QR en terminal; queda en el historial visual pero caduca en minutos. Si la terminal es estrecha, lo muestra en una página 127.0.0.1 con dirección aleatoria; no guarda el enlace en archivo ni texto. La página desaparece al terminar.
Cada acceso añade un dispositivo en la lista de sesiones de MAX; puedes cerrarlo allí.
Protocolo no oficial
MAX no publica una API para cuentas de usuario. Todo lo que se sabe sobre el protocolo aquí se midió en una conexión en vivo o se leyó en la ingeniería inversa de otra persona, y para cada operación se anota exactamente de dónde vino (descripción del protocolo, columna "De dónde vino").
Puede dejar de funcionar sin aviso. En ese caso el comando indica el problema por stderr, en lugar de devolver una lista vacía como si todo funcionase.
Uso personal
La herramienta guarda en tu comando conversaciones y contactos de otras personas, incluidos los textos de los mensajes. El acceso a la base local permite acceder a esos datos. Entregar una exportación (max personal store export) a otra persona también entrega el contenido de la conversación; sus enlaces a fotos pueden abrirse sin iniciar sesión. Antes de compartir, revisa el contenido y los destinatarios. Esta página describe el funcionamiento de la herramienta y no certifica el cumplimiento legal de tu caso de uso.
Los informes (max personal doctor reports create) se adjuntan a incidencias públicas de GitHub. No contienen texto, nombres ni teléfonos; los identificadores se sustituyen por etiquetas. Revísalos antes de enviarlos.
Si se filtra el token
max personal session end # выйти из MAX и забыть локальноsession end termina esta sesión en el servidor de MAX, por lo que un token filtrado deja de funcionar. Si MAX no responde, el comando lo indica y conserva el token; repite el comando.
max personal account sessions end --others --yes cierra todas las demás sesiones, también el móvil, donde tendrás que iniciar sesión otra vez. No permite cerrar una concreta: MAX no les da identificador. Si MAX renueva el token actual, max lo guarda antes de confirmar.
Siguiente paso
- Página de seguridad general: Qué es lo mismo en
maxytgy cómo informar una vulnerabilidad - Diagnóstico: qué se registra exactamente y qué nunca se registra
- Inicio de sesión, sesiones y perfiles: llaveros,
MAX_TOKEN, qué hacesession end - MCP: qué puede hacer el agente a través del servidor MCP y qué activa cada flag
- Permisos: cómo configurar
permissionsysends_per_hour