# Serveur MCP

Pocket Alert parle le [Model Context Protocol](https://modelcontextprotocol.io) : un agent IA peut donc vous envoyer des notifications push, lire votre historique de messages et consulter les statistiques de livraison via de simples appels d’outils.

En pratique : un agent lance une longue tâche, se termine à un moment imprévisible et vous envoie une notification sur votre téléphone, au lieu que vous ayez à surveiller le terminal.

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

## Connexion

L’authentification se fait par jeton porteur (bearer token) : votre clé API, issue depuis [Clés API](https://pocketalert.app/account/apikeys), envoyée dans l’en-tête `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"
      }
    }
  }
}
```

Redémarrez ensuite le client, puis demandez-lui de lister ses outils : `pocketalert` doit apparaître.

## Outils disponibles

| Outil | Ce qu’il fait |
|------|--------------|
| `list_applications` | Lister vos applications |
| `get_application` | Récupérer une application par TID |
| `list_devices` | Lister les appareils enregistrés |
| `get_device` | Récupérer un appareil par TID |
| `list_messages` | Lire l’historique des messages |
| `get_message` | Récupérer un message par TID |
| `create_message` | Envoyer une notification push |
| `create_message_with_attachment` | Envoyer une notification push avec une image jointe |
| `delete_message` | Supprimer un message |
| `get_message_stats` | Statistiques de livraison |

`create_message` accepte les mêmes paramètres `level` et `actions` que l’API REST : un agent peut donc déclencher une [alerte critique](https://info.pocketalert.app/features/priority-levels.md) ou joindre des [boutons d’action](https://info.pocketalert.app/features/action-buttons.md) de validation à ce qu’il envoie.

## Cas d’usage utiles

**Tâches longues.** Migration, entraînement de modèle, import par lots : l’agent vous prévient à la fin, au lieu que vous interrogiez un terminal.

**Validations avec intervention humaine.** Donnez à l’agent `create_message` et qu’il envoie deux boutons d’action `http` avant toute opération irréversible. Vous validez depuis l’écran verrouillé, et l’agent poursuit.

**Consultation de son propre historique.** Un agent capable d’appeler `list_messages` peut répondre à la question « qu’est-ce qui a cassé cette nuit ? » sans que vous ayez à transmettre quoi que ce soit.

> **Warning: Limitez la clé**
>
> Un serveur MCP est une capacité que vous confiez à un modèle. Créez une clé API dédiée pour lui plutôt que de réutiliser celle de vos scripts de production : ainsi, révoquer l’accès de l’agent n’impacte rien d’autre.

## Voir aussi

- [Niveaux de priorité](https://info.pocketalert.app/features/priority-levels.md) : ce que `level` change sur l’alerte livrée
- [Boutons d’action](https://info.pocketalert.app/features/action-buttons.md) : workflows de validation à partir d’une notification
- [Créer un message](https://info.pocketalert.app/api/messages/create.md) : l’équivalent REST de `create_message`
