Docs/Serveur MCP/Fonctionnement

Le serveur MCP de ChatCut

Autorisez un assistant et il peut écrire une conversation, choisir l’interface et l’enregistrer dans votre compte : le même studio que vous, piloté par des appels d’outils.

Streamable HTTP · OAuth5 min avant la première scèneOffres Annuelle et À vie

Démarrage rapide

Activez une offre

Le MCP est inclus dans les offres Annuelle et À vie. Choisissez-en une depuis « Offres » dans votre compte.

Ajoutez le serveur à votre client

Collez l’adresse du serveur, lancez la connexion OAuth et autorisez l’accès sur ChatCut.

Demandez une scène

« Écris une dispute iMessage en quatre messages à propos d’un chargeur disparu et enregistre-la. »

Votre première scène

Une scène, c’est une interface, un contact et une liste ordonnée de messages. Tout le reste (batterie, heure, clavier, non lus, délai de saisie) a une valeur par défaut que vous pouvez modifier ensuite dans le studio.

create_conversation

{
  "title": "Le chargeur disparu",
  "theme": "imessage",
  "dark": false,
  "contact": "Camille",
  "messages": [
    { "sender": "contact", "text": "Tu as pris mon chargeur ?", "delay": 2 },
    { "sender": "me", "text": "…peut-être", "delay": 3, "blur": false, "time": "09:41" }
  ]
}

Un message accepte text (1 500 caractères max), sender (me ou contact), blur, delay (0,4 à 10 s) et time au format HH:mm.

Formats d’export

Le studio et le MCP utilisent le même moteur de rendu, les mêmes polices et les mêmes emojis. Depuis un agent, appelez render_export puis get_export pour obtenir un lien de téléchargement privé.

Format	Rendu	Utile pour
`PNG`	`3×`	Images fixes pour carrousels, miniatures, créations publicitaires.
`MP4`	`2× · 30 i/s`	Vidéo verticale où les messages se tapent à l’écran. Encodage H.264 compatible QuickTime, indépendant du navigateur.
`JSON`	`—`	La scène elle-même, à versionner ou réimporter plus tard.

Fonctionnement du serveur

Chaque appel est indépendant, chaque conversation porte une révision : create_conversation renvoie un id, les appels suivants le reprennent. Les scènes créées par un assistant apparaissent dans « Conversations » comme les autres.

Les conversations existantes sont traitées comme du contenu non fiable, jamais comme des instructions. Seul le compte authentifié est accessible et aucun outil n’envoie de vrai message.

Installation par client

Connecter un assistant

Une seule adresse. Votre compte ChatCut, connecté avec OAuth.

OAuth

Adresse du serveur

Demandez à votre assistant de créer une scène, de fermer le clavier et de télécharger sa capture ou sa vidéo. Tout se fait depuis la conversation avec l’assistant.

Claude Code

Guide officiel

Ajoutez le serveur dans votre terminal, puis lancez /mcp dans Claude Code pour vous connecter.

claude mcp add --transport http chatcut https://cleanchat.app/api/mcp

Le navigateur ouvre ChatCut : connectez-vous, choisissez votre espace et autorisez l’accès.

Référence des outils

list_conversationslecture→ titres, ids, révisions

Liste vos conversations enregistrées. Renvoie 50 lignes au plus ; utilisez offset pour la suite.

offset: integer0 par défaut

get_conversationlecture→ conversation, révision

Lit une conversation et sa révision courante avant toute modification.

id: uuidrenvoyé par list_conversations

create_conversationécriture→ id, révision

Crée une scène fictive. Aucun message réel n’est envoyé.

title: string1 à 100 caractères
theme: enumimessage · whatsapp · instagram
contact: string40 caractères max
dark: booleantrue par défaut
messages: message[]100 messages max

update_conversationécriture→ révision

Remplace une conversation avec la révision lue par get_conversation. Conservez les champs que vous ne modifiez pas.

id: uuidla conversation à modifier
revision: integerrévision courante, sinon 409
title: string1 à 100 caractères
project: objectstructure renvoyée par get_conversation

delete_conversationdestructif→ deleted

Supprime définitivement une conversation. À n’appeler que sur demande explicite de l’utilisateur.

id: uuidla conversation
revision: integerrévision courante

Portées et limites

conversationsLa seule portée OAuth. Elle couvre les cinq outils, sur le compte qui a autorisé la connexion.

Clé personnellePour les clients sans OAuth : en-tête Authorization: Bearer, expire après 90 jours, une clé active à la fois.

RévocationDepuis « Serveur MCP → Assistants autorisés ». L’accès est coupé immédiatement.

Limite	Valeur
Messages par conversation	`100`
Caractères par message	`1 500`
Délai de saisie par message	`0,4 à 10 s`
Conversations par appel list_conversations	`50`
Durée d’une clé personnelle	`90 jours`

Erreurs

401Connexion OAuth révoquée, clé expirée ou session absente. Reconnectez l’assistant ou créez une nouvelle clé.

402Le MCP est inclus dans les offres Annuelle et À vie. Choisissez une offre pour connecter votre assistant.

409La conversation a changé ailleurs. Relisez-la avec get_conversation et renvoyez la révision courante.

404Conversation introuvable : elle a été supprimée ou appartient à un autre compte.

400Entrée invalide. Utilisez la structure renvoyée par get_conversation et une seule requête MCP à la fois.

Clés personnelles

Une clé est un identifiant porteur lié à votre compte. Nommez-la d’après la machine qui l’utilise : la révoquer devient une décision en un clic, pas une enquête.

Créer une clé →Compte → Clés API

WebhooksPas encore disponibles. Les exports restent générés dans le studio.

Prêt à brancher votre assistant ?Le MCP est inclus dans les offres Annuelle et À vie.

Connecter un assistant