API de surveillance de disponibilité pour agents, CI/CD et automatisation

Utilisez l’API KEEPitALIVE depuis des scripts, CI/CD, outils internes et agents autonomes pour gérer le travail opérationnel avec des autorisations à portée limitée.

Ce qu’un agent peut gérer

Avec les portées requises et dans les limites du forfait, un agent peut lire la santé et l’historique des moniteurs, créer, mettre à jour, suspendre, reprendre, grouper, partager et supprimer des moniteurs, gérer incidents et commentaires, ainsi que configurer triggers, ressources de notification, pages de statut, intégrations et clés API. L’API est versionnée et documentée avec une spécification OpenAPI.

Utiliser l’API en sécurité

Créez une clé API à portée limitée pour l’automatisation précise au lieu de partager un identifiant personnel étendu. Consultez l’état actuel avant une mutation, respectez validation et limites de débit et utilisez les contrôles d’idempotence documentés lorsqu’ils existent. Exigez une approbation humaine explicite pour les changements destructifs, la rotation des identifiants, la facturation et la suppression du compte.

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

Connecter un agent IA avec MCP

Le serveur MCP de KEEPitALIVE permet à un client MCP de consulter et de gérer votre supervision avec la même clé API à portée limitée. Il se connecte à l’API de production par défaut et utilise le mode write lorsqu’aucun mode n’est configuré. Définissez explicitement le mode read pour commencer avec le moindre privilège ; activez le mode write lorsqu’un agent doit effectuer des modifications opérationnelles réversibles.

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

Choisissez la surface d’outils la plus réduite

read expose uniquement les données de supervision et d’incidents. write est le mode par défaut et ajoute des actions réversibles, comme créer ou modifier des moniteurs, suspendre ou reprendre des vérifications et mettre à jour des incidents. full ajoute des outils de suppression définitive. Les portées de votre clé API restent la limite stricte des autorisations ; le mode MCP ne peut que les restreindre davantage.

Construire une boucle opérationnelle

Une tâche CI peut créer ou mettre à jour un moniteur après le déploiement. Un agent peut enquêter sur des incidents avec l’historique des vérifications, ajouter un commentaire, suspendre une fenêtre de maintenance connue ou configurer un trigger pour notifier un workflow existant. Gardez les actions automatisées limitées, observables et réversibles.

Utiliser le contrat de référence

La référence API explique endpoints et authentification. OpenAPI est la source de vérité lisible par machine pour les outils, et le guide des agents décrit les attentes de sécurité et d’approbation avant qu’un agent ne modifie des ressources de production.

Sur le même thème