Une clé pour l'API REST et le serveur MCP

Démarrage rapide

Chaque requête s'authentifie avec une clé d'API que vous créez dans l'app. Pointez curl, votre CI ou n'importe quel client HTTP vers https://app.relvato.com/api/v1.

# 1 — Confirm your key works and see the endpoints
curl https://app.relvato.com/api/v1 \
  -H "Authorization: Bearer rlv_your_key"

# 2 — List the sites Relvato monitors for you
curl https://app.relvato.com/api/v1/sites \
  -H "Authorization: Bearer rlv_your_key"

# 3 — Read recent runs (optionally scoped to one site)
curl "https://app.relvato.com/api/v1/runs?limit=10" \
  -H "Authorization: Bearer rlv_your_key"

# 4 — One run in detail, then the fix brief Relvato's AI would answer
curl https://app.relvato.com/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer rlv_your_key"
curl https://app.relvato.com/api/v1/runs/RUN_ID/fix-prompt \
  -H "Authorization: Bearer rlv_your_key"

# 5 — Trigger an on-demand scan of a site (full-access key)
curl -X POST https://app.relvato.com/api/v1/sites/SITE_ID/scan \
  -H "Authorization: Bearer rlv_your_key"

Authentification

Envoyez votre clé à chaque requête via Authorization: Bearer rlv_your_key (un en-tête x-api-key fonctionne aussi). Une clé manquante, révoquée ou inconnue renvoie 401.

Créez et révoquez les clés dans API access dans l’app. Les clés commencent par rlv_ et ne s’affichent qu’une fois, à la création. Chaque clé est read-only (tout ce qui lit : sites, santé, performance, exécutions, moniteurs, mises à jour, activité, briefs de correction, réglages d’alertes) ou full access (en plus : ajouter et configurer sites et moniteurs, les lancer, examiner les résultats et appliquer les correctifs proposés). Les clés créées avant l’arrivée des portées ont un accès complet. Traitez-les comme un mot de passe.

Endpoints REST

Chaque endpoint est limité au compte de la clé et renvoie du JSON. URL de base https://app.relvato.com/api/v1.

Exemple : lister les sites

{
  "sites": [
    {
      "id": "st_1a2b3c",
      "name": "style4street",
      "url": "https://style4street.com",
      "connectionType": "wordpress"
    }
  ]
}

Exemple : exécutions récentes

Une exécution en échec puis résolue (référence acceptée ou ignorée) renvoie status: "passed" avec resolved: true.

{
  "runs": [
    {
      "id": "rn_9f8e7d",
      "siteId": "st_1a2b3c",
      "checkId": "ck_4d5e6f",
      "journey": "checkout",
      "checkName": "Checkout",
      "status": "passed",
      "resolved": false,
      "trigger": "schedule",
      "startedAt": "2026-08-31T09:15:00.000Z",
      "durationMs": 4210,
      "error": null,
      "warning": null
    }
  ]
}

Exemple : une exécution en détail

Les constats arrivent dans metrics.items. Une exécution volumineuse est condensée plutôt que coupée : les longues séries deviennent des résumés, et ce qui a été laissé de côté est listé dans metricsTrimmed — le titre et les constats sont toujours conservés.

{
  "runId": "rn_9f8e7d",
  "runUrl": "https://app.relvato.com/runs/rn_9f8e7d",
  "check": { "key": "google-search", "name": "Google Search" },
  "status": "passed",
  "warning": "https://style4street.com/category/topuri/hanorace/ lost 57% of its Google impressions",
  "metrics": {
    "headline": { "tone": "warn", "text": "🔎 1 thing to review on Google Search (as of 2026-09-24)" },
    "items": [
      { "text": "https://style4street.com/category/topuri/hanorace/ lost 57% of its Google impressions — 98 in the 7 days to 2026-09-24, against 226 in an average week before", "tone": "warn" }
    ],
    "search": { "engine": "google", "tiles": [ … ], "dailies": [ { "label": "Impressions per day", "days": 84, "last7Total": 2196, "usualLast7Total": 2583 } ], … }
  },
  "metricsTrimmed": {
    "note": "Large parts were left out to keep this short — the run page has everything.",
    "omitted": ["search.dailies (the per-day values — summarized)", "search.tiles[].weekly (the 8 weekly bars)"]
  }
}

Exemple : le brief de correction d’une exécution

Pour une exécution qui a trouvé un problème, fix-prompt renvoie le brief auquel répond l’IA de Relvato : la stack du site, ce qui a changé juste avant, l’erreur et les constats, et pour Google / Bing Search les preuves qui écartent des causes. Donnez-le à votre propre modèle, ou lisez-le vous-même.

{
  "runId": "rn_9f8e7d",
  "runUrl": "https://app.relvato.com/runs/rn_9f8e7d",
  "hasIssue": true,
  "prompt": "# Help me understand a Google Search change on my WordPress site\n\nYou are a senior SEO specialist. … ## Evidence Relvato already has …"
}

