Planoly MCP

Servidor MCP de Planoly

Conecta asistentes de IA a Planoly — planifica, crea, programa y analiza contenido de redes sociales en Instagram, TikTok, YouTube, Pinterest, Facebook y más, directamente desde Claude, Cursor o cualquier cliente MCP.

Este es un servidor MCP remoto, alojado por Planoly:

https://mcp.planoly.com/mcp

No hay nada que instalar o ejecutar — conectas tu cliente MCP a la URL anterior e inicias sesión con tu cuenta de Planoly mediante OAuth. Este repositorio aloja la documentación pública y los metadatos del registro del servidor.

Lo que puedes hacer

• Crear y programar publicaciones en todos tus canales conectados en una sola llamada — subtítulo/medio compartido con anulaciones por plataforma, etiquetas y colaboradores de Instagram, sonidos y configuraciones de privacidad de TikTok, visibilidad de YouTube, tableros de Pinterest y más.
• Gestionar tu calendario de contenido — listar borradores y publicaciones programadas, editar subtítulos y configuraciones, reprogramar (incluidos los espacios de Mejor Momento de Instagram) o eliminar.
• Trabajar con tu biblioteca de medios — navegar, buscar, organizar en carpetas, previsualizar medios, importar desde URL o subir nuevos archivos.
• Analizar rendimiento — analíticas de cuentas de Instagram, rendimiento por publicación clasificado por la métrica que te importa, investigación de cuentas públicas mediante Business Discovery y enlaces de informes compartibles.
• Descubrir tendencias — explorar los sonidos de tendencia de la Biblioteca de Música Comercial de TikTok y adjuntarlos a publicaciones.

Consulta docs/examples.md para ver ejemplos de indicaciones y flujos de trabajo.

Primeros pasos

Claude Code

claude mcp add --transport http planoly https://mcp.planoly.com/mcp

Claude (claude.ai y Claude Desktop)

Ve a Configuración → Conectores → Añadir conector personalizado e introduce:

https://mcp.planoly.com/mcp

Cursor

Añade a ~/.cursor/mcp.json (o .cursor/mcp.json en un proyecto):

{
  "mcpServers": {
    "planoly": {
      "url": "https://mcp.planoly.com/mcp"
    }
  }
}

VS Code

code --add-mcp '{"name":"planoly","type":"http","url":"https://mcp.planoly.com/mcp"}'

Otros clientes (solo stdio)

Para clientes que solo admiten servidores stdio locales, usa el puente con mcp-remote:

{
  "mcpServers": {
    "planoly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.planoly.com/mcp"]
    }
  }
}

En el primer uso, tu cliente abre una ventana del navegador para iniciar sesión en Planoly y aprobar el acceso. Si el estado de autenticación del puente se bloquea, límpialo con rm -rf ~/.mcp-auth y vuelve a conectarte.

Autenticación

El servidor utiliza el flujo de autorización estándar de MCP — código de autorización OAuth 2.1 con tokens de actualización, descubierto automáticamente por el cliente:

• Metadatos del recurso protegido: https://mcp.planoly.com/.well-known/oauth-protected-resource/mcp
• Servidor de autorización: https://app.planoly.com/api/auth
• Ámbitos: openid, profile, email, offline_access

Los tokens están limitados a tu usuario de Planoly. Las herramientas que operan en un espacio de trabajo toman un workspaceId y aplican la membresía del espacio de trabajo en cada llamada — comienza con list_workspaces para ver a qué puedes acceder.

Detalles completos en docs/authentication.md.

Herramientas

Resumidas a continuación; el detalle a nivel de parámetros está en docs/tools.md.

Espacios de trabajo y canales

Herramienta	Descripción
list_workspaces	Lista los espacios de trabajo a los que tu cuenta puede acceder.
list_channels	Lista los canales sociales conectados de un espacio de trabajo y su estado de conexión, para que el agente sepa a qué puede publicar.

Publicaciones y programación

Herramienta	Descripción
create_post	Crea un grupo de publicaciones en uno o más canales. Los objetivos comparten un conjunto de subtítulo/medio o lo anulan por plataforma, con configuraciones de plataforma para Instagram (etiquetas, portada, colaboradores, primer comentario, sonido), TikTok (título, privacidad, contenido de marca, música), YouTube (título, visibilidad), Pinterest (tablero, título, enlace), Facebook y Amazon. Opcionalmente programa todo el grupo.
list_post_groups	Lista publicaciones existentes (borradores, programadas, publicadas) con subtítulos, fechas de programación, medios (incluidos IDs de archivos reutilizables) y miniaturas.
update_post	Edita una publicación existente — subtítulo, medio, primer comentario y configuraciones por plataforma.
set_post_group_schedule	Programa un borrador, reprograma, programa en el siguiente espacio de Mejor Momento de Instagram o revierte a borrador. Las publicaciones de auto-publicación se validan contra las reglas de la plataforma antes de programar.
delete_post_group	Elimina un grupo de publicaciones en borrador o programadas.

