Le serveur MCP

Le serveur MCP de ClipHeat relie un assistant compatible avec le protocole MCP — Claude, Cursor, un agent maison — à l’API. Il tourne sur votre machine et appelle ClipHeat avec votre clé : il n’a aucun droit que votre clé n’a pas déjà.

Les quatre outils

Outil	Ce qu’il fait
`clipheat_estimer`	Ce que coûterait une vidéo (YouTube, Twitch ou Kick), sans rien lancer. Accepte une portion, en secondes.
`clipheat_generer`	Lance une génération à partir d’un lien, avec les réglages par défaut. Débite des crédits.
`clipheat_suivre`	L’étape, la progression, puis les clips prêts et leur note.
`clipheat_recuperer_un_clip`	Une adresse de téléchargement pour un clip, valable une heure.

Ces quatre outils couvrent la boucle entière : estimer, lancer, suivre, récupérer. Le reste — éditer, habiller, publier — se fait dans l’application.

Le brancher

Il vous faut Python 3 et une clé d’API. Dans la configuration de votre client MCP :

{
  "mcpServers": {
    "clipheat": {
      "command": "python",
      "args": ["-m", "clipheat.mcp_server"],
      "env": {
        "CLIPHEAT_URL": "https://clipheat.app",
        "CLIPHEAT_CLE": "ch_votre_cle"
      }
    }
  }
}

La même configuration, prête à copier avec l’adresse de votre compte, est dans l’application, sur l’écran API & MCP.

Pour le lancer à la main :

CLIPHEAT_URL=https://clipheat.app \
CLIPHEAT_CLE=ch_votre_cle \
  python -m clipheat.mcp_server

Le serveur communique avec votre client par son entrée et sa sortie standard : n’écrivez rien d’autre sur sa sortie, une seule ligne en trop interrompt l’échange.

Ce qu’un assistant peut dépenser

clipheat_generer est le seul outil qui coûte des crédits. Sa description demande à l’assistant d’appeler clipheat_estimer d’abord — mais c’est une consigne, pas une barrière. Deux limites s’appliquent quoi que fasse l’assistant :

votre solde : sans crédits suffisants, le lancement est refusé ;
la limite de débit de POST /api/process : une vingtaine de lancements par minute.

Pour garder la main, créez une clé dédiée à votre assistant et révoquez-la quand vous ne vous en servez plus — voir Sécurité des clés.

Ce qu’il ne fait pas

Il n’accède pas à vos fichiers. Il ne fait que quatre appels à l’API.
Il ne supprime rien et ne publie rien.