AiVideoEditor
Commencez gratuitement
Menu

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

OutilLecture/MutationNotes
list_accountslectureRespecte la liste d'autorisation de comptes de la clé
get_capabilitieslectureFormats, limites, exigences de consentement
create_upload_intentmutationRetourne des instructions de téléversement direct ; les octets des médias ne transitent jamais par les outils
finalize_uploadmutationID de session (+ reçus de parties multipart) ; le serveur observe lui-même les octets/MIME
create_draftmutationSource + variantes de destination
validate_postlectureProblèmes structurés par destination
schedule_postmutationUn seul instant, ≤90 jours à l'avance, expectedVersion requis
publish_postmutationSémantique 202 ; pas une preuve de publication
get_post_statuslectureÉtats par destination et liens natifs
list_postslecturePagination par curseur
cancel_deliverymutationUniquement tant que la livraison reste en sécurité sans être revendiquée
retry_deliverymutationUniquement les échecs connus ; jamais de doublons
get_usagelectureAucun compteur de publications restantes n'existe

Arguments requis des outils

OutilArguments requis
list_accountsAucun
get_capabilitiesAucun
create_upload_intentfilename, declaredMime, declaredBytes
finalize_uploadassetId, sessionId
create_draftcaption, destinations
validate_postpostId
schedule_postpostId, scheduledAt, timezone, expectedVersion
publish_postpostId
get_post_statuspostId
list_postsAucun
cancel_deliverydeliveryId
retry_deliverydeliveryId
get_usageAucun

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

  1. list_accounts + get_capabilities → choisissez des destinations valides.
  2. create_upload_intent → téléversez les octets directement → finalize_upload.
  3. create_draft → validate_post → corrigez ou désélectionnez les destinations invalides.
  4. publish_post (ou schedule_post) → notez les IDs de livraison.
  5. get_post_status (polling borné ou webhooks client) : traitez les réponses requires_action comme 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é dans packages/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 transportStatutConfiguration
Sous-processus stdio du SDK TypeScript officielCouverture de tests automatisésLanceur du dépôt montré ci-dessus
Transport en mémoire du SDK officielCouverture de tests automatisésHarnais de test uniquement
Claude Desktop / autres clients desktopNon vérifié manuellementClient local compatible stdio ; utilisez le chemin absolu du lanceur
Connexion hébergée ChatGPTNon fournie par cet adaptateurRequiert un transport hébergé ; le JSON stdio local n'est pas un connecteur hébergé
MCP hébergé avec OAuthNon implémentéTravail produit séparé

Dépannage

  • Le lanceur ne peut pas résoudre les dépendances : exécutez npm ci dans 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.