Limites de débit

Les requêtes sont limitées par minute et par compte, REST et MCP confondus. Votre forfait fixe le plafond :

Chaque réponse porte X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. Au-delà de la limite, 429 est renvoyé avec un en-tête Retry-After.

Codes de statut

Serveur MCP (pour agents IA)

Relvato est aussi un serveur Model Context Protocol distant avec 57 outils : un agent comme Claude peut faire dans une conversation ce que vous feriez dans le tableau de bord — ajouter un site et vous guider pour le connecter, choisir et configurer ses moniteurs (jusqu’aux pages que vérifie le moniteur visuel), les lancer, expliquer les résultats et, avec votre accord, valider un changement voulu ou vous donner le lien pour appliquer dans WordPress le correctif que propose une exécution. Vous le connectez en vous identifiant sur Relvato ou avec une clé d'API ; dans les deux cas, il partage la limite de l'API REST. Valider les changements d’intégrité des fichiers, de scripts et de DNS, qui reçoit les alertes, les secrets et toute suppression restent dans le tableau de bord.

Référencé dans le GitHub MCP Registry ↗.

Identifiez-vous, sans clé. Ajoutez l'endpoint comme connecteur dans Claude (claude.ai, Desktop ou Claude Code), ChatGPT ou VS Code. Le client ouvre la connexion à Relvato ; vous l'autorisez à lire vos sites et résultats et à faire des changements : ajouter des sites et des moniteurs, modifier les plannings et lancer des scans. La connexion fonctionne dans les clients compatibles avec les Client ID Metadata Documents ; Cursor et la passerelle MCP de Docker ne le sont pas encore et utilisent une clé d'API.

Si vous appartenez à une organisation, vous choisissez l'un de ses espaces de travail à la connexion ; votre espace personnel n'y est pas proposé. Pour connecter votre espace personnel, utilisez une clé d'API.

Ce que vous pouvez demander à un agent connecté à Relvato :

• « Pourquoi le paiement de ma boutique a-t-il échoué cette nuit, et comment le corriger ? »
• « Mets en place la surveillance de example.com et dis-moi ce que je dois faire pour le connecter. »
• « Qui est alerté quand un moniteur Security détecte un problème, et sur quels canaux ? »
• « Ajoute mes pages de tarifs et de blog au moniteur visuel, puis lance-le. »
• « Quelle est la vitesse de ma boutique pour les vrais visiteurs, et qu’est-ce qui la ralentit ? »

Endpoint https://app.relvato.com/api/mcp

Dans un client qui lit un mcp.json, l'endpoint suffit — le client vous demande de vous identifier la première fois :

{
  "mcpServers": {
    "relvato": {
      "type": "http",
      "url": "https://app.relvato.com/api/mcp"
    }
  }
}

Pour utiliser plutôt une clé d'API (un script, un client sans connexion, ou votre espace personnel si vous êtes dans une organisation), ajoutez l'en-tête. Une clé en lecture seule ne reçoit que les outils de lecture :

{
  "mcpServers": {
    "relvato": {
      "type": "http",
      "url": "https://app.relvato.com/api/mcp",
      "headers": {
        "Authorization": "Bearer rlv_your_key"
      }
    }
  }
}

Plugin Claude Code

Dans Claude Code, le plugin Relvato ajoute le serveur et trois skills pour travailler depuis le dépôt de votre site. Installez-le depuis notre marketplace, puis lancez /mcp et identifiez-vous :

claude plugin marketplace add Relvato/relvato-mcp
claude plugin install relvato@relvato

• /relvato:setup ajoute le site que ce dépôt déploie, prouve qu'il vous appartient (il peut ajouter la balise meta de vérification à votre code), choisit des moniteurs et lance les premières exécutions.
• /relvato:check-after-deploy lance les moniteurs du site après un déploiement, indique combien de temps ils prennent, et signale ce qui est passé et ce qui a cassé.
• /relvato:fix-failure lit une exécution en échec, trouve la cause dans votre code, applique la plus petite correction avec votre accord, puis relance ce moniteur.

Perplexity

Avec une offre Perplexity Pro, Max ou Enterprise, ajoutez Relvato comme connecteur personnalisé : Settings → Connectors → + Custom connector → Remote. Indiquez le point de terminaison ci-dessus comme URL du serveur MCP et Streamable HTTP comme transport.

Pour Authentication, choisissez API key et collez une clé API Relvato (créez-la dans API access, dans l'application ; une clé en lecture seule n'obtient que les outils de lecture). L'option OAuth de Perplexity ne fonctionne pas encore avec la connexion Relvato : elle suppose que le serveur enregistre Perplexity automatiquement, ce que Relvato ne propose pas.

Webhooks

L’API répond quand vous l’interrogez. Pour être prévenu dès qu’un moniteur détecte un problème, ajoutez un webhook : Relvato envoie un événement JSON signé à votre URL pour chaque alerte (à partir de Pro). Configurer un webhook →

Questions fréquentes