ShortSync

npx add-mcp 'https://www.shortsync.app/api/mcp'

Conecta ShortSync a tu aplicación de IA

Permite que Claude Desktop, Cursor o cualquier cliente de IA compatible con MCP lea tus datos de ShortSync y actúe en tu nombre, utilizando el Protocolo de Contexto de Modelo (MCP).

¿Qué es MCP? El Protocolo de Contexto de Modelo es un estándar abierto que permite que un cliente de IA se comunique con una aplicación en tu nombre. Cuando conectas ShortSync, la IA puede llamar a un conjunto seleccionado de herramientas, como listar tus espacios de trabajo o tus publicaciones programadas próximas. Cada llamada está limitada a tu cuenta.

1

Añade ShortSync a tu cliente de IA

El endpoint de MCP es https://www.shortsync.app/api/mcp. Añádelo como conector personalizado en tu cliente de IA. Los pasos a continuación muestran Claude; Cursor, Continue y otros clientes MCP aceptan la misma URL.

Claude (aplicación web o de escritorio)

Abre Configuración → Conectores, haz clic en Añadir en la esquina superior derecha y elige Añadir conector personalizado.

Nómbralo ShortSync MCP (o como prefieras), pega la URL del endpoint y haz clic en Añadir. Deja los campos de ID de cliente OAuth / Secreto vacíos — ShortSync utiliza el Registro Dinámico de Clientes, por lo que Claude los negocia automáticamente.

Archivo de configuración de Claude Desktop (avanzado)

¿Prefieres editar el archivo de configuración directamente? Añade esto a tu claude_desktop_config.json. En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. En Windows: %APPDATA%\Claude\claude_desktop_config.json.

{
  "mcpServers": {
    "shortsync": {
      "type": "http",
      "url": "https://www.shortsync.app/api/mcp"
    }
  }
}

Reinicia Claude Desktop después de editar el archivo.

2

Completa la conexión

La primera vez que Claude llame a ShortSync, abrirá un navegador para que inicies sesión (si aún no lo has hecho) y mostrará una pantalla de consentimiento que enumera exactamente lo que la aplicación solicita. Haz clic en Permitir para completar la conexión.

Subir videos y miniaturas desde Claude.ai

Las herramientas create_video_upload y create_post_thumbnail_upload devuelven una URL prefirmada que apunta a amazonaws.com. De forma predeterminada, el entorno de ejecución de código de Claude.ai bloquea ese host, por lo que el PUT falla con host_not_allowed. Para permitir que Claude envíe los bytes por ti, permite el host una vez:

1. En Claude.ai, abre Configuración → Capacidades → Ejecución de código y creación de archivos.
2. Activa Ejecución de código en la nube y creación de archivos y Permitir salida de red.
3. En Dominios adicionales permitidos, añade *.amazonaws.com y haz clic en Añadir.
4. Inicia una nueva conversación. La lista de permitidos se aplica cuando se crea el entorno, por lo que los chats existentes mantienen las reglas antiguas y seguirán bloqueados.

Cursor, Claude Desktop y otros clientes que ejecutan llamadas a herramientas en tu propia máquina no necesitan esto — pueden acceder a S3 directamente.

Herramientas disponibles

Una selección curada de acciones de ShortSync se expone a través de MCP. Se añaden nuevas herramientas con el tiempo; pide a tu cliente de IA que ejecute tools/list para el inventario actual. A día de hoy:

Cuenta y espacio de trabajo

Dónde tienes acceso y qué está conectado.

Herramienta	Alcance	Propósito
get_user_profile	lectura	Devuelve la información de tu cuenta ShortSync.
list_organizations	lectura	Lista las organizaciones a las que perteneces y tu rol.
list_workspaces	lectura	Lista los espacios de trabajo a los que puedes acceder.
list_platform_connections	lectura	Lista qué plataformas están conectadas en un espacio de trabajo.
list_pinterest_boards	lectura	Lista los tableros en la cuenta de Pinterest conectada al espacio de trabajo, para elegir un boardId.
list_discord_channels	lectura	Lista los canales de Discord conectados a un espacio de trabajo, para elegir channelIds. Las publicaciones sin channelIds van a los canales predeterminados.

Videos y carpetas

