# Erhalte eine Push-Benachrichtigung wenn der Agent fertig ist.

> Bekomme eine Push-Benachrichtigung, wenn ein KI-Agent oder LLM-Lauf fertig ist, eine Freigabe braucht oder fehlschlägt. Pocket Alert bietet ein MCP-Tool create_message und einen einfachen HTTP-POST direkt aufs Smartphone.

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

Zuletzt aktualisiert: 2026-08-11

Ein langlaufender LLM-Agent sollte dich nicht beim Zusehen brauchen. Dein Handy vibriert, wenn der Job fertig ist, auf eine Freigabe wartet oder kaputt ist, sodass du weggehen und darauf vertrauen kannst, dass er dich erreicht.

## Drei Schritte zu Agenten-Benachrichtigungen ohne Aufsicht

1. **MCP oder HTTP wählen** — Erstelle einen API-Schlüssel oder füge den Pocket-Alert-MCP-Server deinem Client für den Weg ohne Code hinzu.
2. **Beim Abschluss senden** — Rufe create_message auf oder sende Titel und Nachricht per POST aus einem LangChain-Callback oder Agenten-Tool.
3. **Weggehen** — Gib jedem Agenten eine eigene Anwendung für Fehler und Freigaben. Jetzt kannst du den Schreibtisch verlassen, während er arbeitet.

## Gebaut für Agenten, die ohne Aufsicht laufen

Zwei Wege, dasselbe Ergebnis: Der Agent ruft ein MCP-Tool auf oder sendet einen POST, und dein Handy vibriert.

- **MCP-Server integriert** — MCP-Clients wie Claude Code, Claude Desktop und Cursor senden eine Push-Benachrichtigung, indem sie das Tool create_message aufrufen.
- **Einfacher HTTP-Fallback** — Kein MCP-Client? Ein authentifizierter POST an die Messages-API erledigt dasselbe von jedem Agenten oder Skript aus.
- **Bereit für Stop-Hooks** — Löse die Benachrichtigung über einen Stop-Hook aus, damit sie beim Ende des Agenten kommt und nicht erst, wenn du daran denkst nachzusehen.
- **Status in der Nachricht** — Schicke Status und Ergebnistext direkt in der Nachricht mit, damit "Freigabe nötig" sofort klar ist.
- **Kanäle pro Agent** — Eine eigene Anwendung pro Agent oder Projekt hält den Refactoring-Bot und den Cronjob auf getrennten Kanälen.
- **Zustellung in unter einer Sekunde** — Push-Benachrichtigungen kommen in unter einer Sekunde an, sodass du sofort erfährst, wenn ein langer Job endet oder auf eine Eingabe wartet.

## Verbinde einen Agenten mit deinem Handy

### 1. Hol dir einen API-Schlüssel

Erstelle einen Schlüssel auf der Seite [API-Schlüssel](https://pocketalert.app/de/account/apikeys). Der Agent sendet ihn im Header `Token`.

### 2. POST aus einem LangChain-Callback (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. Oder als OpenAI-Tool, das der Agent aufruft (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" }),
  });
}
```

Stelle `notifyHuman` als Funktion/Tool bereit, damit der Agent sie aufruft, wenn er eine Freigabe braucht oder auf einen Fehler stößt.

### 4. Oder ganz ohne Code über MCP

Unterstützt dein Client MCP (Claude Code, Claude Desktop, Cursor), füge den Pocket-Alert-MCP-Server hinzu und lass den Agenten das Tool `create_message` aufrufen. Auf deiner Seite ist kein Code nötig.

Die [Dokumentation](https://info.pocketalert.app/getting-started.html) beschreibt Zielgruppen, Anwendungen und die übrigen MCP-Tools.

## FAQ

### Wie schickt mir ein Agent eine Push-Benachrichtigung?

Auf zwei Wegen. MCP-Clients wie Claude Code, Claude Desktop oder Cursor rufen das Tool create_message auf, und die Push-Benachrichtigung landet auf deinem Handy. Alles andere sendet einen einzelnen HTTP-POST an die Messages-API. Ein Stop-Hook am Ende eines Laufs ist der übliche Auslöser.

### Wie funktioniert der Weg ohne Code über MCP?

Füge den Pocket-Alert-MCP-Server zu deinem Client hinzu und rufe create_message mit einem Titel und einer Nachricht auf. Kein Code, kein curl. Außerdem gibt es create_message_with_attachment, falls der Agent eine Datei oder einen Screenshot schicken soll.

### Kann ich Fehler und Erfolgsmeldungen auf einen Blick unterscheiden?

Gib jedem Agenten eine eigene Anwendung, damit eine "Freigabe nötig"-Meldung von deinem Refactoring-Bot und eine "Aufgabe erledigt"-Meldung von der nächtlichen Pipeline auf getrennten Kanälen ankommen. Formuliere den Titel so, dass eine Freigabeanfrage oder ein Fehler auf einen Blick klar erkennbar ist.

### Wie halte ich Agenten aus verschiedenen Projekten auseinander?

Gib jedem Agenten oder Projekt eine eigene Anwendung. Eine Push-Benachrichtigung vom Refactoring-Bot und eine von der nächtlichen Datenpipeline kommen auf getrennten Kanälen an, sodass du ohne den Text zu lesen erkennst, welcher Job sich gemeldet hat.

### Ist es schnell genug, um aufs Handy zu schauen?

Die Zustellung dauert unter einer Sekunde. Wenn ein Coding-Agent fünfzehn Minuten gearbeitet hat und du dir in der Zwischenzeit einen Kaffee holst, ist die Push-Nachricht bei dir, bevor du dich wieder hinsetzt.

### Wie halte ich Erfolgsmeldungen leise und Fehler laut?

Gib jeder Nachricht eine Stufe mit. Eine routinemäßige "Aufgabe erledigt"-Meldung kann auf lautlos laufen, also ohne Ton und Vibration, aber im Verlauf sichtbar bleiben. Ein Fehler oder eine Freigabeanfrage bekommt dagegen die Stufe hoch und kommt als zeitkritische Push-Benachrichtigung, die den iPhone-Fokus durchbricht. Das MCP-Tool create_message nimmt dasselbe Stufenfeld entgegen, sodass der Agent die Lautstärke pro Nachricht wählt.
