Postiz MCP
officielOptimisez 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
| Outil | Description |
|---|---|
integrationList | Répertorier tous les comptes de réseaux sociaux connectés (avec filtrage facultatif par groupe) |
groupList | Répertorier tous les groupes (clients) de votre organisation |
integrationConnectTool | Obtenir un lien pour connecter un nouveau compte de réseau social |
integrationSchema | Obtenir les règles de publication et le schéma des paramètres propres à chaque plateforme |
triggerTool | Exécuter des assistants propres à chaque plateforme (par exemple, répertorier les salons Discord) |
schedulePostTool | Planifier, enregistrer comme brouillon ou publier immédiatement des publications |
postsListTool | Répertorier les publications de l’organisation planifiées entre deux dates (avec leurs paramètres actuels) |
postSettingsTool | Mettre à jour les paramètres du fournisseur d’une publication planifiée ou d’un brouillon qui n’a pas encore été publié |
generateImageTool | Générer des images IA pour les publications |
generateVideoOptions | Répertorier les options de génération vidéo disponibles |
videoFunctionTool | Obtenir les paramètres du générateur vidéo (par exemple, les voix disponibles) |
generateVideoTool | Générer des vidéos pour les publications |
clippingTool | Transformer une longue vidéo YouTube en clips verticaux sous-titrés et en brouillons de publications |
clippingStatusTool | Vé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
/mcpavec votre clé API ou votre jeton OAuth comme jeton Bearer :URL: https://mcp.postiz.com/mcp Authorization: Bearer your-api-keyCette 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/:apiKeyavec 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 :
- L’agent appelle
integrationListet récupère vos comptes connectés (X, LinkedIn, etc.) - L’agent appelle
integrationSchemaavecplatform: "x"et découvre les limites de caractères, les paramètres et les règles de X - L’agent appelle
schedulePostToolet 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.