Gestiona la biblioteca: sube nuevos videos o imágenes, organízalos en carpetas.

Herramienta	Alcance	Propósito
list_video_uploads	lectura	Lista tus subidas de video en los espacios de trabajo accesibles.
list_folders	lectura	Lista las carpetas en un espacio de trabajo, incluida la información de jerarquía.
create_video_upload	escritura	Reserva una NUEVA ranura de biblioteca y devuelve una URL PUT de S3 prefirmada para que puedas enviar los bytes directamente. No es para establecer una portada en una publicación existente. Usa create_post_thumbnail_upload para eso.
create_video_upload_from_url	escritura	Descarga un video o imagen desde una URL https pública como NUEVA entrada de biblioteca. No es para establecer una portada en una publicación existente. Usa update_post con custom_thumbnail_url en su lugar.
finalize_video_upload	escritura	Confirma que un PUT de create_video_upload llegó y vincula el nuevo video_upload_id que puedes pasar a create_post_draft.
create_folder	escritura	Crea una carpeta en un espacio de trabajo, opcionalmente anidada bajo una carpeta principal.
update_folder	escritura	Renombra o mueve (reparenta) una carpeta.
delete_folder	escritura	Elimina una carpeta; los videos dentro quedan sin carpeta.
move_video_to_folder	escritura	Archiva una subida de video en una carpeta, o la elimina de cualquier carpeta.
create_carousel	escritura	Agrupa de 2 a 50 elementos ya subidos en un solo carrusel. Devuelve un upload_id que pasas a create_post_draft. Los límites por plataforma (por ejemplo, IG 10, TikTok 35, X 4) se aplican al publicar.

Publicaciones y miniaturas

Convierte elementos de la biblioteca en borradores, edita subtítulos y portadas antes de publicar.

Herramienta	Alcance	Propósito
get_post_details	lectura	Devuelve subtítulo, título, descripción y estado de una sola publicación.
create_concept	escritura	Registra una idea de contenido en un espacio de trabajo antes de que haya una subida para adjuntarla. Pasa una fecha planificada para colocarla en el calendario de contenido.
create_post_draft	escritura	Crea un borrador de publicación para una sola plataforma a partir de una subida existente.
create_post_drafts	escritura	Versión por lotes — crea borradores de publicación para múltiples plataformas en una sola llamada en lugar de llamar a create_post_draft por plataforma.
update_post	escritura	Edita subtítulo, título, descripción, primer comentario, miniatura personalizada (URL de imagen, fotograma de línea de tiempo o una subida de imagen existente) y configuraciones por plataforma en cualquier publicación aún no publicada.
batch_update_posts	escritura	Versión por lotes — actualiza subtítulo, título, descripción, primer comentario y configuraciones de plataforma en múltiples publicaciones en una sola llamada. No admite miniaturas.
replace_post_media	escritura	Intercambia el video o imagen detrás de una publicación aún no publicada por otra subida en el espacio de trabajo, manteniendo su programación y subtítulos. Pasa apply_to_batch para intercambiar cada publicación programada junto con ella.
create_post_thumbnail_upload	escritura	Devuelve una URL PUT de S3 prefirmada limitada a la ranura de miniatura personalizada de una publicación específica. No crea una entrada de biblioteca; ideal para archivos de imagen locales destinados solo como portada.
finalize_post_thumbnail	escritura	Confirma que un PUT de create_post_thumbnail_upload llegó y conecta la imagen como custom_thumbnail_url de la publicación.

Publicación y programación

Pon en cola un borrador para publicarlo de inmediato o colócalo en un momento futuro.

Herramienta	Alcance	Propósito
list_scheduled_posts	lectura	Lista las publicaciones programadas próximas, primero las más cercanas.
schedule_post	escritura	Programa un borrador de publicación de video para publicarse en un momento específico.
batch_schedule_posts	escritura	Versión por lotes — programa múltiples borradores de publicación al mismo tiempo en una sola llamada en lugar de llamar a schedule_post por publicación.
cancel_scheduled_post	escritura	Cancela una publicación programada y la devuelve a borrador.
publish_now	escritura	Publica un borrador o una publicación programada de inmediato.
batch_publish_now	escritura	Versión por lotes de publish_now. Publica varias publicaciones de inmediato en una sola llamada: pasa IDs de publicación, o un ID de subida (opcionalmente limitado a algunas plataformas) para publicar todos sus borradores.

