# MCP Server

Pocket Alert mendukung [Model Context Protocol](https://modelcontextprotocol.io), sehingga agen AI dapat mengirim push notification kepada Anda, membaca riwayat pesan, dan memeriksa statistik pengiriman sebagai pemanggilan tool biasa.

Versi praktisnya: agen memulai pekerjaan panjang, selesai pada waktu yang tidak bisa diprediksi, lalu mengirim notifikasi ke ponsel Anda alih-alih Anda harus terus memeriksa terminal.

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

## Menghubungkan

Autentikasi menggunakan bearer token — kunci API Anda dari [Kunci API](https://pocketalert.app/account/apikeys), dikirim sebagai `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"
      }
    }
  }
}
```

Setelah itu, mulai ulang klien, lalu minta klien menampilkan daftar tool-nya — `pocketalert` seharusnya muncul.

## Tool yang tersedia

| Tool | Fungsi |
|------|--------|
| `list_applications` | Menampilkan daftar aplikasi Anda |
| `get_application` | Mengambil satu aplikasi berdasarkan TID |
| `list_devices` | Menampilkan daftar perangkat yang terdaftar |
| `get_device` | Mengambil satu perangkat berdasarkan TID |
| `list_messages` | Membaca riwayat pesan |
| `get_message` | Mengambil satu pesan berdasarkan TID |
| `create_message` | Mengirim push notification |
| `create_message_with_attachment` | Mengirim push dengan gambar terlampir |
| `delete_message` | Menghapus pesan |
| `get_message_stats` | Statistik pengiriman |

`create_message` menerima parameter `level` dan `actions` yang sama seperti REST API, sehingga agen dapat menaikkan [peringatan kritis](https://info.pocketalert.app/features/priority-levels.md) atau melampirkan [tombol persetujuan](https://info.pocketalert.app/features/action-buttons.md) pada notifikasi yang dikirimnya.

## Layak dicoba

**Pekerjaan berjalan lama.** Migrasi, proses training, impor batch — agen memberi tahu Anda saat pekerjaan selesai, tanpa Anda harus terus memantau terminal.

**Persetujuan dengan keterlibatan manusia.** Berikan agen akses `create_message` dan minta agen mengirim dua tombol aksi `http` sebelum melakukan tindakan yang tidak bisa dibatalkan. Anda menyetujui dari layar kunci; agen melanjutkan.

**Membaca riwayatnya sendiri.** Agen yang dapat memanggil `list_messages` bisa menjawab "apa yang rusak semalam?" tanpa Anda perlu meneruskan apa pun.

> **Warning: Batasi cakupan kunci**
>
> Server MCP adalah kemampuan yang Anda berikan kepada sebuah model. Terbitkan kunci API khusus untuknya, jangan memakai ulang kunci yang dipegang skrip produksi Anda — dengan begitu, mencabut akses agen tidak akan memengaruhi hal lain.

## Terkait

- [Tingkat prioritas](https://info.pocketalert.app/features/priority-levels.md) — apa yang dilakukan `level` pada peringatan yang terkirim
- [Tombol aksi](https://info.pocketalert.app/features/action-buttons.md) — alur persetujuan dari sebuah notifikasi
- [Buat Pesan](https://info.pocketalert.app/api/messages/create.md) — padanan REST dari `create_message`
