Serveur MCP

Piloter LinkPost depuis Claude Code ou Claude Desktop sans écrire une ligne d'HTTP

Le Model Context Protocol (MCP) est un standard qui permet à un client IA (Claude Code, Claude Desktop, Cursor…) d'appeler des outils externes en langage naturel. LinkPost expose un serveur MCP qui donne accès à 22 outils — génération, analyse, calendrier, stats — depuis ton client IA préféré.

Concrètement : tu demandes à Claude Code "génère-moi 3 posts sur l'IA et programme le meilleur demain matin" et il le fait, sans que tu aies à écrire une seule requête HTTP.

Qui c'est fait pour

• Tu utilises Claude Code ou Claude Desktop au quotidien
• Tu veux brainstormer, générer, analyser et programmer des posts depuis le chat
• Tu veux inspecter tes stats et ton calendrier sans ouvrir l'app
• Tu veux tester des idées en langage naturel avant de les publier

Si tu préfères appeler l'API depuis un script ou un outil no-code, regarde plutôt la page API publique.

Prérequis

1. Un compte LinkPost actif. La génération et la réécriture de posts sont gratuites via le MCP ; seule l'analyse de qualité (analyze_post) consomme 1 crédit par appel.
2. Une clé API (format lp_live_xxx) créée dans Paramètres → Clés API. Assure-toi qu'elle a au minimum les scopes posts:generate, posts:read, posts:write et account:read.
3. Claude Code ou un autre client MCP installé.

Configuration

Claude Code

Ajoute le serveur à .claude/mcp-servers.json à la racine de ton projet (ou dans ~/.claude/mcp-servers.json pour une config globale) :

{
  "linkpost": {
    "type": "url",
    "url": "https://www.linkpost.gg/api/mcp",
    "headers": {
      "Authorization": "Bearer lp_live_VOTRE_CLE"
    }
  }
}

Relance Claude Code. Les 22 outils LinkPost apparaissent automatiquement.

Autres clients MCP

Le serveur parle le transport Streamable HTTP standard du SDK MCP officiel. N'importe quel client compatible peut s'y connecter en pointant sur https://www.linkpost.gg/api/mcp avec le header Authorization: Bearer lp_live_xxx.

Création native : de la big idea au post

Le MCP utilise les mêmes moteurs que le Studio et le coach LinkPost. Avec un sujet, generate_big_ideas enchaîne son analyse, son playbook mesuré et ses propositions. Sans sujet, il construit le menu natif depuis ton profil, tes posts, les tendances et ta mémoire. Il accepte aussi ton contexte factuel et tes préférences de rédaction.

1. generate_big_ideas retourne un workflowId et des idées identifiées. Choisis celle que tu veux développer.
2. prepare_post(workflowId, ideaId) demande au moteur les questions de vécu manquant. Réponds avec tes faits réels ; les exemples affichés ne sont pas des faits sur toi.
3. generate_post(workflowId, answers) rédige avec l’angle retenu, ta matière, ta mémoire et les règles natives. Les réponses utilisent les questionId renvoyés à l’étape précédente.
4. validate_post(workflowId) confronte le texte aux gagnants et perdants du sujet et aux faits de l’auteur. ready=false signifie que le post ne doit pas être présenté comme prêt.
5. refine_post(workflowId, instruction) permet une correction ; il faut ensuite valider de nouveau.

Le parcours est conservé côté serveur pendant sept jours d’accès, pour ton compte uniquement. Le choix d’une autre idée efface les réponses et le verdict du précédent post. Une étape ne peut pas être contournée en envoyant une proposition fabriquée par le client.

Aucun post n’est sauvegardé ni programmé automatiquement. Demande ensuite create_draft pour sauvegarder ; utilise update_draft pour modifier ce même brouillon. Un appel historique generate_post(prompt=...) commence désormais l’idéation native et ne renvoie plus automatiquement un draftId.

Le générateur et le juge peuvent prendre plusieurs minutes. Le MCP émet des notifications d’avancement aux clients compatibles. Si le moteur échoue, le client doit signaler l’échec, pas prétendre avoir utilisé le moteur ni remplacer les résultats par un brainstorming générique. La prédiction de viralité et l’analyse X-ray restent des compléments distincts.

Outils disponibles

22 outils — génération, édition, analyse et recherche.

Génération & édition

Brouillons (CRUD complet)

Tes posts publiés

Recherche & découverte d'inspirations

Viralité

Calendrier & compte

Exemples d'utilisation

Brainstormer et programmer

"Génère-moi 3 posts sur les pièges de l'hypergrowth pour une startup. Programme le meilleur mardi prochain à 8h00."

Claude appelle generate_big_ideas, te laisse choisir une idée, puis utilise prepare_post pour demander le vécu manquant. Après tes réponses, generate_post rédige et validate_post juge le résultat. Si tu demandes une programmation, create_draft enregistre le texte validé avec scheduledAt.

