Comment utiliser le serveur MCP de Postoria

Le serveur MCP de Postoria permet aux outils IA compatibles MCP de créer et de gérer des publications dans Postoria via l’API publique de Postoria.

Vous pouvez vous connecter à Postoria de deux façons :

  1. Serveur MCP npm local — s’exécute sur votre machine et utilise votre clé d’API publique Postoria.
  2. Point de terminaison MCP hébergé par Postoria — s’exécute sur l’infrastructure Postoria à l’adresse https://mcp.postoria.io/mcp et prend en charge la connexion OAuth ou l’authentification par clé d’API publique, selon les capacités de votre client MCP.

Le serveur MCP peut aider un outil IA à lister les espaces de travail, trouver des comptes sociaux et des files d’attente, importer ou téléverser des médias, publier des contenus, programmer des publications, les ajouter à des files d’attente, lister les publications existantes, vérifier leur statut et les supprimer dans Postoria.

La prise en charge de MCP dépend de l’outil IA que vous utilisez. Les outils compatibles peuvent notamment inclure Claude Desktop, Cursor, Claude Code et les applications personnalisées ChatGPT lorsque les connexions MCP personnalisées sont disponibles.

Avant de commencer

Voici les principaux points à connaître avant d’utiliser le serveur MCP de Postoria :

  • L’accès au serveur MCP est disponible avec les offres Pro et Agency.
  • Le serveur MCP utilise l’API publique de Postoria en arrière-plan.
  • Le serveur MCP npm local nécessite une clé d’API publique Postoria.
  • Le point de terminaison MCP hébergé par Postoria peut utiliser la connexion OAuth lorsque le client MCP prend en charge la découverte OAuth.
  • Le point de terminaison MCP hébergé par Postoria peut également accepter une clé d’API publique Postoria comme jeton Bearer.
  • Les clés d’API publique sont liées au compte, et non à un espace de travail.
  • L’utilisation en local permet de téléverser des fichiers depuis votre machine lorsque le client MCP prend en charge l’accès aux fichiers.
  • Le point de terminaison MCP hébergé par Postoria ne nécessite pas d’installer le paquet npm localement.

Vous pouvez également consulter le guide de l’API publique de Postoria pour en savoir plus sur la configuration de la clé API et le fonctionnement de l’API.

Choisir entre une utilisation locale et hébergée

Choisissez la méthode de connexion adaptée à votre client MCP.

Serveur MCP npm local

Utilisez le serveur MCP npm local lorsque votre client compatible MCP peut exécuter une commande locale.

Cette configuration est courante pour les outils de bureau et les IDE tels que Claude Desktop, Cursor et Claude Code.

En mode local :

  • Le serveur MCP s’exécute sur votre machine via le paquet npm.
  • Votre clé d’API publique Postoria est fournie dans la configuration locale du client MCP.
  • Le téléversement de fichiers locaux est possible lorsque le client MCP autorise le serveur MCP à accéder à un chemin de fichier local.

Le paquet npm est :

@postoria/mcp-server

La commande locale est :

npx -y @postoria/mcp-server

Point de terminaison MCP hébergé par Postoria

Utilisez le point de terminaison MCP hébergé par Postoria lorsque votre client compatible MCP peut se connecter à des serveurs MCP hébergés.

En mode hébergé :

  • Vous n’installez pas le paquet npm localement.
  • Le client MCP se connecte à https://mcp.postoria.io/mcp.
  • Les clients compatibles OAuth peuvent vous guider lors de la connexion à Postoria.
  • Les clients prenant en charge les jetons Bearer peuvent utiliser une clé d’API publique Postoria.

Le point de terminaison MCP hébergé par Postoria est :

https://mcp.postoria.io/mcp

Créer une clé d’API publique

Créez une clé d’API publique pour le serveur MCP npm local ou pour les clients MCP hébergés utilisant l’authentification par jeton Bearer.

Le parcours de connexion OAuth du point de terminaison MCP hébergé par Postoria n’utilise pas de clé d’API publique.

Pour créer une clé d’API publique :

  1. Ouvrez Postoria.
  2. Accédez aux paramètres.
  3. Repérez la section API publique.
  4. Cliquez sur Créer une clé API.
  5. Copiez la clé et conservez-la en lieu sûr.