Biblioteca de medios y archivos

Herramienta	Descripción
list_media_library	Navega y busca en la biblioteca de medios — fotos, videos, carruseles, notas, marcadores de URL y carpetas.
get_media_preview	Devuelve una imagen en miniatura en línea para un archivo para que cualquier cliente MCP pueda ver qué hay en una foto o video.
create_media_library_folder	Crea una carpeta (opcionalmente anidada) para organizar elementos de la biblioteca.
create_media_library_item	Guarda medios, una nota o un marcador de URL en la biblioteca.
update_media_library_item	Edita el nombre, título, descripción, enlace o conjunto de medios de una entrada de la biblioteca.
delete_media_library_item	Elimina una entrada de la biblioteca (las carpetas se eliminan en cascada; los archivos subyacentes y las publicaciones no se tocan).
create_asset_from_url	Importa una imagen/video desde una URL en la lista de hosts permitidos (CDN de Instagram/Facebook, Planoly, exportaciones de Canva y salidas de generación de IA admitidas).
request_asset_upload / confirm_asset_upload	Flujo de subida con URL firmada para clientes que pueden realizar un HTTP PUT (por ejemplo, un sandbox de ejecución de código).

Analíticas e investigación

Herramienta	Descripción
get_instagram_analytics	Analíticas de cuentas de Instagram Business para un rango de fechas — crecimiento de seguidores, alcance, vistas, interacciones, desgloses de audiencia y una serie diaria.
list_post_performance	Cómo rindieron las publicaciones de Instagram publicadas — alcance, vistas, me gusta, comentarios, compartidos, guardados — clasificadas por una métrica elegida.
get_instagram_account_posts	Obtén las publicaciones recientes de una cuenta pública de Instagram Business/Creador (subtítulos, medios, interacción pública) para investigación y resúmenes.
create_post_report_share_link	Genera un enlace compartible de solo lectura al informe de rendimiento de publicaciones del espacio de trabajo (caduca en 14 días).

Etiquetado de Instagram y sonidos de TikTok

Herramienta	Descripción
search_instagram_locations	Busca lugares para etiquetar en publicaciones de Instagram.
search_instagram_products	Busca en el catálogo de una tienda de Instagram conectada para etiquetar productos.
list_tiktok_trending_sounds	Explora los sonidos de tendencia de la Biblioteca de Música Comercial de TikTok por género, país y rango de fechas.

Cómo llegan los medios a las publicaciones

El modelo nunca transporta bytes de medios a través de la inferencia. Los medios llegan a una publicación mediante assetId, de una de tres fuentes:

1. Medios existentes — toma un assetId de list_media_library o de otra publicación mediante list_post_groups.
2. Desde una URL — create_asset_from_url hace que el servidor lo obtenga (solo hosts permitidos).
3. Bytes locales — request_asset_upload → HTTP PUT los bytes → confirm_asset_upload, para clientes con un sandbox de ejecución de código.

Detalles y restricciones en docs/media.md.

Validación y requisitos de plan

Las publicaciones se validan contra las reglas de cada plataforma (longitud del subtítulo, cantidad/tipo de medios, relación de aspecto, duración del video) de la misma manera que la aplicación de Planoly las valida — los errores llegan en el momento de la llamada a la herramienta con la violación exacta, no en el momento de la publicación.

Algunas herramientas corresponden a funciones premium de Planoly y requieren un espacio de trabajo de pago: sonidos de tendencia de TikTok, herramientas de biblioteca de medios, herramientas de analíticas y etiquetado de productos. Cuando una herramienta requiere una actualización, el error incluye un enlace a la página de facturación.

Documentación

• Referencia de herramientas — cada herramienta, sus parámetros y comportamiento
• Autenticación — el flujo OAuth, modelo de tokens, restablecimiento del estado de autenticación
• Manejo de medios — cómo entran y salen los archivos
• Ejemplos de indicaciones — flujos de trabajo para probar
• Solución de problemas — errores comunes y correcciones
• Registro de cambios

Soporte y seguridad

• Ayuda de producto y cuenta: Centro de ayuda de Planoly · consulta SUPPORT.md
• Errores del servidor MCP y solicitudes de funciones: issues
• Vulnerabilidades: repórtalas de forma privada según SECURITY.md

La implementación del servidor no es de código abierto; este repositorio rastrea la documentación pública y los metadatos del registro MCP (server.json) para el servicio alojado.