Postiz MCP

officiel

Optimisez vos réseaux sociaux avec Postiz. Planifiez vos publications, analysez les performances et gérez tous vos comptes en un seul endroit.

Que pouvez-vous faire avec Postiz MCP ?

  • Lister les comptes connectés — Demandez à l’agent de lister vos comptes de réseaux sociaux connectés, avec un filtrage facultatif par groupe.
  • Vérifier les règles des plateformes — Obtenez les règles de publication et le schéma des paramètres propres à chaque plateforme avant de rédiger une publication.
  • Programmer ou publier des publications — Programmez une publication, enregistrez-la comme brouillon ou publiez-la immédiatement sur un compte connecté.
  • Examiner les publications programmées — Listez les publications de votre organisation programmées entre deux dates, avec leurs paramètres actuels.
  • Générer des médias — Générez des images ou des vidéos par IA pour vos publications et listez les options de génération vidéo disponibles.
  • Découper de longues vidéos — Transformez une longue vidéo YouTube en clips verticaux sous-titrés et en brouillons de publications, puis vérifiez l’état du découpage.

Documentation

Introduction

Connectez les agents IA à Postiz à l’aide du Model Context Protocol (MCP)

MCP (Model Context Protocol) permet aux agents IA d’interagir directement avec Postiz : ils peuvent répertorier les intégrations, planifier des publications, générer des images et des vidéos, et découper de longues vidéos en clips courts, le tout via une interface standardisée d’appel d’outils.

Vous pouvez ainsi connecter Claude, ChatGPT, Cursor ou tout client compatible avec MCP à votre compte Postiz et gérer vos réseaux sociaux en langage naturel.

Fonctionnement

Postiz expose un serveur MCP qui fournit 13 outils aux agents IA. L’agent découvre ces outils, comprend leurs schémas et les appelle pour vous.

sequenceDiagram
    participant Agent as AI Agent
    participant MCP as Postiz MCP Server
    participant Postiz as Postiz Backend

    Agent->>MCP: Connect with API key / OAuth token
    MCP-->>Agent: List available tools
    Agent->>MCP: Call tool (e.g., schedule post)
    MCP->>Postiz: Execute action
    Postiz-->>MCP: Return result
    MCP-->>Agent: Tool response

Outils disponibles

OutilDescription
integrationListRépertorier tous les comptes de réseaux sociaux connectés (avec filtrage facultatif par groupe)
groupListRépertorier tous les groupes (clients) de votre organisation
integrationConnectToolObtenir un lien pour connecter un nouveau compte de réseau social
integrationSchemaObtenir les règles de publication et le schéma des paramètres propres à chaque plateforme
triggerToolExécuter des assistants propres à chaque plateforme (par exemple, répertorier les salons Discord)
schedulePostToolPlanifier, enregistrer comme brouillon ou publier immédiatement des publications
postsListToolRépertorier les publications de l’organisation planifiées entre deux dates (avec leurs paramètres actuels)
postSettingsToolMettre à jour les paramètres du fournisseur d’une publication planifiée ou d’un brouillon qui n’a pas encore été publié
generateImageToolGénérer des images IA pour les publications
generateVideoOptionsRépertorier les options de génération vidéo disponibles
videoFunctionToolObtenir les paramètres du générateur vidéo (par exemple, les voix disponibles)
generateVideoToolGénérer des vidéos pour les publications
clippingToolTransformer une longue vidéo YouTube en clips verticaux sous-titrés et en brouillons de publications
clippingStatusToolVérifier le découpage et récupérer les clips terminés

Authentification

Il existe deux façons de s’authentifier auprès du serveur MCP :

Clé API

Utilisez-la directement dans l’URL du point de terminaison MCP ou comme jeton Bearer.

Jeton OAuth

Si vous développez une application pour d’autres utilisateurs de Postiz, utilisez OAuth2 pour obtenir des jetons. Les jetons OAuth commencent par pos_ et fonctionnent comme des clés API.

Connexion

[tab] Jeton Bearer

Utilisez le point de terminaison /mcp avec votre clé API ou votre jeton OAuth comme jeton Bearer :

URL: https://mcp.postiz.com/mcp
Authorization: Bearer your-api-key

Cette méthode prend en charge les clés API et les jetons OAuth (préfixés par pos_).

[tab] Clé API dans l’URL

Utilisez le point de terminaison /mcp/:apiKey avec votre clé API intégrée à l’URL :

URL: https://mcp.postiz.com/mcp/your-api-key

Exemple rapide

Voici à quoi ressemble une interaction typique lorsqu’un agent IA utilise Postiz MCP :

  1. L’agent appelle integrationList et récupère vos comptes connectés (X, LinkedIn, etc.)
  2. L’agent appelle integrationSchema avec platform: "x" et découvre les limites de caractères, les paramètres et les règles de X
  3. L’agent appelle schedulePostTool et planifie votre publication au bon format

Tout cela se fait automatiquement lorsque vous demandez à votre agent IA, par exemple :

« Planifie une publication sur X pour demain à 10 h : Ravi d’annoncer notre nouvelle fonctionnalité ! »

FAQ

Ai-je besoin d’une clé OpenAI pour utiliser Postiz MCP ?

Non. Le serveur MCP expose simplement les outils de Postiz. Votre client IA (Claude, ChatGPT, Cursor, etc.) fournit le modèle. Postiz n’a besoin d’un OPENAI_API_KEY que si vous utilisez ses propres fonctionnalités d’IA (génération d’images, copilote), qui sont distinctes des outils MCP mis à la disposition de votre client.

Que se passe-t-il lorsque ma clé API expire ou est renouvelée ?

Les clés API Postiz ne sont pas renouvelées automatiquement. Toutefois, si vous en générez une nouvelle dans Settings → Developers → Public API, tous les clients MCP utilisant l’ancienne clé cesseront de fonctionner jusqu’à la mise à jour de leur configuration. Mettez à jour l’URL ou l’en-tête Authorization dans la configuration de votre client, puis reconnectez-vous.

Auto-hébergement : comment exposer le point de terminaison MCP ?

Le serveur MCP démarre avec le backend Postiz et est accessible à l’adresse /mcp (authentification Bearer), /mcp/:apiKey (clé dans l’URL) et /mcp-oauth (protégé par OAuth). Votre proxy inverse doit transmettre ces chemins au backend et prendre en charge le streaming HTTP (Transfer-Encoding: chunked). Consultez Reverse Proxies.

MCP peut-il lire les commentaires ou y répondre ?

Pas pour le moment. L’ensemble actuel d’outils permet uniquement la lecture des intégrations et l’écriture des publications et des médias. Aucun getComments ni replyToComment n’est exposé via MCP. Les réponses aux commentaires doivent être déclenchées depuis l’interface Postiz.

Cette documentation est créée et hébergée sur Mintlify, une plateforme de documentation pour développeurs.