# Server MCP

Pocket Alert supporta il [Model Context Protocol](https://modelcontextprotocol.io), quindi un agente AI può inviarti notifiche push, leggere la cronologia dei messaggi e controllare le statistiche di consegna come normali tool call.

La versione pratica: un agente avvia un job lungo, termina in un momento imprevedibile e ti avvisa sul telefono invece di aspettare che tu controlli il terminale.

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

## Connessione

L'autenticazione avviene tramite bearer token: la tua chiave API da [Chiavi API](https://pocketalert.app/account/apikeys), inviata come `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"
      }
    }
  }
}
```

Riavvia poi il client e chiedigli di elencare i suoi tool: `pocketalert` dovrebbe comparire.

## Tool disponibili

| Tool | Cosa fa |
|------|--------------|
| `list_applications` | Elenca le tue applicazioni |
| `get_application` | Recupera un'applicazione tramite TID |
| `list_devices` | Elenca i dispositivi registrati |
| `get_device` | Recupera un dispositivo tramite TID |
| `list_messages` | Legge la cronologia dei messaggi |
| `get_message` | Recupera un singolo messaggio tramite TID |
| `create_message` | Invia una notifica push |
| `create_message_with_attachment` | Invia una push con un'immagine allegata |
| `delete_message` | Elimina un messaggio |
| `get_message_stats` | Statistiche di consegna |

`create_message` accetta gli stessi parametri `level` e `actions` dell'API REST, quindi un agente può impostare un [avviso critico](https://info.pocketalert.app/features/priority-levels.md) o allegare [pulsanti di approvazione](https://info.pocketalert.app/features/action-buttons.md) a ciò che invia.

## Utili da configurare

**Job di lunga durata.** Migrazione, training, import batch: l'agente ti avvisa quando termina, invece di farti controllare un terminale.

**Approvazioni con intervento umano.** Dai all'agente `create_message` e fagli inviare due pulsanti di azione `http` prima di eseguire qualcosa di irreversibile. Approvi dalla schermata di blocco e l'agente prosegue.

**Lettura della propria cronologia.** Un agente che può chiamare `list_messages` può rispondere a "cosa si è rotto durante la notte?" senza che tu debba inoltrare nulla.

> **Warning: Limita la chiave**
>
> Un server MCP è una capacità che affidi a un modello. Emetti una chiave API dedicata per questo scopo invece di riusare quella che usano i tuoi script di produzione: così, revocare l'accesso all'agente non comporta conseguenze su altro.

## Correlati

- [Livelli di priorità](https://info.pocketalert.app/features/priority-levels.md) — cosa fa `level` sull'avviso consegnato
- [Pulsanti di azione](https://info.pocketalert.app/features/action-buttons.md) — flussi di approvazione da una notifica
- [Crea messaggio](https://info.pocketalert.app/api/messages/create.md) — l'equivalente REST di `create_message`
