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
| Herramienta | Lectura/Mutación | Notas |
|---|---|---|
list_accounts | lectura | Respeta la lista de cuentas permitidas de la clave |
get_capabilities | lectura | Formatos, límites, requisitos de consentimiento |
create_upload_intent | mutación | Devuelve instrucciones de subida directa; los bytes de los medios nunca fluyen por las herramientas |
finalize_upload | mutación | ID de sesión (+ recibos de partes multipart); el servidor observa los bytes/MIME por sí mismo |
create_draft | mutación | Origen + variantes de destino |
validate_post | lectura | Problemas estructurados por destino |
schedule_post | mutación | Un instante, ≤90 días en el futuro, expectedVersion requerido |
publish_post | mutación | Semántica 202; no es prueba de publicación |
get_post_status | lectura | Estados por destino y enlaces nativos |
list_posts | lectura | Paginación por cursor |
cancel_delivery | mutación | Solo mientras esté seguramente sin reclamar |
retry_delivery | mutación | Solo fallos conocidos; nunca duplica |
get_usage | lectura | No existe ningún contador de publicaciones restantes |
Argumentos requeridos de las herramientas
| Herramienta | Argumentos requeridos |
|---|---|
list_accounts | Ninguno |
get_capabilities | Ninguno |
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 | Ninguno |
cancel_delivery | deliveryId |
retry_delivery | deliveryId |
get_usage | Ninguno |
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
list_accounts+get_capabilities→ elige destinos válidos.create_upload_intent→ sube los bytes directamente →finalize_upload.create_draft→validate_post→ corrige o deselecciona los destinos inválidos.publish_post(oschedule_post) → anota los IDs de entrega.get_post_status(sondeo acotado o webhooks de cliente): trata las respuestasrequires_actioncomo 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 enpackages/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 transporte | Estado | Configuración |
|---|---|---|
| SDK oficial de TypeScript con subprocess stdio | Cobertura de pruebas automatizadas | Lanzador del repositorio mostrado arriba |
| Transporte en memoria del SDK oficial | Cobertura de pruebas automatizadas | Solo arnés de pruebas |
| Claude Desktop / otros clientes de escritorio | No verificado manualmente | Cliente local con capacidad stdio; usa la ruta absoluta del lanzador |
| Conexión alojada de ChatGPT | No proporcionada por este adaptador | Requiere un transporte alojado; el JSON stdio local no es un conector alojado |
| MCP alojado con OAuth | No implementado | Trabajo de producto separado |
Solución de problemas
- El lanzador no puede resolver dependencias: ejecuta
npm cien 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.