# Recibe una notificación push cuando el agente termina.

> Recibe una notificación push cuando un agente de IA o una ejecución de LLM termine, necesite aprobación o falle. Pocket Alert incluye una herramienta MCP create_message y un simple HTTP POST a tu teléfono.

<!-- source: https://pocketalert.app/es/use-cases/ai-agent-alerts -->

Última actualización: 2026-08-11

Un agente LLM de ejecución prolongada no debería necesitar que lo vigiles. Tu teléfono vibra cuando la tarea termina, se queda esperando una aprobación o falla, así que puedes alejarte y confiar en que te avisará.

## Tres pasos para recibir alertas de agentes sin supervisión

1. **Elige MCP o HTTP** — Crea una clave de API, o añade el servidor MCP de Pocket Alert a tu cliente para la vía sin código.
2. **Envía al terminar** — Llama a create_message, o envía un POST con un title y un message desde un callback de LangChain o una herramienta del agente.
3. **Aléjate** — Asigna a cada agente su propia aplicación para los fallos y las aprobaciones. Ahora puedes dejar el escritorio mientras trabaja.

## Pensado para agentes que se ejecutan sin supervisión

Dos caminos, el mismo resultado: el agente llama a una herramienta MCP o hace un POST, y tu teléfono vibra.

- **Servidor MCP integrado** — Los clientes MCP como Claude Code, Claude Desktop y Cursor envían una notificación push llamando a la herramienta create_message.
- **Alternativa con HTTP simple** — ¿No tienes cliente MCP? Un único POST autenticado a la API de mensajes hace el mismo trabajo desde cualquier agente o script.
- **Compatible con hooks Stop** — Lanza la alerta desde un hook Stop para que se ejecute cuando el agente termina, no cuando te acuerdas de mirar.
- **Estado en el mensaje** — Incluye el estado del agente y el texto del resultado en el propio mensaje, para que "necesita aprobación" se entienda con claridad.
- **Canales por agente** — Una aplicación separada por agente o proyecto mantiene el bot de refactorización y la tarea cron en sus propios canales.
- **Entrega en menos de un segundo** — Las notificaciones push llegan en menos de un segundo, así que te enteras al instante cuando una tarea larga termina o se queda bloqueada esperando una entrada.

## Conecta un agente a tu teléfono

### 1. Consigue una clave de API

Crea una clave en la página [Claves de API](https://pocketalert.app/es/account/apikeys). El agente la envía en la cabecera `Token`.

### 2. Envía un POST desde un callback de LangChain (Python)

```
import requests
from langchain.callbacks.base import BaseCallbackHandler

class PocketAlert(BaseCallbackHandler):
    def on_agent_finish(self, finish, **kwargs):
        requests.post(
            "https://api.pocketalert.app/v1/messages",
            headers={"Token": "YOUR_API_KEY"},
            json={"title": "Agent finished", "message": finish.return_values["output"][:200]},
        )

agent.invoke({"input": task}, config={"callbacks": [PocketAlert()]})
```

### 3. O como herramienta de OpenAI que llama el agente (Node)

```
async function notifyHuman({ title, message }) {
  await fetch("https://api.pocketalert.app/v1/messages", {
    method: "POST",
    headers: { Token: "YOUR_API_KEY", "Content-Type": "application/json" },
    body: JSON.stringify({ title, message, level: "high" }),
  });
}
```

Expón `notifyHuman` como función o herramienta para que el agente la llame cuando necesite aprobación o encuentre un error.

### 4. O sin código, con MCP

Si tu cliente habla MCP (Claude Code, Claude Desktop, Cursor), añade el servidor MCP de Pocket Alert y deja que el agente llame a la herramienta `create_message`. No necesitas escribir código.

La [documentación](https://info.pocketalert.app/getting-started.html) explica la segmentación, las aplicaciones y el resto de herramientas MCP.

## Preguntas frecuentes

### ¿Cómo envía un agente una notificación push?

De dos formas. Los clientes MCP como Claude Code, Claude Desktop o Cursor llaman a la herramienta create_message y la notificación push llega a tu teléfono. Cualquier otra cosa hace un único POST HTTP a la API de mensajes. Lo habitual es activarlo con un hook Stop al final de la ejecución.

### ¿Qué es la vía MCP sin código?

Añade el servidor MCP de Pocket Alert a tu cliente y llama a create_message con un title y un message. Sin código, sin curl. También existe create_message_with_attachment por si el agente tiene un archivo o una captura de pantalla que enviar.

### ¿Puedo distinguir los fallos de las finalizaciones de un vistazo?

Asigna a cada agente su propia aplicación para que una "necesita aprobación" de tu bot de refactorización y una "tarea terminada" de la canalización nocturna lleguen por canales separados. Redacta el title para que una solicitud de aprobación o un fallo se entiendan de un vistazo.

### ¿Cómo mantengo separados los agentes de un mismo proyecto?

Asigna a cada agente o proyecto su propia aplicación. Una notificación push de tu bot de refactorización y otra de la canalización de datos nocturna llegan por canales separados, así que sabes qué tarea habló sin leer el cuerpo.

### ¿Es lo bastante rápido como para merecer la pena mirar el teléfono?

La entrega tarda menos de un segundo. Cuando un agente de programación lleva quince minutos trabajando y tú te has ido a por un café, la notificación te llega antes de que vuelvas a sentarte.

### ¿Cómo hago que las finalizaciones sean silenciosas y los fallos, ruidosos?

Envía un nivel con cada mensaje. Un aviso rutinario de "tarea terminada" puede ir en silencioso (sin sonido ni vibración, pero visible en tu historial), mientras que un fallo o una solicitud de aprobación se envía con prioridad alta y llega como notificación push urgente que atraviesa la Concentración del iPhone. La herramienta create_message de MCP acepta el mismo campo level, así que el agente elige el volumen de cada mensaje.
