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.

Voir sur postiz.proEssayer ce MCPSponsorisé

Que pouvez-vous faire avec Postiz MCP ?

Avec Postiz MCP, vous pouvez demander à votre assistant IA de gérer les publications sur les réseaux sociaux et de générer des médias directement.

Lister les comptes connectés — Demandez tous les comptes de réseaux sociaux connectés via integrationList, éventuellement filtrés par groupe.
Obtenir les règles de la plateforme — Utilisez integrationSchema pour récupérer les règles de publication et les paramètres d'une plateforme comme X.
Planifier des publications — Utilisez schedulePostTool pour planifier, mettre en brouillon ou publier des publications immédiatement.
Lister les publications planifiées — Utilisez postsListTool pour voir les publications planifiées entre deux dates.
Générer des images — Utilisez generateImageTool pour créer des images IA pour les publications.
Générer des vidéos — Utilisez generateVideoTool pour produire des vidéos, avec des options issues de generateVideoOptions.

Documentation

Introduction

Connectez des agents IA à Postiz à l'aide du Model Context Protocol (MCP)

MCP (Model Context Protocol) permet aux agents IA d'interagir directement avec Postiz : lister les intégrations, planifier des publications, générer des images et des vidéos, le tout via une interface standardisée d'appel d'outils.

Cela signifie que vous pouvez connecter Claude, ChatGPT, Cursor ou tout client compatible MCP à votre compte Postiz et gérer vos réseaux sociaux en langage naturel.

Comment ça fonctionne

Postiz expose un serveur MCP qui fournit 11 outils aux agents IA. L'agent découvre ces outils, comprend leurs schémas et les appelle en votre nom.

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`	Liste tous les comptes de réseaux sociaux connectés (éventuellement filtrés par groupe)
`groupList`	Liste tous les groupes (clients) de votre organisation
`integrationSchema`	Obtient les règles de publication et le schéma de paramètres spécifiques à la plateforme
`triggerTool`	Exécute des assistants spécifiques à la plateforme (par ex., lister les canaux Discord)
`schedulePostTool`	Planifie, met en brouillon ou publie immédiatement des publications
`postsListTool`	Liste les publications planifiées de l'organisation entre deux dates (avec leurs paramètres actuels)
`postSettingsTool`	Met à jour les paramètres du fournisseur d'une publication planifiée ou d'un brouillon non encore publié
`generateImageTool`	Génère des images IA pour les publications
`generateVideoOptions`	Liste les options de génération vidéo disponibles
`videoFunctionTool`	Obtient les paramètres du générateur vidéo (par ex., les voix disponibles)
`generateVideoTool`	Génère des vidéos pour les publications

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 créez une application pour d'autres utilisateurs de Postiz, utilisez OAuth2 pour obtenir des jetons. Les jetons OAuth commencent par pos_ et fonctionnent de la même manière que les clés API.

Connexion

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

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

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

Utilisez le point de terminaison `/mcp/:apiKey` avec votre clé API intégrée dans l'URL :

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

Exemple rapide

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

L'agent appelle integrationList, récupère vos comptes connectés (X, LinkedIn, etc.)
L'agent appelle integrationSchema avec platform: "x" et apprend les limites de caractères, les paramètres et les règles de X
L'agent appelle schedulePostTool, planifie votre publication avec le format correct

Tout cela se produit automatiquement lorsque vous dites à votre agent IA quelque chose comme :

« Planifie une publication sur X pour demain à 10h : Nous sommes ravis 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 les fonctionnalités IA propres à Postiz (génération d'images, copilote), qui sont distinctes des outils MCP exposés à votre client.

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

Les clés API Postiz ne sont pas automatiquement régénérées, mais si vous en régénérez une dans Paramètres → Développeurs → API publique, chaque client MCP utilisant l'ancienne clé cessera de fonctionner jusqu'à ce que vous mettiez à jour sa configuration. Mettez à jour l'URL ou l'en-tête Authorization dans la configuration de votre client et reconnectez-vous.

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

Le serveur MCP démarre dans le cadre du backend Postiz et est accessible à /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). Voir Reverse Proxies.

MCP peut-il lire ou répondre aux commentaires ?

Pas pour le moment. L'ensemble d'outils actuel est en lecture seule sur les intégrations et en écriture seule sur les publications/médias. Il n'existe pas de getComments ni de replyToComment exposés via MCP. Les réponses aux commentaires doivent être déclenchées via l'interface Postiz.