# Servidor MCP

O Pocket Alert fala o [Model Context Protocol](https://modelcontextprotocol.io), então um agente de IA pode enviar notificações push para você, ler o histórico de mensagens e consultar estatísticas de entrega como chamadas de ferramenta comuns.

Na prática: um agente inicia um trabalho longo, termina em um momento imprevisível e avisa seu celular em vez de você ficar checando o terminal.

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

## Conectando

A autenticação é feita com um token bearer: sua chave de API, obtida em [Chaves 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"
      }
    }
  }
}
```

Depois, reinicie o cliente e peça para listar as ferramentas dele. A `pocketalert` deve aparecer na lista.

## Ferramentas disponíveis

| Ferramenta | O que faz |
|------|--------------|
| `list_applications` | Lista seus aplicativos |
| `get_application` | Busca um aplicativo pelo TID |
| `list_devices` | Lista os dispositivos registrados |
| `get_device` | Busca um dispositivo pelo TID |
| `list_messages` | Lê o histórico de mensagens |
| `get_message` | Busca uma única mensagem pelo TID |
| `create_message` | Envia uma notificação push |
| `create_message_with_attachment` | Envia um push com uma imagem anexada |
| `delete_message` | Exclui uma mensagem |
| `get_message_stats` | Estatísticas de entrega |

`create_message` aceita os mesmos parâmetros `level` e `actions` da API REST, então um agente pode elevar um [alerta crítico](https://info.pocketalert.app/features/priority-levels.md) ou anexar [botões de ação](https://info.pocketalert.app/features/action-buttons.md) de aprovação ao que envia.

## Vale a pena configurar

**Trabalhos longos.** Migração, treinamento de modelo, importação em lote: o agente avisa você quando termina, em vez de você ficar consultando um terminal.

**Aprovações com humano no circuito.** Dê ao agente `create_message` e faça ele enviar dois botões de ação `http` antes de fazer qualquer coisa irreversível. Você aprova pela tela de bloqueio e o agente segue.

**Lendo o próprio histórico.** Um agente que pode chamar `list_messages` consegue responder "o que quebrou durante a noite?" sem que você precise encaminhar nada.

> **Warning: Limite o escopo da chave**
>
> Um servidor MCP é uma capacidade que você entrega a um modelo. Emita uma chave de API dedicada para ele, em vez de reutilizar a que seus scripts de produção usam. Assim, revogar o acesso do agente não afeta mais nada.

## Relacionados

- [Níveis de prioridade](https://info.pocketalert.app/features/priority-levels.md): o que `level` faz com o alerta entregue
- [Botões de ação](https://info.pocketalert.app/features/action-buttons.md): fluxos de aprovação a partir de uma notificação
- [Criar mensagem](https://info.pocketalert.app/api/messages/create.md): o equivalente REST de `create_message`
