Vai al contenuto

Server MCP ​

Pocket Alert supporta il Model Context Protocol, 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, inviata come Authorization: Bearer <token>.

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"
      }
    }
  }
}
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 ​

ToolCosa fa
list_applicationsElenca le tue applicazioni
get_applicationRecupera un'applicazione tramite TID
list_devicesElenca i dispositivi registrati
get_deviceRecupera un dispositivo tramite TID
list_messagesLegge la cronologia dei messaggi
get_messageRecupera un singolo messaggio tramite TID
create_messageInvia una notifica push
create_message_with_attachmentInvia una push con un'immagine allegata
delete_messageElimina un messaggio
get_message_statsStatistiche di consegna

create_message accetta gli stessi parametri level e actions dell'API REST, quindi un agente può impostare un avviso critico o allegare pulsanti di approvazione 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.

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 ​

Documentazione di Pocket Alert