AiVideoEditor
Kostenlos starten
Menü

Geprüft am 2026-11-10 · API-Version 2026-11-09 · Markdown lesen

MCP-Einrichtung

Ein lokaler stdio-MCP-Server, der dieselben gemeinsamen Dienste wie die UI und REST-API über /api/v1 umschließt. Der Adapter sendet deinen Produktkey nur an die konfigurierte AiVideoEditor-API. Es werden keine Supabase- oder Provider-Zugangsdaten verwendet.

Voraussetzungen

Dies ist ein Quellcode-Checkout-Adapter, kein veröffentlichtes Paket oder eine gehostete Verbindung. Beschaffe autorisierten Zugriff auf das AiVideoEditor-Repository, installiere Node 22+ und führe npm ci im Repository-Stammverzeichnis aus. Erstelle einen Arbeitsbereichs-Produktkey in /app/developers mit nur den benötigten Scopes und dem benötigten Zielzugriff. Ein Draft-only- Key kann nicht veröffentlichen oder planen. Füge den Key niemals in einen Chat-Prompt ein.

Ausführen

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

Der Binär-Launcher ist ein echter ausführbarer Starter (TypeScript + endungslose Imports werden über tsx aufgelöst). Alle Diagnostik geht an stderr; stdout trägt nur Protokollverkehr. PUBLISHER_API_URL muss HTTPS sein (pures HTTP nur für Loopback-Entwicklung) und darf keine Zugangsdaten, Queries oder Fragmente tragen.

Generische Client-Konfiguration

{
  "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_…"
      }
    }
  }
}

Der Launcher erfordert Node 22+ und die Arbeitsbereichs-Abhängigkeiten (tsx, @modelcontextprotocol/sdk). Ein gehosteter MCP-Transport mit OAuth ist zukünftige Arbeit; setze nicht voraus, dass jeder Desktop- oder gehostete Client eingefügte Bearer-Keys unterstützt.

Tools

ToolLesen/MutierenHinweise
list_accountsreadBeachtet die Konto-Zulassungsliste des Keys
get_capabilitiesreadFormate, Limits, Zustimmungsanforderungen
create_upload_intentmutateLiefert direkte Upload-Anweisungen; Medienbytes fließen nie durch Tools
finalize_uploadmutateSitzungs-ID (+ Multipart-Teilbelege); der Server beobachtet Bytes/MIME selbst
create_draftmutateQuelle + Ziel-Varianten
validate_postreadStrukturierte Probleme pro Ziel
schedule_postmutateEin Zeitpunkt, ≤90 Tage voraus, expectedVersion erforderlich
publish_postmutate202-Semantik; kein Nachweis der Veröffentlichung
get_post_statusreadZustände pro Ziel und native Links
list_postsreadCursor-Paginierung
cancel_deliverymutateNur solange sicher nicht in Anspruch genommen
retry_deliverymutateNur bekannte Fehler; nie Duplikate
get_usagereadKein Rest-Posting-Zähler existiert

Erforderliche Tool-Argumente

ToolErforderliche Argumente
list_accountsKeine
get_capabilitiesKeine
create_upload_intentfilename, declaredMime, declaredBytes
finalize_uploadassetId, sessionId
create_draftcaption, destinations
validate_postpostId
schedule_postpostId, scheduledAt, timezone, expectedVersion
publish_postpostId
get_post_statuspostId
list_postsKeine
cancel_deliverydeliveryId
retry_deliverydeliveryId
get_usageKeine

Optionale Argumente umfassen Paginierung bei List-Tools, idempotencyKey bei Mutationen, multipart.parts für die Multipart-Finalisierung sowie Entwurfsmedien und Ziel- Varianten. Das Laufzeit-Tool-Schema, das tools/list zurückgibt, ist maßgeblich für optionale Felder, verschachtelte Formen und Validierungs-Limits.

Mutierende Tools akzeptieren ein optionales idempotencyKey-Argument. Wenn es weggelassen wird, erzeugt der Server eines und gibt es in jedem Ergebnis zurück: auch bei Transport- fehlern, bei denen die Operation die API möglicherweise bereits erreicht hat (der Fehler trägt transport_outcome_unknown plus den Key). Tools wiederholen Mutationen nie automatisch; wiederhole mit DEMSELBEN Idempotency-Key, um eine doppelte Operation zu vermeiden.

Agent-Workflow-Beispiel

  1. list_accounts + get_capabilities → wähle gültige Ziele.
  2. create_upload_intent → Bytes direkt hochladen → finalize_upload.
  3. create_draft → validate_post → behebe oder deaktiviere ungültige Ziele.
  4. publish_post (oder schedule_post) → notiere die Zustellungs-IDs.
  5. get_post_status (begrenztes Polling oder Kunden-Webhooks): behandle requires_action-Antworten als umsetzbare Anweisungen, z. B. TikTok-Zustimmung.

Getestete Clients

  • Offizieller @modelcontextprotocol/sdk-TypeScript-Client, echter Subprozess- stdio gegen den dokumentierten Binär-Launcher (initialize → tools/list → tools/call): getestet in packages/mcp/tests/stdio.test.ts, einschließlich Prüfungen auf sauberes stdout und Startfehler.
  • Offizieller SDK-Client über In-Memory-Transport: ebenfalls abgedeckt.
  • Desktop-Clients (Claude Desktop, Cursor usw.): noch nicht getestet: konfiguriere gemäß dem generischen Snippet oben und berichte Ergebnisse, bevor du Unterstützung behauptest.

Client-Kompatibilität

Client oder TransportStatusEinrichtung
Offizielle TypeScript-SDK-Subprozess-stdioAutomatisierte TestabdeckungRepository-Launcher oben gezeigt
Offizieller SDK-In-Memory-TransportAutomatisierte TestabdeckungNur Test-Harness
Claude Desktop / andere Desktop-ClientsNicht manuell verifiziertLokaler stdio-fähiger Client; verwende absoluten Launcher-Pfad
ChatGPT gehostete VerbindungVon diesem Adapter nicht bereitgestelltErfordert einen gehosteten Transport; lokales stdio-JSON ist kein gehosteter Connector
Gehostetes MCP mit OAuthNicht implementiertSeparate Produktarbeit

Fehlerbehebung

  • Launcher kann Abhängigkeiten nicht auflösen: führe npm ci im autorisierten Quellcode- Checkout aus und prüfe die Node-Version. Ersetze es nicht durch ein beliebiges anderes öffentliches Paket.
  • Client initialisiert nie: verwende den absoluten Launcher-Pfad und untersuche stderr. Schreibe keine Debugging-Ausgabe an stdout.
  • 401: verifiziere, dass der konfigurierte Produktkey aktuell ist; erstelle einen Ersatz in der UI, wenn er widerrufen wurde. 403: prüfe Scopes und Konto-Einschränkungen.
  • transport_outcome_unknown: bewahre den zurückgegebenen Idempotency-Key auf und wiederhole die identische Operation mit diesem Key, nie mit einem neuen.
  • requires_action: übergib die bereitgestellten Anweisungen an eine autorisierte Person; ein Agent kann die menschliche TikTok-Zustimmung nicht bereitstellen.

Umgang mit Zugangsdaten

Der Produktkey wird nur an deine konfigurierte AiVideoEditor-API gesendet (Authorization: Bearer). Er wird nie an Modell-Provider oder soziale Netzwerke gesendet, nie geloggt, und URLs werden validiert, sodass der Key keiner Weiterleitung folgen oder die konfigurierte Origin verlassen kann.