# Recetas de MAX para tu agente de IA (/es/docs/max/recipes)

Da una tarea útil al agente sin escribir tú la secuencia de comandos. Los ejemplos incluyen peticiones para tus chats, el resultado esperado y enlaces a las instrucciones exactas.

Esta página te ayuda a encargar tareas periódicas a tu agente de IA (como Claude Code, Codex, Cursor o Gemini CLI): resúmenes, informes, compromisos pendientes y seguimiento de grupos. Cada receta incluye una petición, comandos y si modifica MAX. Aprenderás a programar ejecuciones y limitar las acciones en una configuración que el agente no pueda modificar.

Palabras en esta página:

- **Agente**: agente de IA que ejecuta comandos por ti en el ordenador.
- **Skill**: archivo de instrucciones para usar `max`. `max skill install` lo coloca donde el agente lo busca.
- **Cliente MCP**: aplicación de IA sin terminal, como Claude Desktop. Usa el servidor `max personal mcp serve` en lugar de ejecutar comandos.
- **Modo no interactivo**: recibe una petición, la ejecuta y termina. Claude Code usa `-p`; Codex, `codex exec`.
- **cron**: programador de Linux y macOS que ejecuta comandos a horas indicadas.

## ¿Qué recetas pueden hacer? [#qué-recetas-pueden-hacer]