Postoria n’affiche la clé API complète qu’une seule fois. Après avoir fermé la boîte de dialogue, vous ne verrez plus que le préfixe de la clé.

Si vous perdez la clé, révoquez-la et créez-en une nouvelle.

Configurer un client MCP local

La configuration exacte dépend de votre client MCP.

Pour les clients prenant en charge une configuration des serveurs MCP au format JSON, utilisez le paquet en fournissant la clé API Postoria dans les variables d’environnement.

Exemple :

{
  "mcpServers": {
    "postoria": {
      "command": "npx",
      "args": ["-y", "@postoria/mcp-server"],
      "env": {
        "POSTORIA_API_KEY": "pst_live_your_postoria_api_key_here"
      }
    }
  }
}

Après avoir enregistré la configuration, redémarrez ou actualisez votre client MCP, puis demandez-lui d’utiliser Postoria.

Point de terminaison MCP hébergé par Postoria

Pour les connexions MCP hébergées, utilisez ce point de terminaison :

https://mcp.postoria.io/mcp

Le point de terminaison hébergé prend en charge deux méthodes d’authentification. Celle que vous utilisez dépend de votre client MCP.

Connexion OAuth

Certains clients MCP prennent en charge la découverte OAuth pour les serveurs MCP hébergés. Dans ce cas, ajoutez le point de terminaison MCP hébergé par Postoria dans le client MCP et connectez-vous à Postoria lorsque cela vous est demandé.

https://mcp.postoria.io/mcp

Clé d’API publique comme jeton Bearer

Certains clients MCP prennent en charge les jetons Bearer personnalisés. Dans ce cas, utilisez votre clé d’API publique Postoria comme jeton Bearer.

Authorization: Bearer pst_live_your_postoria_api_key_here

Si le client demande séparément la valeur du jeton et le schéma de l’en-tête, saisissez uniquement la clé API comme valeur du jeton et choisissez Bearer comme schéma.

Ne collez pas le mot Bearer dans le champ du jeton, sauf si le client MCP demande explicitement la valeur complète de l’en-tête.

Après la connexion, demandez au client de rechercher ou de charger les outils disponibles.

Outils disponibles

Le serveur MCP de Postoria fournit des outils pour les opérations de publication courantes.

Outils pour les espaces de travail et les comptes

  • list_workspaces — lister les espaces de travail Postoria disponibles.
  • list_social_accounts — lister les comptes sociaux d’un espace de travail.
  • list_queues — lister les files d’attente d’un espace de travail.

Ces outils aident le client IA à trouver les identifiants d’espace de travail, de compte social et de file d’attente nécessaires avant de créer une publication.

Outils pour les médias

  • import_media_from_url — importer un média depuis une URL publique.
  • create_media_upload — créer une URL signée de téléversement de média.
  • complete_media_upload — finaliser le téléversement d’un média après l’envoi des octets bruts du fichier.
  • upload_media_from_file — téléverser un fichier local depuis la machine qui exécute le serveur MCP local.
  • get_media — vérifier le statut et les détails d’un média.

Outils pour les publications

  • publish_post_now — publier immédiatement.
  • schedule_post — programmer une publication à une heure précise.
  • add_post_to_queue — ajouter une publication à une file d’attente.
  • list_posts — lister les publications d’un espace de travail avec des filtres facultatifs et une pagination.
  • get_post — vérifier le statut et les détails d’une publication.
  • delete_post — supprimer une publication dans Postoria. Cela ne retire pas le contenu déjà publié sur les réseaux sociaux.

Options pour les médias

Le mode de traitement des médias dépend de l’emplacement du fichier et des capacités de votre client MCP.

Importer un média depuis une URL publique

Utilisez cette méthode lorsque l’image ou la vidéo est déjà accessible via une URL publique.

Elle convient aux médias stockés sur un site web, un CMS, une bibliothèque de ressources ou une autre source publique.

Le client IA peut appeler import_media_from_url, puis get_media pour vérifier si le traitement est terminé.

Téléverser un média avec une URL signée

