> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.perfectpost.fr/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Servidor MCP PerfectPost # Servidor MCP PerfectPost ## Descripción PerfectPost es una plataforma de gestión de contenido para LinkedIn que ayuda a creadores y profesionales a seguir el rendimiento de sus publicaciones, gestionar sus borradores y optimizar su estrategia de contenido. Este servidor MCP da a los asistentes de IA acceso de lectura y escritura a la cuenta PerfectPost del usuario: publicaciones con sus estadísticas de interacción, ciclo de vida de borradores (creación, edición, programación) y datos del perfil de LinkedIn. El servidor está desplegado como un endpoint MCP remoto alojado: no se necesita instalación local. La autenticación se gestiona mediante OAuth 2.0 (Authorization Code flow con PKCE) a través del proveedor de identidad de PerfectPost (Amazon Cognito). El servidor soporta el registro dinámico de clientes (DCR) y los Client ID Metadata Documents (CIMD): por lo tanto, cualquier cliente MCP conforme puede conectarse automáticamente, sin configuración manual ni registro previo. **Endpoint MCP:** `https://mcp.perfectpost.social/mcp` **Transporte:** Streamable HTTP (respuestas JSON, stateless) ## Funcionalidades * **Estadísticas de publicaciones**: obtener métricas de rendimiento (impresiones, likes, comentarios, compartidos, reposts) con rangos de fechas configurables y obtener resúmenes estadísticos agregados * **Gestión de publicaciones**: listar, buscar y leer publicaciones de LinkedIn publicadas; actualizar metadatos como el objetivo de marketing, las categorías y el estado de favorito * **Análisis de audiencia**: descubrir quién dio like o comentó en una publicación específica * **Borradores**: listar, leer, crear, modificar y programar borradores para publicación en LinkedIn; adjuntar un medio (imagen, vídeo, PDF) desde una URL * **Perfil**: leer el perfil de LinkedIn del usuario autenticado, incluyendo nombre, titular y estadísticas de seguidores ## Instalación ### Conectarse desde Claude.ai 1. Abrir **Claude.ai > Configuración > Conectores > Añadir conector personalizado** 2. Rellenar los siguientes campos: * **Nombre**: `PerfectPost` * **URL del servidor MCP remoto**: `https://mcp.perfectpost.social/mcp` 3. Hacer clic en **Añadir** y luego en **Conectar**: serás redirigido a la página de inicio de sesión de PerfectPost 4. Iniciar sesión con tu cuenta PerfectPost y autorizar los permisos solicitados 5. Una vez autorizado, Claude puede acceder a tus datos de PerfectPost > La conexión es automática: Claude se identifica mediante un Client ID Metadata Document (CIMD), no se necesita configuración manual. Si tu versión de Claude solicita de todos modos un Client ID de OAuth en Configuración avanzada, introduce `dnakgf4sbal93ukngisqgb3vo` y deja el campo Secreto vacío. ### Conectarse desde Claude Code (CLI) Añadir la siguiente configuración en tu archivo `~/.claude.json` (sección `mcpServers`): ``` { "mcpServers": { "perfectpost": { "type": "http", "url": "https://mcp.perfectpost.social/mcp", "oauth": { "callbackPort": 6274 } } } } ``` Al iniciar Claude Code, escribe `/mcp` para iniciar la conexión. Se abrirá una ventana del navegador para completar el flujo de autenticación OAuth. El puerto de callback `6274` es obligatorio (restricción del proveedor de identidad). ### Conectarse desde ChatGPT La conexión utiliza el modo desarrollador de ChatGPT (se requiere una suscripción de pago), desde un ordenador: 1. Activar el modo desarrollador: **Configuración > Seguridad > Modo desarrollador** («Developer mode»), activar el interruptor. La advertencia de «riesgo elevado» es el mensaje estándar de ChatGPT para cualquier conector que no esté en el catálogo de OpenAI. 2. Abrir [chatgpt.com/plugins](https://chatgpt.com/plugins) y hacer clic en el botón **+** arriba a la derecha («Create an app», crear una aplicación). 3. En el formulario «Nouveau plugin» (nuevo plugin), rellenar: * **Nombre**: `PerfectPost MCP` * **Conexión**: «URL du serveur» (URL del servidor) con `https://mcp.perfectpost.social/mcp` * **Autenticación**: `OAuth` (los parámetros OAuth se detectan automáticamente a partir de la URL) 4. Marcar «I understand and want to continue» (entiendo y quiero continuar) y luego hacer clic en **Crear**. 5. Abrir el plugin creado (**Configuración > Plugins > PerfectPost MCP**), hacer clic en **Conectar** y luego en «Se connecter avec PerfectPost MCP» (iniciar sesión con PerfectPost MCP). Se abre una ventana de inicio de sesión de PerfectPost (permite las ventanas emergentes para chatgpt.com si no se abre nada): inicia sesión con tus credenciales de PerfectPost y acepta los permisos. 6. En una conversación, activar **PerfectPost MCP** y hacer tu pregunta, por ejemplo «analiza mis 10 últimos posts». > ChatGPT se identifica automáticamente ante el servidor mediante su Client ID Metadata Document (CIMD): no hay que introducir ningún Client ID. ### Conectarse desde Claude Desktop u otros clientes MCP Añadir la siguiente configuración en tu cliente MCP: ``` { "mcpServers": { "perfectpost": { "type": "http", "url": "https://mcp.perfectpost.social/mcp", "oauth": true } } } ``` Claude Desktop, Dust y cualquier cliente MCP conforme recuperan automáticamente su configuración mediante el Dynamic Client Registration (DCR) o un Client ID Metadata Document (CIMD). No se necesita ninguna configuración ni client ID manual: en el primer uso, el cliente abre una ventana del navegador para completar el flujo OAuth, y eso es todo. Si tu cliente MCP no soporta ni DCR ni CIMD, puedes introducir manualmente el client ID OAuth legacy: `dnakgf4sbal93ukngisqgb3vo`. > ⚠️ El paquete `mcp-remote` no es necesario. Claude Code, Claude Desktop y Claude.ai soportan nativamente los servidores MCP remotos con autenticación OAuth. Si utilizas un cliente MCP que solo soporta conexiones stdio, contacta con el soporte. ## Autenticación El servidor implementa el flujo OAuth 2.0 Authorization Code con PKCE, tal como lo requiere la especificación MCP para servidores remotos. | Parámetro | Valor | | ---- | | Endpoint de autorización | `https://mcp.perfectpost.social/authorize` | | Endpoint de token | `https://mcp.perfectpost.social/token` | | Scopes | `openid`, `email`, `profile` | | Client ID | Registro dinámico (DCR), URL CIMD, o client ID legacy `dnakgf4sbal93ukngisqgb3vo` | | Tipo de cliente | Público (sin client secret, PKCE requerido) | Una cuenta gratuita de PerfectPost es suficiente para conectarse. Algunas funcionalidades avanzadas de análisis pueden requerir una suscripción de pago. ## Herramientas ### Herramientas de solo lectura | Herramienta | Descripción | | ---- | | `list_posts` | Listar publicaciones de LinkedIn publicadas con paginación y filtros por fecha | | `get_post` | Obtener el contenido completo y las métricas de interacción de una publicación | | `search_posts` | Búsqueda de texto completo en las publicaciones publicadas | | `get_posts_stats_summary` | Estadísticas agregadas en un período (totales y mejores publicaciones) | | `get_post_likers` | Listar las personas que dieron like a una publicación | | `get_post_commenters` | Listar las personas que comentaron una publicación | | `get_linkedin_profile` | Obtener la información del perfil de LinkedIn | | `list_drafts` | Listar borradores con filtros de estado y paginación | | `get_draft` | Obtener el contenido completo y los metadatos de un borrador | Todas las herramientas de solo lectura están anotadas con `readOnlyHint: true` y `destructiveHint: false`. ### Herramientas de escritura | Herramienta | Descripción | | ---- | | `create_draft` | Crear un nuevo borrador para publicación en LinkedIn | | `update_draft` | Modificar el contenido o los metadatos de un borrador existente | | `schedule_draft` | Programar un borrador para publicación en una fecha y hora específicas | | `set_draft_media_from_url` | Adjuntar una imagen, vídeo o PDF a un borrador desde una URL | | `set_draft_media_from_base64` | Adjuntar a un borrador una imagen compartida en la conversación | | `update_post` | Modificar los metadatos de una publicación publicada (objetivo, categorías, favorito) | Todas las herramientas de escritura están anotadas con `readOnlyHint: false` y `destructiveHint: true`. ## Ejemplos ### Ejemplo 1: Analizar el rendimiento reciente en LinkedIn **Prompt del usuario:** > "¿Cómo han rendido mis publicaciones de LinkedIn el mes pasado? Muéstrame las cifras clave y mi mejor publicación." **Lo que Claude hace:** 1. Llama a `get_posts_stats_summary` con un rango de 30 días para obtener las métricas agregadas (impresiones totales, likes, comentarios, compartidos) y la lista de publicaciones con mejor rendimiento 2. Llama a `get_post` sobre la mejor publicación para obtener su texto completo y sus estadísticas detalladas 3. Presenta un resumen de rendimiento con las métricas clave y el contenido de la mejor publicación **Herramientas utilizadas:** `get_posts_stats_summary`, `get_post` ### Ejemplo 2: Crear y programar un borrador de LinkedIn **Prompt del usuario:** > "Escribe un post de LinkedIn sobre la importancia del personal branding para desarrolladores, y prográmalo para el próximo martes a las 8:30 hora de París." **Lo que Claude hace:** 1. Redacta el contenido del post con un gancho, cuerpo de texto, llamada a la acción y hashtags relevantes 2. Llama a `create_draft` para guardar el post en PerfectPost 3. Llama a `schedule_draft` con el identificador del borrador y el timestamp ISO 8601 correspondiente al próximo martes 08:30 Europe/Paris 4. Confirma la fecha y hora de programación, y proporciona el identificador del borrador como referencia **Herramientas utilizadas:** `create_draft`, `schedule_draft` ### Ejemplo 3: Descubrir quién interactúa con tu contenido **Prompt del usuario:** > "¿Quién dio like y comentó en mi publicación más popular de este año?" **Lo que Claude hace:** 1. Llama a `get_posts_stats_summary` sobre el período del año en curso para identificar la publicación con más impresiones 2. Llama a `get_post_likers` y `get_post_commenters` para esa publicación 3. Presenta la lista de personas que interactuaron, destacando a quienes dieron like y comentaron a la vez **Herramientas utilizadas:** `get_posts_stats_summary`, `get_post_likers`, `get_post_commenters` ### Ejemplo 4: Buscar y reciclar contenido pasado **Prompt del usuario:** > "Encuentra mis posts sobre IA y crea un nuevo borrador que sintetice las ideas principales." **Lo que Claude hace:** 1. Llama a `search_posts` con la consulta "IA" para encontrar todas las publicaciones relevantes 2. Analiza los resultados e identifica los temas recurrentes y las ideas clave 3. Llama a `create_draft` con un nuevo post de síntesis que retoma las ideas originales 4. Devuelve el borrador para que el usuario pueda revisarlo y modificarlo **Herramientas utilizadas:** `search_posts`, `create_draft` ## Requisitos de conexión Se necesita una cuenta gratuita de PerfectPost. Puedes crear una en [perfectpost.social](https://perfectpost.social/). No se necesita cuenta premium, acceso de administrador ni configuración especial para usar el servidor MCP. Algunas funcionalidades de análisis con historial extendido pueden estar limitadas en las cuentas gratuitas. El servidor MCP funciona con todas las plataformas Claude que soportan conexiones MCP remotas (Claude.ai, Claude Desktop, Claude Code, Claude Mobile). ## Política de privacidad La política de privacidad de PerfectPost está disponible aquí: [perfectpost.social/politique-de-confidentialite](https://perfectpost.social/politique-de-confidentialite/) El servidor MCP accede únicamente a los datos pertenecientes al usuario autenticado. Ningún dato se comparte con terceros. Los tokens OAuth nunca se registran ni almacenan en la capa MCP. El servidor cumple con el RGPD. ## Soporte * **Centro de ayuda:** [help.perfectpost.fr](https://help.perfectpost.fr/) * **Email:** [contact@perfectpost.fr](mailto:contact@perfectpost.fr) * **Chat en vivo:** disponible en [perfectpost.social](https://perfectpost.social/) Tiempo de respuesta habitual en un día laborable (lunes a viernes, hora de París).