Vérifié le 2026-11-10 · Version API 2026-11-09 · Lire le Markdown
Configuration de MCP
Un serveur MCP stdio local qui encapsule les mêmes services partagés que l'UI et
l'API REST via /api/v1. L'adaptateur n'envoie votre clé de produit qu'à l'API AiVideoEditor configurée.
Aucun identifiant Supabase ou fournisseur n'est utilisé.
Prérequis
Cet adaptateur provient d'un checkout source, pas d'un paquet publié ni d'une connexion hébergée.
Obtenez un accès autorisé au dépôt AiVideoEditor, installez Node 22+ et exécutez
npm ci à la racine du dépôt. Créez une clé de produit d'espace de travail dans
/app/developers avec uniquement les scopes et l'accès aux destinations nécessaires. Une clé
limitée aux brouillons ne peut pas publier ni planifier. Ne collez jamais la clé dans un prompt de chat.
Exécution
export PUBLISHER_API_URL=https://app.example.com # HTTPS; http://localhost is allowed for dev
export PUBLISHER_API_KEY=pk_v1_… # create in /app/developers
node packages/mcp/bin/publisher-mcp.mjs # or: npm start --workspace packages/mcp
Le bin est un vrai lanceur exécutable (le TypeScript et les imports sans extension sont
résolus via tsx). Tous les diagnostics vont vers stderr ; stdout ne porte que
le trafic de protocole. PUBLISHER_API_URL doit être en HTTPS (HTTP simple uniquement pour
le développement en loopback) et ne doit pas contenir d'identifiants, de requêtes ni de fragments.
Configuration générique du client
{
"mcpServers": {
"autoposted": {
"command": "node",
"args": ["/absolute/path/to/packages/mcp/bin/publisher-mcp.mjs"],
"env": {
"PUBLISHER_API_URL": "https://app.example.com",
"PUBLISHER_API_KEY": "pk_v1_…"
}
}
}
}
Le lanceur requiert Node 22+ et les dépendances de l'espace de travail (tsx,
@modelcontextprotocol/sdk). Un transport MCP hébergé avec OAuth est un travail futur ;
ne présumez pas que chaque client desktop ou hébergé prend en charge les clés bearer collées.
Outils
| Outil | Lecture/Mutation | Notes |
|---|---|---|
list_accounts | lecture | Respecte la liste d'autorisation de comptes de la clé |
get_capabilities | lecture | Formats, limites, exigences de consentement |
create_upload_intent | mutation | Retourne des instructions de téléversement direct ; les octets des médias ne transitent jamais par les outils |
finalize_upload | mutation | ID de session (+ reçus de parties multipart) ; le serveur observe lui-même les octets/MIME |
create_draft | mutation | Source + variantes de destination |
validate_post | lecture | Problèmes structurés par destination |
schedule_post | mutation | Un seul instant, ≤90 jours à l'avance, expectedVersion requis |
publish_post | mutation | Sémantique 202 ; pas une preuve de publication |
get_post_status | lecture | États par destination et liens natifs |
list_posts | lecture | Pagination par curseur |
cancel_delivery | mutation | Uniquement tant que la livraison reste en sécurité sans être revendiquée |
retry_delivery | mutation | Uniquement les échecs connus ; jamais de doublons |
get_usage | lecture | Aucun compteur de publications restantes n'existe |
Arguments requis des outils
| Outil | Arguments requis |
|---|---|
list_accounts | Aucun |
get_capabilities | Aucun |
create_upload_intent | filename, declaredMime, declaredBytes |
finalize_upload | assetId, sessionId |
create_draft | caption, destinations |
validate_post | postId |
schedule_post | postId, scheduledAt, timezone, expectedVersion |
publish_post | postId |
get_post_status | postId |
list_posts | Aucun |
cancel_delivery | deliveryId |
retry_delivery | deliveryId |
get_usage | Aucun |
Les arguments optionnels incluent la pagination sur les outils de liste, idempotencyKey sur les mutations,
multipart.parts pour la finalisation multipart, ainsi que les médias de brouillon et les variantes de
destination. Le schéma d'outils d'exécution retourné par tools/list fait foi pour
les champs optionnels, les formes imbriquées et les limites de validation.
Les outils de mutation acceptent un argument optionnel idempotencyKey. Lorsqu'il est omis, le
serveur en génère un et le renvoie en écho dans chaque résultat : y compris les
échecs de transport, où l'opération a peut-être déjà atteint l'API (l'erreur
porte transport_outcome_unknown plus la clé). Les outils ne retentent jamais
automatiquement les mutations ; retentez avec la MÊME clé d'idempotence pour éviter de créer une
opération en double.
Exemple de flux de travail d'agent
list_accounts+get_capabilities→ choisissez des destinations valides.create_upload_intent→ téléversez les octets directement →finalize_upload.create_draft→validate_post→ corrigez ou désélectionnez les destinations invalides.publish_post(ouschedule_post) → notez les IDs de livraison.get_post_status(polling borné ou webhooks client) : traitez les réponsesrequires_actioncomme des instructions exploitables, p. ex. le consentement TikTok.
Clients testés
- Client TypeScript officiel
@modelcontextprotocol/sdk, stdio de sous-processus réel contre le bin documenté (initialize → tools/list → tools/call) : testé danspackages/mcp/tests/stdio.test.ts, y compris les vérifications de stdout propre et d'échec de démarrage. - Client SDK officiel sur transport en mémoire : également couvert.
- Clients desktop (Claude Desktop, Cursor, etc.) : pas encore testés : configurez selon l'extrait générique ci-dessus et signalez les résultats avant de revendiquer la prise en charge.
Compatibilité des clients
| Client ou transport | Statut | Configuration |
|---|---|---|
| Sous-processus stdio du SDK TypeScript officiel | Couverture de tests automatisés | Lanceur du dépôt montré ci-dessus |
| Transport en mémoire du SDK officiel | Couverture de tests automatisés | Harnais de test uniquement |
| Claude Desktop / autres clients desktop | Non vérifié manuellement | Client local compatible stdio ; utilisez le chemin absolu du lanceur |
| Connexion hébergée ChatGPT | Non fournie par cet adaptateur | Requiert un transport hébergé ; le JSON stdio local n'est pas un connecteur hébergé |
| MCP hébergé avec OAuth | Non implémenté | Travail produit séparé |
Dépannage
- Le lanceur ne peut pas résoudre les dépendances : exécutez
npm cidans le checkout source autorisé et vérifiez la version de Node. Ne substituez pas un paquet public sans rapport. - Le client ne s'initialise jamais : utilisez le chemin absolu du lanceur et inspectez stderr. N'écrivez pas de sortie de débogage sur stdout.
401: vérifiez que la clé de produit configurée est actuelle ; créez un remplacement dans l'UI si elle est révoquée.403: vérifiez les scopes et les restrictions de compte.transport_outcome_unknown: conservez la clé d'idempotence retournée et retentez l'opération identique avec cette clé, jamais une nouvelle.requires_action: remettez les instructions fournies à une personne autorisée ; un agent ne peut pas fournir le consentement humain TikTok.
Gestion des identifiants
La clé de produit est envoyée uniquement à votre API AiVideoEditor configurée
(Authorization: Bearer). Elle n'est jamais envoyée aux fournisseurs de modèles ni aux réseaux
sociaux, jamais journalisée, et les URL sont validées pour que la clé ne puisse pas suivre une
redirection ni s'échapper de l'origine configurée.