AiVideoEditor
Inizia gratis
Menù

Revisionato 2026-11-10 · Versione API 2026-11-09 · Leggi Markdown

Configurazione MCP

Un server MCP stdio locale che incapsula gli stessi servizi condivisi della UI e della REST API via /api/v1. L'adattatore invia la tua product key solo all'API AiVideoEditor configurata. Non vengono usate credenziali Supabase o di provider.

Prerequisiti

Questo è un adattatore da checkout sorgente, non un pacchetto pubblicato o una connessione ospitata. Ottieni accesso autorizzato al repository AiVideoEditor, installa Node 22+, ed esegui npm ci alla radice del repository. Crea una product key del workspace in /app/developers con solo gli scope e l'accesso alle destinazioni necessari. Una chiave solo bozze non può pubblicare o programmare. Non incollare mai la chiave in un prompt di chat.

Eseguirlo

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

Il bin è un vero launcher eseguibile (TypeScript + import senza estensione vengono risolti attraverso tsx). Tutta la diagnostica va su stderr; stdout trasporta solo traffico di protocollo. PUBLISHER_API_URL deve essere HTTPS (plain HTTP solo per lo sviluppo su loopback) e non deve portare credenziali, query o frammenti.

Configurazione generica del 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_…"
      }
    }
  }
}

Il launcher richiede Node 22+ e le dipendenze del workspace (tsx, @modelcontextprotocol/sdk). Un transport MCP ospitato con OAuth è lavoro futuro; non dare per scontato che ogni client desktop o ospitato supporti bearer key incollate.

Strumenti

StrumentoLettura/MutazioneNote
list_accountsreadRispetta la allowlist di account della chiave
get_capabilitiesreadFormati, limiti, requisiti di consenso
create_upload_intentmutateRestituisce istruzioni di upload diretto; i byte dei media non passano mai attraverso gli strumenti
finalize_uploadmutateID sessione (+ ricevute delle parti multipart); il server osserva da sé byte/MIME
create_draftmutateSorgente + varianti di destinazione
validate_postreadProblemi strutturati per destinazione
schedule_postmutateUn istante, ≤90 giorni avanti, expectedVersion richiesta
publish_postmutateSemantica 202; non prova di pubblicazione
get_post_statusreadStati per destinazione e link nativi
list_postsreadPaginazione a cursore
cancel_deliverymutateSolo finché sicuramente non preso in carico
retry_deliverymutateSolo fallimenti noti; mai duplicati
get_usagereadNon esiste alcun contatore di post rimanenti

Argomenti richiesti degli strumenti

StrumentoArgomenti richiesti
list_accountsNessuno
get_capabilitiesNessuno
create_upload_intentfilename, declaredMime, declaredBytes
finalize_uploadassetId, sessionId
create_draftcaption, destinations
validate_postpostId
schedule_postpostId, scheduledAt, timezone, expectedVersion
publish_postpostId
get_post_statuspostId
list_postsNessuno
cancel_deliverydeliveryId
retry_deliverydeliveryId
get_usageNessuno

Gli argomenti opzionali includono la paginazione sugli strumenti di lista, idempotencyKey sulle mutazioni, multipart.parts per la finalizzazione multipart, e media delle bozze e varianti di destinazione. Lo schema runtime degli strumenti restituito da tools/list fa autorità per i campi opzionali, le forme annidate e i limiti di validazione.

Gli strumenti che mutano accettano un argomento opzionale idempotencyKey. Quando omesso, il server ne genera uno e lo riporta in ogni risultato: inclusi i fallimenti di transport, dove l'operazione può essere già arrivata all'API (l'errore porta transport_outcome_unknown più la chiave). Gli strumenti non ripetono mai automaticamente le mutazioni; ritenta con la STESSA chiave di idempotenza per evitare di creare un'operazione duplicata.

Esempio di flusso di lavoro dell'agente

  1. list_accounts + get_capabilities → scegli destinazioni valide.
  2. create_upload_intent → carica i byte direttamente → finalize_upload.
  3. create_draft → validate_post → correggi o deseleziona le destinazioni non valide.
  4. publish_post (o schedule_post) → annota gli ID di consegna.
  5. get_post_status (polling limitato o webhook del cliente): tratta le risposte requires_action come istruzioni azionabili, es. consenso TikTok.

Client testati

  • Client TypeScript ufficiale @modelcontextprotocol/sdk, subprocess stdio reale contro il bin documentato (initialize → tools/list → tools/call): testato in packages/mcp/tests/stdio.test.ts, inclusi controlli di stdout pulito e fallimento all'avvio.
  • Client SDK ufficiale su transport in-memory: anch'esso coperto.
  • Client desktop (Claude Desktop, Cursor, ecc.): non ancora testati: configura secondo lo snippet generico sopra e riporta i risultati prima di dichiarare supporto.

Compatibilità dei client

Client o transportStatoConfigurazione
SDK TypeScript ufficiale subprocess stdioCopertura di test automatizzatiLauncher del repository mostrato sopra
SDK ufficiale transport in-memoryCopertura di test automatizzatiSolo harness di test
Claude Desktop / altri client desktopNon verificato manualmenteClient locale con supporto stdio; usa il percorso assoluto del launcher
Connessione ospitata ChatGPTNon fornita da questo adattatoreRichiede un transport ospitato; il JSON stdio locale non è un connettore ospitato
MCP ospitato con OAuthNon implementatoLavoro di prodotto separato

Risoluzione dei problemi

  • Il launcher non riesce a risolvere le dipendenze: esegui npm ci nel checkout sorgente autorizzato e verifica la versione di Node. Non sostituire con un pacchetto pubblico non correlato.
  • Il client non si inizializza mai: usa il percorso assoluto del launcher e ispeziona stderr. Non scrivere output di debug su stdout.
  • 401: verifica che la product key configurata sia attuale; creane una sostituta nella UI se revocata. 403: controlla gli scope e le restrizioni degli account.
  • transport_outcome_unknown: conserva la chiave di idempotenza restituita e ritenta l'operazione identica con quella chiave, mai una nuova.
  • requires_action: consegna le istruzioni fornite a una persona autorizzata; un agente non può fornire il consenso umano TikTok.

Gestione delle credenziali

La product key viene inviata solo alla tua API AiVideoEditor configurata (Authorization: Bearer). Non viene mai inviata ai provider dei modelli o ai social network, non viene mai registrata nei log, e gli URL sono validati così la chiave non può seguire un redirect o sfuggire all'origin configurato.