Auditer ses stats

"Montre-moi mes 10 derniers posts, dis-moi lequel a le mieux marché et pourquoi."

Claude appelle get_posts avec limit: 10 puis analyse les métriques pour t'expliquer le pattern.

Prédire la viralité avant de publier

"Voici mon brouillon : [texte]. Prédis son score de viralité et suggère 2 améliorations."

Claude appelle predict_virality → interprète le score → propose des changements concrets.

Trouver de l'inspi dans tes profils importés

"Cherche dans mes inspirations des posts carrousel qui ont fait plus de 500 likes et parlent de leadership."

Claude appelle search_inspirations avec format: carousel, minLikes: 500, search: leadership.

Découvrir les posts les plus viraux d'une niche

"Trouve les 5 posts les plus viraux des 7 derniers jours sur le burnout en startup, en français."

Claude appelle discover_inspirations avec query: "burnout startup", timeline: "7d", sort: "most-viral", language: "fr", limit: 5. La recherche est sémantique (FTS + embeddings) sur toute la bibliothèque, et chaque post est noté par le score de viralité (ratio likes / moyenne de l'auteur).

Itérer sur un brouillon existant

"Reprends mon dernier draft, raccourcis-le et reprogramme-le pour jeudi 8h."

Claude appelle list_drafts → get_draft_by_id → rewrite_post (instruction: "raccourcir") → update_draft avec le nouveau contenu et scheduledAt mis à jour. Tout reste dans un seul draft, pas d'accumulation.

Slash commands intégrées (pas besoin d'installer quoi que ce soit)

Le serveur MCP expose aussi 10 prompts (capability MCP prompts) qui apparaissent comme des slash commands natifs dans claude.ai web, Claude Desktop, ChatGPT et tout client MCP — dès que tu connectes https://www.linkpost.gg/api/mcp.

Comment ça marche :

1. Tu connectes LinkPost comme custom connector dans claude.ai (Settings → Connectors) ou Claude Desktop
2. Tu te logges via OAuth (le flow LinkPost)
3. Selon ton client, tu accèdes aux commandes différemment :
   • claude.ai web : clique sur le bouton + à gauche du chat → Connecteurs → Ajouter depuis LinkPost → choisis une commande dans la liste. Le prompt s'attache comme un fichier .txt à ton message, tu peux ajouter du contexte puis envoyer.
   • Claude Desktop : tape / dans un chat — un menu liste les 10 commandes (slash menu natif).
   • Claude Code CLI : tape / (les prompts MCP apparaissent à côté des skills locales).
4. Tu pick une commande, optionnellement tu remplis un argument (topic, durée…), tu envoies
5. Le chat orchestre ensuite avec les 22 tools MCP pour répondre

La langue (FR / EN) est détectée depuis ton profil LinkPost — pas besoin de la spécifier.

Différence avec les skills Claude Code : les skills (à installer dans .claude/skills/) sont pour les power users qui codent en ligne de commande — elles donnent un workflow multi-étape orchestré. Les prompts MCP sont la version "1 click" pour tout le monde, le LLM du client se charge de l'orchestration.

Pack gratuit : skill et prompts LinkedIn

Recevoir le pack Claude / ChatGPT. Il contient un skill, une version texte autonome à joindre à une conversation, les prompts et un modèle de contexte. Le lien de téléchargement arrive par email.

Le skill privilégie le parcours natif LinkPost : big ideas, choix de l’angle, questions à l’auteur, rédaction et validation. Sans MCP, il utilise les informations fournies et les outils disponibles ; le modèle de conversation rédige alors lui-même. Le pack ne connecte pas le MCP automatiquement et n’inclut pas d’abonnement LinkPost.

Bon à savoir

• Même clé, mêmes quotas — MCP et API publique partagent les mêmes clés, les mêmes scopes, et le même rate limit.
• Crédits — La génération et la réécriture sont gratuites via le MCP. Seul analyze_post consomme 1 crédit par appel. Regarde ton solde avec get_credits.
• Liens cliquables — Tous les tools qui retournent un post (get_posts, get_post_by_urn, search_inspirations, discover_inspirations) incluent un champ linkpostUrl à côté du urn brut. Cette URL ouvre directement la page Inspirations de LinkPost filtrée sur ce post (ex: https://www.linkpost.gg/app/inspirations?postIds=urn%3Ali%3Aactivity%3A7345...). Pratique pour aller voir un post depuis la conversation Claude en un clic.
• Clé rotation — Si tu révoques la clé utilisée par le MCP, Claude Code perd l'accès instantanément. Crée une nouvelle clé, mets à jour le JSON, relance.
• Sécurité — Ta clé est dans un fichier JSON local. Ne le commit pas. Ajoute .claude/mcp-servers.json à ton .gitignore si besoin.

Voir aussi

• API publique — L'API REST sous-jacente, si tu veux appeler les endpoints directement depuis un script
• Crédits — Comprendre les coûts de génération