# Recevez une notification push dès que l'agent a fini.

> Recevez une notification push quand un agent IA ou une exécution LLM se termine, attend votre validation ou échoue. Pocket Alert fournit un outil MCP create_message et un simple POST HTTP vers votre téléphone.

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

Dernière mise à jour : 2026-08-11

Un agent LLM de longue durée ne devrait pas exiger que vous le surveilliez. Votre téléphone vibre quand la tâche est terminée, bloquée en attente d'une approbation ou en panne, pour que vous puissiez vous éloigner en sachant qu'il vous préviendra.

## Trois étapes pour des alertes d'agents sans intervention

1. **Choisissez MCP ou HTTP** — Créez une clé API, ou ajoutez le serveur MCP Pocket Alert à votre client pour la voie sans code.
2. **Envoyez à la fin** — Appelez create_message, ou envoyez un POST avec un titre et un message depuis un callback LangChain ou un outil d'agent.
3. **Éloignez-vous** — Attribuez à chaque agent sa propre application pour les échecs et les approbations. Vous pouvez maintenant quitter votre bureau pendant qu'il travaille.

## Conçu pour les agents qui tournent sans surveillance

Deux chemins, même résultat : l'agent appelle un outil MCP ou effectue un seul POST, et votre téléphone vibre.

- **Serveur MCP intégré** — Les clients MCP comme Claude Code, Claude Desktop et Cursor envoient une notification push en appelant l'outil create_message.
- **Repli en HTTP simple** — Pas de client MCP ? Un seul POST authentifié vers l'API des messages fait le même travail depuis n'importe quel agent ou script.
- **Prêt pour les hooks Stop** — Déclenchez l'alerte depuis un hook Stop pour qu'elle parte à la fin de l'agent, et non au moment où vous pensez à vérifier.
- **Statut dans le message** — Incluez l'état de l'agent et le résultat directement dans le message, pour que « approbation requise » se lise clairement.
- **Canaux par agent** — Une application distincte par agent ou projet garde le bot de refactorisation et la tâche cron sur leurs propres canaux.
- **Distribution en moins d'une seconde** — Les notifications arrivent en moins d'une seconde, vous êtes donc prévenu dès qu'une longue tâche se termine ou se bloque en attente d'une saisie.

## Reliez un agent à votre téléphone

### 1. Obtenez une clé API

Créez une clé sur la page [Clés API](https://pocketalert.app/fr/account/apikeys). L'agent l'envoie dans l'en-tête `Token`.

### 2. Envoyer un POST depuis un callback 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. Ou sous forme d'outil OpenAI que l'agent appelle (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" }),
  });
}
```

Exposez `notifyHuman` comme fonction ou outil afin que l'agent l'appelle lorsqu'une approbation est nécessaire ou qu'une erreur survient.

### 4. Ou passez sans code avec MCP

Si votre client parle MCP (Claude Code, Claude Desktop, Cursor), ajoutez le serveur MCP Pocket Alert et laissez l'agent appeler l'outil `create_message`. Aucun code de votre côté.

La [documentation](https://info.pocketalert.app/getting-started.html) couvre le ciblage, les applications et le reste des outils MCP.

## FAQ

### Comment un agent m'envoie-t-il une notification push ?

De deux manières. Les clients MCP comme Claude Code, Claude Desktop ou Cursor appellent l'outil create_message, et la notification arrive sur votre téléphone. Tout le reste effectue un seul POST HTTP vers l'API des messages. Un hook Stop en fin d'exécution est le déclencheur habituel.

### Qu'est-ce que la méthode MCP sans code ?

Ajoutez le serveur MCP Pocket Alert à votre client et appelez create_message avec un titre et un message. Pas de code, pas de curl. Il existe aussi create_message_with_attachment si l'agent doit envoyer un fichier ou une capture d'écran.

### Puis-je distinguer les échecs des achèvements d'un coup d'œil ?

Attribuez à chaque agent sa propre application, pour qu'une demande d'approbation de votre bot de refactorisation et une notification « tâche terminée » du pipeline nocturne arrivent sur des canaux distincts. Formulez le titre de façon que une demande d'approbation ou un échec se comprenne d'un coup d'œil.

### Comment séparer les agents d'un même projet ?

Attribuez à chaque agent ou projet sa propre application. Une notification de votre bot de refactorisation et une autre du pipeline de données nocturne arrivent sur des canaux séparés, si bien que vous savez quelle tâche a parlé sans lire le corps du message.

### Est-ce assez rapide pour valoir la peine de regarder le téléphone ?

La distribution se fait en moins d'une seconde. Quand un agent de code a tourné pendant quinze minutes et que vous êtes allé vous faire un café, la notification vous parvient avant que vous ne vous rasseyiez.

### Comment garder les achèvements discrets et les échecs bien audibles ?

Envoyez un niveau avec chaque message. Une notification routinière « tâche terminée » peut être silencieuse (sans son ni vibration, mais conservée dans l'historique), tandis qu'un échec ou une demande d'approbation est envoyé en niveau élevé et arrive sous forme de notification push urgente qui passe outre la Concentration de l'iPhone. L'outil MCP create_message accepte le même champ de niveau, de sorte que l'agent choisit l'intensité pour chaque message.