Utilisez cette méthode lorsque le client peut envoyer les octets bruts d’un fichier à une URL de téléversement signée.

Les étapes sont les suivantes :

  1. Appelez create_media_upload.
  2. Envoyez les octets bruts du fichier à l’URL de téléversement renvoyée avec PUT.
  3. Appelez complete_media_upload.
  4. Appelez get_media pour vérifier le statut du média.

N’appelez complete_media_upload qu’une fois les octets bruts du fichier effectivement envoyés.

Téléverser un fichier local

Utilisez cette méthode dans un environnement MCP local sur ordinateur lorsque vous souhaitez téléverser un fichier à partir de son chemin local.

Le client IA peut appeler upload_media_from_file avec un chemin de fichier local. Le serveur MCP local téléverse le fichier vers Postoria, finalise l’envoi et renvoie le statut du média.

Exemples d’utilisation

Les exemples de demandes doivent ressembler à des demandes de publication ordinaires, et non à des instructions d’API. Le client MCP peut choisir lui-même les outils Postoria à appeler en arrière-plan.

Trouver les espaces de travail

Demandez à votre client MCP :

Affichez les espaces de travail Postoria auxquels j’ai accès.

Le client doit lister les espaces de travail disponibles pour que vous puissiez choisir celui dans lequel travailler.

Trouver les comptes sociaux

Demandez à votre client MCP :

Affichez les comptes sociaux connectés à l’espace de travail ACME Studio.

Le client doit d’abord trouver l’espace de travail correspondant, puis lister les comptes sociaux connectés pour que vous puissiez choisir où publier.

Publier un texte

Demandez à votre client MCP :

Publiez ceci sur la page LinkedIn d’ACME Studio : Nous venons de publier un guide de planification des lancements pour les petites équipes. Il explique comment organiser les ressources de campagne, les validations et les publications programmées avant le jour du lancement.

Vérifiez l’espace de travail, le compte et le texte de la publication sélectionnés avant de confirmer l’action.

Programmer une publication

Demandez à votre client MCP :

Programmez une publication Instagram pour ACME Studio demain à 10 h avec l’image que j’ai jointe. Légende : Une simple checklist de lancement peut vous faire gagner des heures lorsque votre équipe prépare du contenu pour plusieurs canaux.

Le client doit préparer la publication programmée et vous présenter le compte, les médias et l’heure choisis avant la confirmation de la publication.

Ajouter une publication à une file d’attente

Demandez à votre client MCP :

Ajoutez cette publication avec image à la file Weekly Tips d’ACME Studio en utilisant l’image que j’ai jointe. Légende : Gardez une checklist de lancement réutilisable pour chaque campagne afin que votre équipe sache ce qui est validé, programmé et prêt à publier.

Le client doit trouver la file d’attente, préparer la publication avec le média sélectionné et l’ajouter à la file de publication choisie.

Lister les publications existantes

Demandez à votre client MCP :

Affichez les publications Instagram programmées dans l’espace de travail ACME Studio.

Le client peut utiliser list_posts avec des filtres tels que les identifiants de compte, l’identifiant de file d’attente, le statut de publication, les réseaux sociaux, la plage de dates, le nombre maximal de résultats et le curseur de pagination.

Sécurité et confirmation

Les clients IA peuvent aider à préparer les actions de publication, mais vous devez tout de même vérifier les détails importants avant de publier ou de programmer du contenu.

Avant de confirmer une action de publication, vérifiez :

  • L’espace de travail
  • Les comptes sociaux
  • Les files d’attente, si elles sont utilisées
  • La légende
  • Les médias
  • L’heure programmée et le fuseau horaire de l’espace de travail
  • Si l’action publie immédiatement ou programme une publication ultérieure

delete_post supprime la publication correspondante dans Postoria. Il ne retire pas le contenu déjà publié sur les réseaux sociaux. Utilisez-le uniquement lorsque vous êtes certain de vouloir supprimer la publication Postoria.

Code source et paquet

Le serveur MCP de Postoria est disponible en open source sur GitHub :

https://github.com/postoria-app/postoria-mcp-server

Le paquet npm est disponible ici :

https://www.npmjs.com/package/@postoria/mcp-server