Postly MCP Server

Serveur Model Context Protocol pour Postly. Permet à Claude d'interagir avec votre compte Postly pour gérer vos publications sur les réseaux sociaux.

Installation

cd mcp-server
npm install
npm run build

Configuration

Créez un fichier .env dans le dossier mcp-server/ :

# URL de l'API Postly
POSTLY_API_URL=https://votre-domaine.vercel.app

# Clé API pour l'authentification
POSTLY_API_KEY=pstly_votre_cle_api

Configuration Claude Desktop

Ajoutez cette configuration dans votre fichier claude_desktop_config.json :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "postly": {
      "command": "node",
      "args": ["/chemin/vers/postly/mcp-server/dist/index.js"],
      "env": {
        "POSTLY_API_URL": "https://votre-domaine.vercel.app",
        "POSTLY_API_KEY": "pstly_votre_cle_api"
      }
    }
  }
}

Outils disponibles

list_accounts

Liste tous les comptes de réseaux sociaux connectés.

list_posts

Liste les posts programmés ou publiés.

Paramètres :

• status (optionnel) : SCHEDULED, PUBLISHED, FAILED, DRAFT, all
• limit (optionnel) : Nombre max de posts (défaut: 10, max: 50)

create_post

Crée et programme un nouveau post.

Paramètres :

• content (requis) : Contenu du post
• platforms (requis) : Liste des plateformes (INSTAGRAM, FACEBOOK, LINKEDIN, TWITTER, TIKTOK, THREADS)
• scheduledAt (requis) : Date/heure de publication
• mediaUrls (optionnel) : URLs des images
• alsoPostAsStory (optionnel) : Publier aussi en story Instagram

Formats de date acceptés :

• demain 10h
• lundi 14h30
• 5 février 9h
• 2024-02-15T10:00:00

update_post

Modifie un post programmé existant.

Paramètres :

• postId (requis) : ID du post
• content (optionnel) : Nouveau contenu
• scheduledAt (optionnel) : Nouvelle date/heure

delete_post

Supprime un post programmé.

Paramètres :

• postId (requis) : ID du post à supprimer

get_calendar

Récupère le calendrier de publication pour un mois.

Paramètres :

• month (optionnel) : Mois (1-12, défaut: mois actuel)
• year (optionnel) : Année (défaut: année actuelle)

get_stats

Récupère les statistiques du compte.

Ressources

Le serveur expose également des ressources MCP :

• postly://accounts - Liste des comptes connectés (JSON)
• postly://posts/scheduled - Posts programmés (JSON)
• postly://stats - Statistiques (JSON)

Exemples d'utilisation avec Claude

"Programme un post sur Instagram et Facebook pour demain 10h :
Le nouveau blog post est en ligne ! Découvrez nos 5 conseils pour..."

"Montre-moi les posts programmés pour la semaine prochaine"

"Supprime le post avec l'ID post_123456"

"Décale le post post_789 à vendredi 15h"

Développement

# Mode développement
npm run dev

# Tester avec l'inspecteur MCP
npm run inspector

API Endpoints

Le serveur MCP utilise ces endpoints API :

• GET /api/mcp/accounts - Liste comptes
• GET /api/mcp/posts - Liste posts
• POST /api/mcp/posts - Crée post
• PATCH /api/mcp/posts - Modifie post
• DELETE /api/mcp/posts?postId=xxx - Supprime post
• GET /api/mcp/calendar?month=X&year=Y - Calendrier
• GET /api/mcp/stats - Statistiques