Analíticas

Resúmenes de métricas de publicaciones publicadas desde la caché de sincronización local. Cubre YouTube, TikTok, Instagram, Facebook, LinkedIn, Threads, Bluesky, Pinterest, Snapchat y Mastodon. Cuando los datos tienen más de una hora, leerlos también inicia una sincronización en segundo plano, por lo que preguntar de nuevo unos minutos después devuelve números frescos. Los números pueden diferir del panel en vivo en Instagram, Facebook y YouTube; consulta la descripción de cada herramienta para la advertencia.

Herramienta	Alcance	Propósito
get_workspace_analytics	lectura	Totales resumidos de analíticas de publicaciones publicadas en una ventana móvil.
get_video_analytics	lectura	Métricas para una subida de video, sumadas entre plataformas.
get_folder_analytics	lectura	Métricas para una carpeta, acumuladas entre videos y subcarpetas.
get_post_analytics	lectura	Métricas para una publicación de plataforma (una publicación = una plataforma).
explain_post_analytics_state	lectura	Explica por qué las analíticas de una publicación se ven de cierta manera (sincronización faltante, plataforma no compatible, etc.).
sync_analytics	escritura	Actualiza las analíticas desde las plataformas conectadas ahora, o verifica el progreso de una sincronización en curso.

Bandeja de entrada (comentarios y mensajes directos)

Lee y actúa sobre la interacción entrante en cada cuenta conectada.

Herramienta	Alcance	Propósito
list_inbox_conversations	lectura	Lista los hilos de la bandeja de entrada (comentarios + mensajes directos) con filtros de orden, búsqueda y respondidos/no respondidos.
list_inbox_connections	lectura	Qué cuentas de plataforma están conectadas a la bandeja de entrada y sus indicadores de capacidad de respuesta/mensaje directo/me gusta.
get_conversation_messages	lectura	Devuelve los mensajes en un hilo de la bandeja de entrada, primero los más antiguos.
resolve_linkedin_mention	lectura	Resuelve una mención @ de LinkedIn en el perfil subyacente para que una respuesta pueda etiquetarlos correctamente.
sync_inbox	escritura	Extrae hilos y mensajes frescos de cada conexión con mensajes directos habilitados.
load_more_comments	escritura	Pagina más profundamente en el historial de comentarios de un video/publicación específico.
reply_to_comment	escritura	Publica una respuesta a un comentario o hilo de mensajes directos.
mark_conversations_seen	escritura	Marca por lotes los hilos de la bandeja de entrada como leídos para el espacio de trabajo.
mark_conversations_spam	escritura	Cambia en masa el indicador local de moderación de spam en los hilos de la bandeja de entrada.
like_conversation	escritura	Da me gusta o quita me gusta a un hilo de comentarios de nivel superior de Instagram o Facebook.
like_message	escritura	Da me gusta o quita me gusta a una respuesta de comentario anidada de Instagram o Facebook.

Personas del espacio de trabajo

CRM ligero para las personas con las que trabajas en este espacio de trabajo.

Herramienta	Alcance	Propósito
list_workspace_people	lectura	Lista las personas guardadas en este espacio de trabajo con su información de contacto y rol.
upsert_workspace_person	escritura	Crea o actualiza un registro de persona en el espacio de trabajo.

¿Te falta una herramienta que necesitas? Envía un correo a hilma@shortsync.app con lo que quieres hacer y la añadiré.

Revocar acceso

Puedes desconectar cualquier aplicación de IA en cualquier momento desde Configuración → API y MCP. La revocación es inmediata; la siguiente llamada a herramienta de esa aplicación fallará y el usuario tendrá que reconectarse.

Límites

• Los tokens de acceso duran 1 hora; los tokens de actualización duran 30 días.
• Las llamadas a herramientas están limitadas a 60 por minuto por token, además de tu cuota existente por plan.
• Disponible en todos los planes, incluido el Gratuito. Las herramientas costosas (subidas, sincronizaciones de analíticas) aún cuentan contra tu cuota mensual.

MCP es diferente de la API REST de ShortSync. Para acceso programático con una clave Bearer estática, consulta API → Primeros pasos.