> ## 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). # Serveur MCP PerfectPost # Serveur MCP PerfectPost ## Description PerfectPost est une plateforme de gestion de contenu LinkedIn qui aide les créateurs et professionnels à suivre la performance de leurs publications, gérer leurs brouillons et optimiser leur stratégie de contenu. Ce serveur MCP donne aux assistants IA un accès en lecture et écriture au compte PerfectPost de l'utilisateur : publications avec leurs statistiques d'engagement, cycle de vie des brouillons (création, édition, programmation) et données du profil LinkedIn. Le serveur est déployé comme un endpoint MCP distant hébergé : aucune installation locale n'est nécessaire. L'authentification est gérée via OAuth 2.0 (Authorization Code flow avec PKCE) à travers le fournisseur d'identité PerfectPost (Amazon Cognito). Le serveur supporte l'enregistrement dynamique des clients (DCR) et les Client ID Metadata Documents (CIMD) : tout client MCP conforme peut donc se connecter automatiquement, sans configuration manuelle ni inscription préalable. **Endpoint MCP :** `https://mcp.perfectpost.social/mcp` **Transport :** Streamable HTTP (réponses JSON, stateless) ## Fonctionnalités * **Statistiques des publications** : récupérer les métriques de performance (impressions, likes, commentaires, partages, reposts) avec des plages de dates configurables et obtenir des résumés statistiques agrégés * **Gestion des publications** : lister, rechercher et lire les publications LinkedIn publiées ; mettre à jour les métadonnées comme l'objectif marketing, les catégories et le statut favori * **Analyse de l'audience** : découvrir qui a liké ou commenté une publication spécifique * **Brouillons** : lister, lire, créer, modifier et programmer des brouillons pour publication sur LinkedIn ; attacher un média (image, vidéo, PDF) depuis une URL * **Profil** : lire le profil LinkedIn de l'utilisateur authentifié, incluant le nom, le titre et les statistiques d'abonnés ## Installation ### Se connecter depuis Claude.ai 1. Ouvrir **Claude.ai > Paramètres > Connecteurs > Ajouter un connecteur personnalisé** 2. Remplir les champs suivants : * **Nom** : `PerfectPost` * **URL du serveur MCP distant** : `https://mcp.perfectpost.social/mcp` 3. Cliquer sur **Ajouter**, puis sur **Connecter** : vous serez redirigé vers la page de connexion PerfectPost 4. Se connecter avec votre compte PerfectPost et autoriser les permissions demandées 5. Une fois autorisé, Claude peut accéder à vos données PerfectPost > La connexion est automatique : Claude s'identifie via un Client ID Metadata Document (CIMD), aucune configuration manuelle n'est nécessaire. Si votre version de Claude demande malgré tout un Client ID OAuth dans les Paramètres avancés, renseignez `dnakgf4sbal93ukngisqgb3vo` et laissez le champ Secret vide. ### Se connecter depuis Claude Code (CLI) Ajouter la configuration suivante dans votre fichier `~/.claude.json` (section `mcpServers`) : ``` { "mcpServers": { "perfectpost": { "type": "http", "url": "https://mcp.perfectpost.social/mcp", "oauth": { "callbackPort": 6274 } } } } ``` Au lancement de Claude Code, tapez `/mcp` pour initier la connexion. Une fenêtre de navigateur s'ouvrira pour compléter le flux d'authentification OAuth. Le port de callback `6274` est obligatoire (contrainte du fournisseur d'identité). ### Se connecter depuis ChatGPT La connexion utilise le mode développeur de ChatGPT (abonnement payant requis), depuis un ordinateur : 1. Activer le mode développeur : **Paramètres > Sécurité et connexion > Mode développeur**, activer l'interrupteur. L'avertissement « risque élevé » est le message standard de ChatGPT pour tout connecteur qui n'est pas dans le catalogue OpenAI. 2. Ouvrir [chatgpt.com/plugins](https://chatgpt.com/plugins) et cliquer sur le bouton **+** en haut à droite (« Créer une application »). 3. Dans « Nouveau plugin », renseigner : * **Nom** : `PerfectPost MCP` * **Connexion** : « URL du serveur » avec `https://mcp.perfectpost.social/mcp` * **Authentification** : `OAuth` (les paramètres OAuth se détectent automatiquement depuis l'URL) 4. Cocher « J'ai compris et je souhaite continuer », puis cliquer **Créer**. 5. Ouvrir le plugin créé (**Paramètres > Plugins > PerfectPost MCP**), cliquer **Connecter** puis **Se connecter avec PerfectPost MCP**. Une fenêtre de connexion PerfectPost s'ouvre (autoriser les popups pour chatgpt.com si rien ne s'ouvre) : se connecter avec ses identifiants PerfectPost et accepter les autorisations. 6. Dans une conversation, activer **PerfectPost MCP** et poser sa question, par exemple « analyse mes 10 derniers posts ». > ChatGPT s'identifie automatiquement auprès du serveur via son Client ID Metadata Document (CIMD) : aucun Client ID à renseigner. ### Se connecter depuis Claude Desktop ou d'autres clients MCP Ajouter la configuration suivante dans le fichier de configuration de votre client MCP : ``` { "mcpServers": { "perfectpost": { "type": "http", "url": "https://mcp.perfectpost.social/mcp", "oauth": true } } } ``` Claude Desktop, Dust et tout client MCP conforme récupèrent automatiquement leur configuration via le Dynamic Client Registration (DCR) ou via un Client ID Metadata Document (CIMD). Aucune configuration ni Client ID manuel n'est nécessaire : à la première connexion, le client ouvre une fenêtre de navigateur pour le flux OAuth, et c'est tout. Si votre client MCP ne supporte ni le DCR ni le CIMD, vous pouvez renseigner manuellement le Client ID OAuth legacy : `dnakgf4sbal93ukngisqgb3vo`. > ⚠️ Le package `mcp-remote` n'est pas nécessaire. Claude Code, Claude Desktop et Claude.ai supportent nativement les serveurs MCP distants avec authentification OAuth. Si vous utilisez un client MCP qui ne supporte que les connexions stdio, contactez le support. ## Authentification Le serveur implémente le flux OAuth 2.0 Authorization Code avec PKCE, tel que requis par la spécification MCP pour les serveurs distants. | Paramètre | Valeur | | ---- | | Endpoint d'autorisation | `https://mcp.perfectpost.social/authorize` | | Endpoint de token | `https://mcp.perfectpost.social/token` | | Scopes | `openid`, `email`, `profile` | | Client ID | Enregistrement dynamique (DCR), URL CIMD, ou Client ID legacy `dnakgf4sbal93ukngisqgb3vo` | | Type de client | Public (pas de client secret, PKCE requis) | | Un compte PerfectPost gratuit suffit pour se connecter. Certaines fonctionnalités avancées d'analyse peuvent nécessiter un abonnement payant. | | ## Outils ### Outils en lecture seule | Outil | Description | | ---- | | `list_posts` | Lister les publications LinkedIn publiées avec pagination et filtres par date | | `get_post` | Récupérer le contenu complet et les métriques d'engagement d'une publication | | `search_posts` | Recherche plein texte dans les publications publiées | | `get_posts_stats_summary` | Statistiques agrégées sur une période (totaux et meilleures publications) | | `get_post_likers` | Lister les personnes ayant liké une publication | | `get_post_commenters` | Lister les personnes ayant commenté une publication | | `get_linkedin_profile` | Récupérer les informations du profil LinkedIn | | `list_drafts` | Lister les brouillons avec filtres de statut et pagination | | `get_draft` | Récupérer le contenu complet et les métadonnées d'un brouillon | | Tous les outils en lecture seule sont annotés avec `readOnlyHint: true` et `destructiveHint: false`. | | ### Outils en écriture | Outil | Description | | ---- | | `create_draft` | Créer un nouveau brouillon pour publication sur LinkedIn | | `update_draft` | Modifier le contenu ou les métadonnées d'un brouillon existant | | `schedule_draft` | Programmer un brouillon pour publication à une date et heure précises | | `set_draft_media_from_url` | Attacher une image, vidéo ou PDF à un brouillon depuis une URL | | `set_draft_media_from_base64` | Attacher une image partagée dans la conversation à un brouillon | | `update_post` | Modifier les métadonnées d'une publication publiée (objectif, catégories, favori) | | Tous les outils en écriture sont annotés avec `readOnlyHint: false` et `destructiveHint: true`. | | ## Exemples ### Exemple 1 : Analyser sa performance LinkedIn récente **Prompt utilisateur :** > "Comment ont performé mes publications LinkedIn le mois dernier ? Montre-moi les chiffres clés et ma meilleure publication." **Ce que Claude fait :** 1. Appelle `get_posts_stats_summary` avec une plage de 30 jours pour récupérer les métriques agrégées (impressions totales, likes, commentaires, partages) et la liste des publications les plus performantes 2. Appelle `get_post` sur la meilleure publication pour récupérer son texte complet et ses statistiques détaillées 3. Présente un résumé de performance avec les métriques clés et le contenu de la meilleure publication **Outils utilisés :** `get_posts_stats_summary`, `get_post` ### Exemple 2 : Créer et programmer un brouillon LinkedIn **Prompt utilisateur :** > "Écris un post LinkedIn sur l'importance du personal branding pour les développeurs, et programme-le pour mardi prochain à 8h30 heure de Paris." **Ce que Claude fait :** 1. Rédige le contenu du post avec une accroche, un corps de texte, un appel à l'action et des hashtags pertinents 2. Appelle `create_draft` pour sauvegarder le post dans PerfectPost 3. Appelle `schedule_draft` avec l'identifiant du brouillon et le timestamp ISO 8601 correspondant à mardi prochain 08:30 Europe/Paris 4. Confirme la date et l'heure de programmation, et fournit l'identifiant du brouillon pour référence **Outils utilisés :** `create_draft`, `schedule_draft` ### Exemple 3 : Découvrir qui interagit avec son contenu **Prompt utilisateur :** > "Qui a liké et commenté ma publication la plus populaire cette année ?" **Ce que Claude fait :** 1. Appelle `get_posts_stats_summary` sur la période de l'année en cours pour identifier la publication avec le plus d'impressions 2. Appelle `get_post_likers` et `get_post_commenters` pour cette publication 3. Présente la liste des personnes ayant interagi, en mettant en avant celles qui ont à la fois liké et commenté **Outils utilisés :** `get_posts_stats_summary`, `get_post_likers`, `get_post_commenters` ### Exemple 4 : Rechercher et recycler du contenu passé **Prompt utilisateur :** > "Retrouve mes posts sur l'IA et crée un nouveau brouillon qui synthétise les idées principales." **Ce que Claude fait :** 1. Appelle `search_posts` avec la requête "IA" pour trouver toutes les publications pertinentes 2. Analyse les résultats et identifie les thèmes récurrents et les idées clés 3. Appelle `create_draft` avec un nouveau post de synthèse qui reprend les idées originales 4. Retourne le brouillon pour que l'utilisateur puisse le relire et le modifier **Outils utilisés :** `search_posts`, `create_draft` ## Prérequis de connexion Un compte PerfectPost gratuit est nécessaire. Vous pouvez en créer un sur [perfectpost.social](https://perfectpost.social/). Aucun compte premium, accès administrateur ou configuration spéciale n'est nécessaire pour utiliser le serveur MCP. Certaines fonctionnalités d'analyse avec un historique étendu peuvent être limitées sur les comptes gratuits. Le serveur MCP fonctionne avec toutes les plateformes Claude qui supportent les connexions MCP distantes (Claude.ai, Claude Desktop, Claude Code, Claude Mobile). ## Politique de confidentialité La politique de confidentialité de PerfectPost est disponible ici : [perfectpost.social/politique-de-confidentialite](https://perfectpost.social/politique-de-confidentialite/) Le serveur MCP accède uniquement aux données appartenant à l'utilisateur authentifié. Aucune donnée n'est partagée avec des tiers. Les tokens OAuth ne sont jamais journalisés ni stockés par la couche MCP. Le serveur est conforme au RGPD. ## Support * **Centre d'aide :** [help.perfectpost.fr](https://help.perfectpost.fr/) * **Email :** [contact@perfectpost.fr](mailto:contact@perfectpost.fr) * **Chat en direct :** disponible sur [perfectpost.social](https://perfectpost.social/) Temps de réponse habituel sous un jour ouvré (lundi au vendredi, heure de Paris).