Se connecter via MCP

Pilotez le préchauffage de cache CacheBoost depuis un agent IA — Claude Desktop, Claude Code ou Cursor — grâce au serveur MCP CacheBoost.

Le serveur MCP CacheBoost expose le préchauffage de cache et le suivi des runs sous forme d'outils Model Context Protocol. Un agent connecté au serveur peut préchauffer vos URLs critiques après un déploiement et vous prévenir quand le cache est chaud — en langage naturel, sans écrire d'appels API à la main.

Endpoint

Le serveur est un unique endpoint distant Streamable HTTP :

https://api.cache-boost.com/mcp

Il tourne sur le même hôte que l'API REST. Le protocole est basé sur des sessions : votre client MCP effectue le handshake initialize, reçoit un en-tête Mcp-Session-Id, puis le rejoue sur chaque appel d'outil suivant. Les clients conformes gèrent cela automatiquement.

Authentification

Le serveur MCP utilise votre clé API CacheBoost existante — il n'y a pas de credential MCP distinct. Créez une clé dans l'application via Profil → Clés API, accordez-lui les scopes des outils que vous comptez utiliser (voir le tableau ci-dessous), puis envoyez-la dans l'en-tête X-API-Key :

X-API-Key: cb_live_VOTRE_CLÉ

Authorization: Bearer cb_live_VOTRE_CLÉ est aussi accepté (et prioritaire si les deux sont présents), mais X-API-Key fonctionne avec tous les clients MCP, y compris le connecteur personnalisé Claude.

Une clé absente ou invalide est rejetée avec un 401. Les scopes de la clé et sa restriction de sites optionnelle s'appliquent exactement comme sur l'API REST : un outil appelé sans le scope requis renvoie une erreur d'outil explicite (jamais un succès silencieux), et un site hors de l'accès de la clé est rapporté comme introuvable. Consultez Authentification pour créer des clés et gérer les scopes.

Ajouter le serveur à votre client

CacheBoost est référencé dans le registre MCP officiel sous com.cache-boost/cacheboost. Si votre client sait parcourir le registre, c'est le chemin court ; tout ce qui suit en est l'équivalent manuel.

Depuis l'annuaire de serveurs de votre client

Cherchez CacheBoost dans l'annuaire MCP de votre client, ajoutez-le, et collez votre clé cb_live_… quand il demande X-API-Key. L'endpoint et le transport viennent de la fiche — il n'y a rien d'autre à configurer.

Si votre client n'a pas d'annuaire, déclarez CacheBoost à la main comme serveur MCP distant (Streamable HTTP) avec un en-tête X-API-Key.

Claude Code (CLI)

claude mcp add --transport http cacheboost https://api.cache-boost.com/mcp \
  --header "X-API-Key: cb_live_VOTRE_CLÉ"

Claude Desktop / Cursor

Ajoutez une entrée à la configuration des serveurs MCP :

{
  "mcpServers": {
    "cacheboost": {
      "type": "http",
      "url": "https://api.cache-boost.com/mcp",
      "headers": {
        "X-API-Key": "cb_live_VOTRE_CLÉ"
      }
    }
  }
}

Claude (connecteur personnalisé)

Dans Claude, ouvrez Paramètres → Connecteurs → Ajouter un connecteur personnalisé et saisissez https://api.cache-boost.com/mcp. Puis :

• Authentification : choisissez Aucune connexion (CacheBoost utilise une clé API, pas OAuth).
• En-têtes de requête : ajoutez X-API-Key avec votre clé cb_live_VOTRE_CLÉ. N'utilisez pas Authorization ici : le connecteur ne l'envoie pas.

Outils disponibles

Chaque outil reflète le scope de son équivalent REST. N'accordez à la clé API que les scopes des outils dont vous avez besoin.

warm_site conserve les mêmes règles métier que l'API REST : les URLs doivent être same-origin avec le site, au maximum 5000 URLs par appel, les doublons sont supprimés, le quota est pré-vérifié, et un 409 est renvoyé si un run est déjà en cours pour le site.

Exemple : préchauffer les URLs critiques après un déploiement

Une fois le serveur connecté, demandez à votre agent en langage naturel, par exemple :

Préchauffe les URLs critiques de mon site après ce déploiement et dis-moi quand le cache est chaud.

L'agent appelle les outils en séquence :

1. warm_site(site_id, urls) → renvoie { run_id, url_count, status: "pending" }.
2. get_run(run_id) (ou list_warm_runs(site_id)) pollé jusqu'à ce que status soit done ou failed, puis rapporte les résultats de cache-hit.