# Servidor MCP

Pocket Alert habla el [Model Context Protocol](https://modelcontextprotocol.io), así que un agente de IA puede enviarte notificaciones push, leer tu historial de mensajes y consultar estadísticas de entrega como llamadas a herramientas normales.

La versión práctica: un agente inicia una tarea larga, termina en un momento impredecible y te avisa en el teléfono en lugar de esperar a que mires la terminal.

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

## Conexión

La autenticación es con un token bearer: tu clave de API desde [Claves de API](https://pocketalert.app/account/apikeys), enviada como `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"
      }
    }
  }
}
```

Después, reinicia el cliente y pídele que liste sus herramientas: `pocketalert` debería aparecer.

## Herramientas disponibles

| Herramienta | Qué hace |
|------|--------------|
| `list_applications` | Lista tus aplicaciones |
| `get_application` | Obtiene una aplicación por TID |
| `list_devices` | Lista los dispositivos registrados |
| `get_device` | Obtiene un dispositivo por TID |
| `list_messages` | Lee el historial de mensajes |
| `get_message` | Obtiene un mensaje por TID |
| `create_message` | Envía una notificación push |
| `create_message_with_attachment` | Envía una push con una imagen adjunta |
| `delete_message` | Elimina un mensaje |
| `get_message_stats` | Estadísticas de entrega |

`create_message` acepta los mismos parámetros `level` y `actions` que la API REST, así que un agente puede elevar una [alerta crítica](https://info.pocketalert.app/features/priority-levels.md) o añadir [botones de aprobación](https://info.pocketalert.app/features/action-buttons.md) a lo que envía.

## Merece la pena configurarlo

**Tareas de larga duración.** Migración, entrenamiento, importación por lotes: el agente te avisa cuando termina, en lugar de que tú consultes una terminal.

**Aprobaciones con una persona en el proceso.** Dale al agente `create_message` y que envíe dos botones de acción `http` antes de hacer algo irreversible. Apruebas desde la pantalla de bloqueo y el agente continúa.

**Leer su propio historial.** Un agente que puede llamar a `list_messages` puede responder "¿qué se rompió durante la noche?" sin que tengas que reenviarle nada.

> **Warning: Limita el alcance de la clave**
>
> Un servidor MCP es una capacidad que le entregas a un modelo. Emite una clave de API dedicada para él en lugar de reutilizar la que usan tus scripts de producción; así, revocar el acceso del agente no te afecta en nada más.

## Relacionado

- [Niveles de prioridad](https://info.pocketalert.app/features/priority-levels.md): qué hace `level` con la alerta entregada
- [Botones de acción](https://info.pocketalert.app/features/action-buttons.md): flujos de aprobación desde una notificación
- [Crear mensaje](https://info.pocketalert.app/api/messages/create.md): el equivalente REST de `create_message`
