# MCP-Server

Pocket Alert unterstützt das [Model Context Protocol](https://modelcontextprotocol.io). Damit kann ein KI-Agent dir Push-Benachrichtigungen schicken, deinen Nachrichtenverlauf lesen und Zustellstatistiken abrufen, und zwar als ganz normale Tool-Aufrufe.

In der Praxis sieht das so aus: Ein Agent startet einen langen Job, ist irgendwann fertig, und statt dass du ständig ins Terminal schaust, meldet er sich auf deinem Handy.

```
https://mcp.pocketalert.app/mcp
```

## Verbinden

Die Authentifizierung läuft über einen Bearer-Token. Das ist dein API-Schlüssel aus [API-Schlüssel](https://pocketalert.app/account/apikeys), gesendet als `Authorization: Bearer <token>`.

**Claude Desktop / Claude Code**

```json
{
  "mcpServers": {
    "pocketalert": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.pocketalert.app/mcp",
        "--header",
        "Authorization: Bearer ${POCKETALERT_API_TOKEN}"
      ],
      "env": {
        "POCKETALERT_API_TOKEN": "your-api-key"
      }
    }
  }
}
```

**Native HTTP transport**

```json
{
  "mcpServers": {
    "pocketalert": {
      "type": "http",
      "url": "https://mcp.pocketalert.app/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}
```

Starte den Client danach neu und lass dir die Tools auflisten. `pocketalert` sollte dort auftauchen.

## Verfügbare Tools

| Tool | Was es macht |
|------|--------------|
| `list_applications` | Listet deine Anwendungen auf |
| `get_application` | Ruft eine Anwendung per TID ab |
| `list_devices` | Listet registrierte Geräte auf |
| `get_device` | Ruft ein Gerät per TID ab |
| `list_messages` | Liest den Nachrichtenverlauf |
| `get_message` | Ruft eine einzelne Nachricht per TID ab |
| `create_message` | Sendet eine Push-Benachrichtigung |
| `create_message_with_attachment` | Sendet eine Push-Nachricht mit angehängtem Bild |
| `delete_message` | Löscht eine Nachricht |
| `get_message_stats` | Zustellstatistiken |

`create_message` akzeptiert dieselben Parameter `level` und `actions` wie die REST-API. Ein Agent kann also einen [kritischen Alarm](https://info.pocketalert.app/features/priority-levels.md) auslösen oder [Genehmigungs-Buttons](https://info.pocketalert.app/features/action-buttons.md) an das senden, was er verschickt.

## Lohnt sich einzurichten

**Lange laufende Jobs.** Migration, Trainingslauf, Batch-Import: Der Agent meldet sich, sobald er fertig ist, und du musst nicht ständig ein Terminal beobachten.

**Genehmigungen mit Mensch im Loop.** Gib dem Agenten `create_message` und lass ihn vor jeder nicht rückgängig zu machenden Aktion zwei `http`-Aktionsbuttons senden. Du genehmigst direkt vom Sperrbildschirm aus, und der Agent macht weiter.

**Eigenen Verlauf auswerten.** Ein Agent, der `list_messages` aufrufen kann, beantwortet Fragen wie „Was ist über Nacht kaputtgegangen?“, ohne dass du etwas weiterleiten musst.

> **Warning: Schlüssel eingrenzen**
>
> Ein MCP-Server ist eine Fähigkeit, die du einem Modell übergibst. Erstelle dafür einen eigenen API-Schlüssel, statt den zu verwenden, den deine Produktionsskripte nutzen. So kostet dich das Entziehen des Agenten-Zugriffs nichts anderes.

## Verwandte Seiten

- [Prioritätsstufen](https://info.pocketalert.app/features/priority-levels.md): was `level` an der zugestellten Benachrichtigung ändert
- [Aktionsbuttons](https://info.pocketalert.app/features/action-buttons.md): Genehmigungsabläufe direkt aus einer Benachrichtigung
- [Nachricht erstellen](https://info.pocketalert.app/api/messages/create.md): das REST-Gegenstück zu `create_message`
