API de monitorização de disponibilidade para agentes, CI/CD e automação

Use a API do KEEPitALIVE em scripts, CI/CD, ferramentas internas e agentes autónomos para gerir trabalho operacional com permissões de âmbito definido.

O que um agente pode gerir

Com os âmbitos necessários e dentro do plano da conta, um agente pode ler a saúde e o histórico dos monitores; criar, atualizar, pausar, retomar, agrupar, partilhar e eliminar monitores; gerir incidentes e comentários; configurar triggers, recursos de notificação, páginas de estado, embeds e chaves de API. A API é versionada e documentada com uma especificação OpenAPI.

Use a API em segurança

Crie uma chave de API com âmbito definido para a automação específica, em vez de partilhar uma credencial pessoal abrangente. Obtenha o estado atual antes de uma alteração, respeite a validação e os limites de taxa e use os controlos de idempotência documentados quando disponíveis. Exija aprovação humana explícita para alterações destrutivas, rotação de credenciais, faturação e eliminação de conta.

curl -H "Authorization: Bearer $KEEPITALIVE_API_KEY" \
  https://keepitalive.dev/api/v1/monitors

Ligue um agente de IA com MCP

O servidor MCP do KEEPitALIVE permite que um cliente MCP consulte e gira a sua monitorização com a mesma chave de API com âmbito definido. Liga-se à API de produção por predefinição e usa o modo write quando nenhum modo é configurado. Defina explicitamente o modo read para começar com o menor privilégio; ative o modo write quando quiser que um agente faça alterações operacionais reversíveis.

{
  "mcpServers": {
    "keepitalive": {
      "command": "npx",
      "args": ["-y", "@keepitalive/mcp"],
      "env": {
        "KEEPITALIVE_API_KEY": "kia_live_...",
        "KEEPITALIVE_MCP_MODE": "read"
      }
    }
  }
}

Escolha a menor superfície de ferramentas

read expõe apenas dados de monitorização e incidentes. write é o modo predefinido e acrescenta ações reversíveis, como criar ou editar monitores, pausar ou retomar verificações e atualizar incidentes. full acrescenta ferramentas de eliminação permanente. Os âmbitos da chave de API continuam a ser o limite rígido de permissões; o modo MCP apenas os pode restringir ainda mais.

Crie um ciclo operacional

Uma tarefa de CI pode criar ou atualizar um monitor após o deploy. Um agente pode investigar incidentes através do histórico de verificações, adicionar um comentário, pausar uma janela de manutenção conhecida ou configurar um trigger para notificar um fluxo existente. Mantenha as ações automatizadas restritas, observáveis e reversíveis.

Use o contrato autorizado

A referência da API explica endpoints e autenticação. O OpenAPI é a fonte de verdade legível por máquina para ferramentas, e o guia para agentes cobre expectativas de aprovação e segurança antes de um agente alterar recursos de produção.

Relacionado