|Receta|Escribe en MAX|Adecuado para el horario|
|---|---|---|
|[Resumen matutino](#утренняя-сводка)|No|Sí|
|[Informe semanal de chat de trabajo](#недельный-отчёт-по-рабочему-чату)|No|Sí|
|[Quién le debe a quién](#кто-кому-должен)|No|Sí|
|[A quien no respondiste](#кому-вы-не-ответили)|No|Sí|
|[Encuentra lo que se dijo](#найти-что-было-сказано)|No|Sí|
|[Borrador de respuesta](#черновик-ответа)|sólo después de tu “sí”|No|
|[El grupo que diriges](#группа-которую-вы-ведёте)|sólo si lo permiten las reglas del grupo|Sí|

## Preparación inicial [#preparación-inicial]

1. Instala `max` e inicia sesión: [instalación](/llms.mdx/docs/es/max/installation/content.md) y [sesiones](/llms.mdx/docs/es/max/sessions/content.md).
2. Instala la skill del agente:

   ```sh
   max skill install
   ```

La skill se guarda en `~/.claude/skills/max-cli/` para Claude Code y en `~/.agents/skills/max-cli/` para Codex y Gemini CLI. `max skill show` muestra el mismo texto si tu agente usa otra ubicación.
3. Guarda las peticiones en archivos, por ejemplo `~/max-recipes/`. Los comandos de programación siguientes las leen de un archivo.

El cliente MCP no necesita la habilidad. Conecte el servidor MCP (`max personal mcp config` imprime una entrada para su configuración) y llame a los comandos listos para usar: `/catch-up`, `/review`, `/reply`, `/find`. Consulte [Comandos listos para el servidor MCP](/llms.mdx/docs/es/max/mcp/content.md#%D0%BA%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D1%8B-%D0%B8-%D1%87%D0%B0%D1%82%D1%8B-%D0%BF%D0%BE-).

## Permisos del agente [#permisos-del-agente]

El agente de programación trabaja sin usted, por lo que las restricciones se establecen en la configuración, no en la solicitud. Un agente puede malinterpretar la frase “no envíes nada”. No eludirá una prohibición en aquellas configuraciones que no pueda cambiar.

**Prohibición a nivel de agente.** Esta es una configuración para el propio agente. Por ejemplo, Claude Code en modo `-p` solo ejecuta comandos desde `--allowedTools`. Si `max personal messages send` no está en la lista, el agente no puede llamarlo:

```sh
claude -p "$(cat ~/max-recipes/morning.md)" --allowedTools "Bash(max personal inbox:*)"
```

El Codex no tiene tal lista. Su zona de pruebas cierra de forma predeterminada la red y la escritura de archivos, y `max` necesita ambas cosas: conectarse a MAX y guardar lo que lee en su copia. Por lo tanto, Codex comienza con `--sandbox danger-full-access` y el envío está limitado por la configuración de `max` a continuación.

**En `max`**, el límite se aplica a cualquier agente:

```sh
for resource in messages reactions polls topics chats contacts account bot conversations; do
  max personal config set "permissions.$resource" readonly
done
max config show                       # проверить эффективные права
max personal config set sends_per_hour 5          # или: не больше пяти сообщений в час
max personal recipients add "Иван Петров"       # и писать только в эти чаты
```

`readonly` en un recurso no afecta a otros: limitar solo `messages` deja disponibles reacciones, votos o cambios de chats. Por eso el bucle configura cada recurso. Una clave más precisa, como `permissions.messages.send: allow`, tiene prioridad: elimina esas excepciones para un perfil de solo lectura.

`permissions` también restringe tus propios comandos hasta que elimines la prohibición: `max personal config unset permissions.<ресурс>`. Luego, la configuración heredada y los valores predeterminados se aplican nuevamente. Para restringir solo al agente, asígnele un perfil separado. Todos los intentos de envío, incluidos los rechazados, se envían a `max personal sends list`. Consulte [protección contra direcciones erróneas](/llms.mdx/docs/es/max/security/content.md#%D0%B7%D0%B0%D1%89%D0%B8%D1%82%D0%B0-%D0%BE%D1%82-%D0%BE%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B8-%D0%BD%D0%B5-%D1%82%D1%83%D0%B4%D0%B0) y [permisos](/llms.mdx/docs/es/max/configuration-reference/content.md#%D0%BF%D1%80%D0%B0%D0%B2%D0%B0-%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%B0).

**Leer no revela tu actividad.** Ninguna orden de estas recetas marca mensajes leídos; tu interlocutor no ve que el agente abrió el chat.

## Programar ejecuciones [#programar-ejecuciones]

- **Claude Desktop: tareas programadas.** La tarea se ejecuta en su computadora, por lo que puede acceder a `max` y a sus entradas. Un inicio fallido (la computadora estaba inactiva) se realiza una vez después de despertarse. Ver [tareas programadas Claude](https://code.claude.com/docs/en/desktop-scheduled-tasks).
- **`max schedule`.** Una programación integrada: crea por sí misma la entrada en el programador del sistema (systemd en Linux,
  launchd en macOS, el Programador de tareas en Windows) y no requiere editar crontab. El perfil se nombra con la primera
  palabra, como en cualquier comando:

  ```sh
  max personal schedule command inbox-daily --at 08:30 -- inbox      # команда `max personal inbox` каждый день
  max personal schedule agent morning claude "прочитай max skill show follow-ups и выполни ежедневную проверку" --at 08:30
  max personal schedule list                                         # что назначено и как прошёл последний запуск
  max personal schedule run morning                                  # запустить сейчас, как это сделал бы таймер
  max personal schedule remove morning
  ```

  `schedule agent` ejecuta `claude` o `codex` con la variable `MAX_READ_ONLY=1`: el agente lee y escribe
  borradores, pero no puede enviar nada. La respuesta del agente se guarda y recibes una notificación.
  `--max-cost` detiene una ejecución de `claude` que cueste más de la cantidad indicada en dólares.
  La programación se define con `--every 30m`, `--at 08:30` (cada día) o `--at-time 2h` (una sola ejecución).
- **cron y `claude -p`.** Sin una aplicación, en cualquier computadora que esté encendida en este momento:

  ```cron
  30 8 * * * claude -p "$(cat ~/max-recipes/morning.md)" --allowedTools "Bash(max personal inbox:*)" >> ~/max-recipes/morning.log 2>&1
  ```

Los trabajos cron se ejecutan en un entorno casi vacío. En Linux esto rompe `max` de dos maneras:

- **`node: not found`, código 127.** Node instalado mediante nvm, fnm o Volta no está en el `PATH` del sistema; cron solo conoce ese PATH.
- **`no token found for profile "personal", although it has logged in on this machine`, código 4.** `max` no alcanza el llavero y no ve el token. **No vuelvas a iniciar sesión**: la sesión funciona; el problema es el entorno.

Ambas líneas van al principio de `crontab -e`, con sus propios valores. La carpeta es de `dirname "$(which node)"`, el número es de `id -u`:

  ```cron
  PATH=/home/ivan/.nvm/versions/node/v24.19.0/bin:/home/ivan/.local/bin:/usr/local/bin:/usr/bin:/bin
  XDG_RUNTIME_DIR=/run/user/1000
  ```

El almacén de contraseñas está disponible mientras está conectado. Verifique el primer inicio con las manos y mire el registro. Ver [sin modo de diálogo en Claude](https://code.claude.com/docs/en/headless).

- **Cron con `codex exec`:**

  ```cron
  30 8 * * * codex exec --sandbox danger-full-access "$(cat ~/max-recipes/morning.md)" >> ~/max-recipes/morning.log 2>&1
  ```

Consulte [sin modo de diálogo en Codex](https://learn.chatgpt.com/docs/non-interactive-mode).
- **Dentro de una sesión abierta Claude Code** - `/loop` o “recuérdamelo a las 15:00”. Funciona mientras la sesión está abierta. Ver [tareas programadas Claude Code](https://code.claude.com/docs/en/scheduled-tasks).

Las tareas (rutinas) en la nube de Claude no son adecuadas: se ejecutan en otra computadora donde no están presentes `max` ni su inicio de sesión.

## Revisión diaria de compromisos [#revisión-diaria-de-compromisos]

La habilidad lista para usar `follow-ups` lleva tus compromisos: una vez al día lee `max tasks agenda`, mira solo
los chats que esa agenda nombra, crea y vincula tareas y devuelve una lista corta con borradores de respuesta.
No envía nada. Para leerla: `max skill show follow-ups`. Para ejecutarla de forma programada:

```sh
max personal schedule agent follow-ups claude "выполни ежедневную проверку: max skill show follow-ups" --at 08:30
```

## Resumen de la mañana [#resumen-de-la-mañana]

Escribe en MAX: **no**. Permite `Bash(max personal inbox:*)`.

> Ejecute `max personal inbox --new --json`. Mensajes grupales por chat. Para cada chat - una línea:
> quién escribe y qué quiere. Arriba está lo que necesita respuesta hoy. Anuncios y notificaciones
> reducir los servicios a una línea al final.

`--new` muestra cada mensaje una vez. `max` recuerda dónde quedó en cada chat y el siguiente ejecución comienza desde ese lugar. La primera ejecución analiza las últimas 24 horas.

### Desde cuándo es «nuevo» [#desde-cuándo-es-nuevo]

- `max personal inbox`: lo no leído según MAX, es decir, todo lo que no has abierto en ningún dispositivo.
- `max personal inbox --new`: desde la ejecución anterior de `--new`. Ese punto solo lo conoce `max`; tus interlocutores no lo ven.
- `max personal inbox 'date>2d'`: los dos últimos días; el punto guardado no se mueve.

Ninguno marca mensajes como leídos. Para hacerlo, ejecuta `max personal chats mark-read <чат>`. La otra persona verá la confirmación de lectura.

### Chats individuales, grupos y canales por separado [#chats-individuales-grupos-y-canales-por-separado]

`kind:` deja solo chats del tipo requerido: `dialog` - personal, `group` - grupos, `channel` - canales. El resumen del canal y el resumen de la conversación se pueden ejecutar por separado, en momentos diferentes. Cada chat tiene su propio punto y un ejecución no oculta lo que el otro aún no ha mostrado:

```cron
30 8 * * * claude -p "$(cat ~/max-recipes/morning.md)" --allowedTools "Bash(max personal inbox:*)"
0 19 * * * claude -p "$(cat ~/max-recipes/news.md)" --allowedTools "Bash(max personal inbox:*)"
```

`morning.md` contiene `max personal inbox --new 'kind:dialog OR kind:group' --json`; `news.md`, `max personal inbox --new kind:channel --json` y la petición de elegir lo importante. Sin `kind:`, todo junto.

## Informe semanal del trabajo [#informe-semanal-del-trabajo]

Escribe: **no**. Permite `Bash(max personal messages list:*)`.

> Leer mensajes en el chat "Proyecto Alfa" de los últimos 7 días: `max personal messages list "Проект Альфа"
> 'date>7d' --limit 200 --json`. Si en la respuesta
> hay un paso `page.next`, sigue leyendo con su `--cursor`. Hacer un informe: qué se decidió, quién asumió qué y para qué
> plazo, qué preguntas quedaron sin respuesta. Cada artículo tiene una fecha y un autor.

## Compromisos y seguimiento [#compromisos-y-seguimiento]

Escribe: **no**. Permite `Bash(max personal review:*)`, `Bash(max personal messages context:*)`, `Bash(max personal search messages:*)`.

> Complete `max personal review --new --transcribe --json` (primera vez - 3 días, luego - desde la última
> `--new`, cada chat tiene su punto). Divídalo en tres listas: lo que debo, lo que espero de los demás,
> lo que hay que aclarar. Cada elemento tiene un chat, fecha e id de los mensajes en los que se basa; término -
> sólo si se nombra. Antes de llamar por algo vencido, verifique si se hizo más tarde
> o en grupos de trabajo. Si es `"complete": false`, dime qué falta. Lista al final
> elementos no cerrados.

`--transcribe` primero traduce mensajes de voz a texto; esto puede tardar unos minutos. La siguiente revisión es la misma solicitud más los elementos no cerrados del pasado: el agente los revisará primero. Un chat que no se haya leído en su totalidad guardará su punto y volverá. En el cliente MCP, este es el comando `/review`.

## A quién no has respondido [#a-quién-no-has-respondido]

`max personal review 'date>7d' --unanswered --json` encuentra preguntas dirigidas a ti, o a ti y administradores en grupos. Esta receta también detecta peticiones sin interrogación.

Escribe: **no**. Permite `Bash(max personal chats list:*)`, `Bash(max personal messages list:*)`.

> Ejecute `max personal chats list kind:dialog --offline --limit 30 --json`. Para cada chat, ¿dónde está el último?
> el mensaje fue en los últimos 7 días, lea `max personal messages list <id чата> --limit 5 --json`.
> Mostrar chats donde el último mensaje no es mío y contiene una pregunta o solicitud: con quién, sobre qué y
> cuantos dias han pasado?

## Encuentra lo que se dijo [#encuentra-lo-que-se-dijo]

Escribe en MAX: **no**. Permitir: `Bash(max personal search messages:*)`, `Bash(max personal messages context:*)`.

> Busque la "cuenta" a través de `max personal search messages счёт --json`. Para cada uno encontrado, lea
> `max personal messages context <locator> --json` y dime quién dijo qué y cuándo.

Por defecto, la búsqueda se realiza tanto en la copia de este ordenador como en el servidor MAX. El archivo local contiene sólo lo que `max` ya ha guardado. Para buscar todo tu historial de chat localmente, primero descárgalo. Esta es una solicitud de su cuenta, así que hágala usted mismo: `max personal messages sync <чат>`. Ver [historial de descargas](/llms.mdx/docs/es/max/archive/content.md#%D1%81%D0%BA%D0%B0%D1%87%D0%B0%D1%82%D1%8C-%D0%B8%D1%81%D1%82%D0%BE%D1%80%D0%B8%D1%8E).

## Borrador de respuesta [#borrador-de-respuesta]

Escribe: **solo después de tu aprobación**. Para conversación interactiva, no programación.

> Lee los últimos 20 mensajes con Iván Petrov y propón una respuesta a su última pregunta. No la envíes; muéstrame el texto.

Tras tu aprobación, el agente envía el texto con `max personal messages send "Иван Петров" "…"`. El cliente MCP se conecta mediante `max personal mcp serve`. No configures una aprobación previa de `max_write`; así el cliente preguntará antes de enviar. Los permisos del perfil siguen limitando la escritura. Consulta [servidor MCP](/llms.mdx/docs/es/max/mcp/content.md).

## Un grupo que administras [#un-grupo-que-administras]

Escribe: **solo según las reglas**. Permite `Bash(max personal review:*)`, `Bash(max personal chats events:*)`, `Bash(max personal chats members list:*)`, `Bash(max personal chats moderate:*)`.

> Ejecute `max personal review 'chat:"Поход"' --unanswered 4h --json`, `max personal chats events "Поход"
> 'time>=7d' --json` y `max personal chats moderate "Поход" --dry-run --json`. Brevemente: de qué preguntas esperan respuestas
> quién y desde qué hora; quién se unió o fue agregado durante la semana y por quién; lo que encontró el cheque
> reglas del grupo y lo que se propone hacer. No respondas a nadie ni elimines a nadie tú mismo: enuméralo
> equipos que lo harán si estoy de acuerdo.

Con `--dry-run`, el comando de `chats moderate` solo está haciendo un plan. Sin él, actúa dentro de las reglas del grupo, por lo tanto, elimine `Bash(max personal chats moderate:*)` de la lista si el agente nunca debe actuar. Todos los escenarios y reglas: [grupos que usted lidera](/llms.mdx/docs/es/max/groups/content.md).

## Colecciones relacionadas [#colecciones-relacionadas]

Todavía no existen recetas preparadas para MAX. Para Telegram existe; sus consultas también son adecuadas para `max`, si reemplaza las herramientas con comandos:

- [Telegram MCP: guía completa](https://mcp.directory/blog/telegram-mcp-complete-guide-2026) - análisis matutino de bandejas de entrada, borradores de respuestas, resumen de canales, búsqueda en varios chats.
- [pioh/tg](https://github.com/pioh/tg) - Agente de IA con una cuenta personal de Telegram: resumen una vez cada N minutos, "recuérdame si no le respondí a mi mamá en 15 minutos", monitoreando personas y chats.
- [Libro de cocina de Gorgias MCP](https://github.com/gorgias/mcp-cookbook) - recetas para el servicio de soporte, pero bien organizadas: a cada uno se le dice si está escribiendo algo y qué corregir por sí mismo.
