AiVideoEditor
Empieza gratis
Menú

Revisada el 2026-11-10 · Versión de API 2026-11-09 · Leer Markdown

Configuración de MCP

Un servidor MCP stdio local que envuelve los mismos servicios compartidos que la UI y la API REST vía /api/v1. El adaptador envía tu clave de producto solo a la API de AiVideoEditor configurada. No se usan credenciales de Supabase ni de proveedores.

Requisitos previos

Este es un adaptador de checkout de código fuente, no un paquete publicado ni una conexión alojada. Obtén acceso autorizado al repositorio de AiVideoEditor, instala Node 22+ y ejecuta npm ci en la raíz del repositorio. Crea una clave de producto del espacio de trabajo en /app/developers solo con los scopes y el acceso a destinos necesarios. Una clave solo de borradores no puede publicar ni programar. Nunca pegues la clave en un prompt de chat.

Ejecutarlo

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

El bin es un lanzador ejecutable real (TypeScript + imports sin extensión se resuelven a través de tsx). Todos los diagnósticos van a stderr; stdout lleva solo tráfico de protocolo. PUBLISHER_API_URL debe ser HTTPS (HTTP plano solo para desarrollo en loopback) y no debe llevar credenciales, queries ni fragments.

Configuración genérica de clientes

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

El lanzador requiere Node 22+ y las dependencias del espacio de trabajo (tsx, @modelcontextprotocol/sdk). Un transporte MCP alojado con OAuth es trabajo futuro; no asumas que cada cliente de escritorio o alojado soporta claves bearer pegadas.

Herramientas

HerramientaLectura/MutaciónNotas
list_accountslecturaRespeta la lista de cuentas permitidas de la clave
get_capabilitieslecturaFormatos, límites, requisitos de consentimiento
create_upload_intentmutaciónDevuelve instrucciones de subida directa; los bytes de los medios nunca fluyen por las herramientas
finalize_uploadmutaciónID de sesión (+ recibos de partes multipart); el servidor observa los bytes/MIME por sí mismo
create_draftmutaciónOrigen + variantes de destino
validate_postlecturaProblemas estructurados por destino
schedule_postmutaciónUn instante, ≤90 días en el futuro, expectedVersion requerido
publish_postmutaciónSemántica 202; no es prueba de publicación
get_post_statuslecturaEstados por destino y enlaces nativos
list_postslecturaPaginación por cursor
cancel_deliverymutaciónSolo mientras esté seguramente sin reclamar
retry_deliverymutaciónSolo fallos conocidos; nunca duplica
get_usagelecturaNo existe ningún contador de publicaciones restantes

Argumentos requeridos de las herramientas

HerramientaArgumentos requeridos
list_accountsNinguno
get_capabilitiesNinguno
create_upload_intentfilename, declaredMime, declaredBytes
finalize_uploadassetId, sessionId
create_draftcaption, destinations
validate_postpostId
schedule_postpostId, scheduledAt, timezone, expectedVersion
publish_postpostId
get_post_statuspostId
list_postsNinguno
cancel_deliverydeliveryId
retry_deliverydeliveryId
get_usageNinguno

Los argumentos opcionales incluyen paginación en las herramientas de lista, idempotencyKey en las mutaciones, multipart.parts para la finalización multipart, y variantes de medios de borrador y de destino. El esquema de herramientas en tiempo de ejecución devuelto por tools/list es la autoridad para los campos opcionales, las formas anidadas y los límites de validación.

Las herramientas de mutación aceptan un argumento opcional idempotencyKey. Cuando se omite, el servidor genera uno y lo devuelve en cada resultado: incluidos los fallos de transporte, donde la operación puede ya haber llegado a la API (el error lleva transport_outcome_unknown más la clave). Las herramientas nunca reintentan mutaciones automáticamente; reintenta con la MISMA clave de idempotencia para evitar crear una operación duplicada.

Ejemplo de flujo de trabajo del agente

  1. list_accounts + get_capabilities → elige destinos válidos.
  2. create_upload_intent → sube los bytes directamente → finalize_upload.
  3. create_draft → validate_post → corrige o deselecciona los destinos inválidos.
  4. publish_post (o schedule_post) → anota los IDs de entrega.
  5. get_post_status (sondeo acotado o webhooks de cliente): trata las respuestas requires_action como instrucciones accionables, p. ej. el consentimiento de TikTok.

Clientes probados

  • Cliente oficial TypeScript de @modelcontextprotocol/sdk, subprocess stdio real contra el bin documentado (initialize → tools/list → tools/call): probado en packages/mcp/tests/stdio.test.ts, incluidas las comprobaciones de stdout limpio y de fallo de arranque.
  • Cliente oficial del SDK sobre transporte en memoria: también cubierto.
  • Clientes de escritorio (Claude Desktop, Cursor, etc.): aún sin probar: configúralos según el fragmento genérico de arriba y reporta los resultados antes de afirmar compatibilidad.

Compatibilidad de clientes

Cliente o transporteEstadoConfiguración
SDK oficial de TypeScript con subprocess stdioCobertura de pruebas automatizadasLanzador del repositorio mostrado arriba
Transporte en memoria del SDK oficialCobertura de pruebas automatizadasSolo arnés de pruebas
Claude Desktop / otros clientes de escritorioNo verificado manualmenteCliente local con capacidad stdio; usa la ruta absoluta del lanzador
Conexión alojada de ChatGPTNo proporcionada por este adaptadorRequiere un transporte alojado; el JSON stdio local no es un conector alojado
MCP alojado con OAuthNo implementadoTrabajo de producto separado

Solución de problemas

  • El lanzador no puede resolver dependencias: ejecuta npm ci en el checkout de código fuente autorizado y comprueba la versión de Node. No lo sustituyas por un paquete público no relacionado.
  • El cliente nunca se inicializa: usa la ruta absoluta del lanzador e inspecciona stderr. No escribas salida de depuración en stdout.
  • 401: verifica que la clave de producto configurada esté vigente; crea un reemplazo en la UI si fue revocada. 403: comprueba los scopes y las restricciones de cuenta.
  • transport_outcome_unknown: conserva la clave de idempotencia devuelta y reintenta la operación idéntica con esa clave, nunca una nueva.
  • requires_action: entrega las instrucciones proporcionadas a una persona autorizada; un agente no puede suministrar el consentimiento humano de TikTok.

Manejo de credenciales

La clave de producto se envía solo a tu API de AiVideoEditor configurada (Authorization: Bearer). Nunca se envía a proveedores de modelos ni a redes sociales, nunca se registra, y las URLs se validan para que la clave no pueda seguir una redirección ni escapar del origen configurado.