API et serveur MCP

Dans Mon compte, section « Clés d'API et MCP », donnez un nom à la clé et choisissez ses droits: lecture seule, ou lecture et création. La clé commence par esk_ et ne s'affiche qu'une fois. Elle se transmet dans l'en-tête Authorization:

Authorization: Bearer esk_...

Avec Claude Code:

claude mcp add --transport http en-service https://a.en-service.fr/mcp \
  --header "Authorization: Bearer esk_..."

Avec Cursor (fichier .cursor/mcp.json) ou tout client qui accepte une adresse et des en-têtes:

{
  "mcpServers": {
    "en-service": {
      "url": "https://a.en-service.fr/mcp",
      "headers": { "Authorization": "Bearer esk_..." }
    }
  }
}

Quatre outils sont exposés:

• list_monitors: vos moniteurs et leur état (en service, hors service, avertissement, en attente, en pause), filtrable par état.
• get_monitor: le détail d'un moniteur, sa disponibilité sur 30 jours, sa latence et ses 10 derniers incidents.
• list_check_types: les types de vérification ouverts à votre offre et la forme de cible attendue.
• create_monitor: crée un moniteur. Pour un cron, le type heartbeat renvoie l'URL que la tâche doit appeler.

Lister les moniteurs hors service:

curl -s -H "Authorization: Bearer $ES_KEY" "https://a.en-service.fr/v1/monitors?status=down"

Surveiller un site avec un mot témoin, après un déploiement:

curl -s -H "Authorization: Bearer $ES_KEY" -H "Content-Type: application/json" \
  -d '{"type":"http","target":"https://exemple.fr/","keyword":"Bienvenue"}' \
  https://a.en-service.fr/v1/monitors

Champs de création: type (défaut http), target, name (défaut: l'hôte), interval_s (relevé au minimum de l'offre), region, et selon le type keyword, dns_type, dns_expect, min_days, confirm, confirm_regions. Les mêmes règles que le formulaire du site s'appliquent: une cible invalide ou un quota atteint renvoie 422 avec un message en clair.

Codes de réponse: 200 et 201 succès, 401 clé absente ou inconnue, 403 clé en lecture seule ou compte non confirmé, 404 moniteur d'un autre compte ou inexistant, 405 modification ou suppression, 422 refus de validation, 429 limite de débit.