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
| Tool | Lesen/Mutieren | Hinweise |
|---|---|---|
list_accounts | read | Beachtet die Konto-Zulassungsliste des Keys |
get_capabilities | read | Formate, Limits, Zustimmungsanforderungen |
create_upload_intent | mutate | Liefert direkte Upload-Anweisungen; Medienbytes fließen nie durch Tools |
finalize_upload | mutate | Sitzungs-ID (+ Multipart-Teilbelege); der Server beobachtet Bytes/MIME selbst |
create_draft | mutate | Quelle + Ziel-Varianten |
validate_post | read | Strukturierte Probleme pro Ziel |
schedule_post | mutate | Ein Zeitpunkt, ≤90 Tage voraus, expectedVersion erforderlich |
publish_post | mutate | 202-Semantik; kein Nachweis der Veröffentlichung |
get_post_status | read | Zustände pro Ziel und native Links |
list_posts | read | Cursor-Paginierung |
cancel_delivery | mutate | Nur solange sicher nicht in Anspruch genommen |
retry_delivery | mutate | Nur bekannte Fehler; nie Duplikate |
get_usage | read | Kein Rest-Posting-Zähler existiert |
Erforderliche Tool-Argumente
| Tool | Erforderliche Argumente |
|---|---|
list_accounts | Keine |
get_capabilities | Keine |
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 | Keine |
cancel_delivery | deliveryId |
retry_delivery | deliveryId |
get_usage | Keine |
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
list_accounts+get_capabilities→ wähle gültige Ziele.create_upload_intent→ Bytes direkt hochladen →finalize_upload.create_draft→validate_post→ behebe oder deaktiviere ungültige Ziele.publish_post(oderschedule_post) → notiere die Zustellungs-IDs.get_post_status(begrenztes Polling oder Kunden-Webhooks): behandlerequires_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 inpackages/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 Transport | Status | Einrichtung |
|---|---|---|
| Offizielle TypeScript-SDK-Subprozess-stdio | Automatisierte Testabdeckung | Repository-Launcher oben gezeigt |
| Offizieller SDK-In-Memory-Transport | Automatisierte Testabdeckung | Nur Test-Harness |
| Claude Desktop / andere Desktop-Clients | Nicht manuell verifiziert | Lokaler stdio-fähiger Client; verwende absoluten Launcher-Pfad |
| ChatGPT gehostete Verbindung | Von diesem Adapter nicht bereitgestellt | Erfordert einen gehosteten Transport; lokales stdio-JSON ist kein gehosteter Connector |
| Gehostetes MCP mit OAuth | Nicht implementiert | Separate Produktarbeit |
Fehlerbehebung
- Launcher kann Abhängigkeiten nicht auflösen: führe
npm ciim 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.