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.pro

Que pouvez-vous faire avec Postiz MCP ?

List connected social accounts — Ask the agent to retrieve all your linked platforms with integrationList, optionally filtered by customer group.
Check platform posting rules — Use integrationSchema to get character limits, supported media types, and settings for a specific platform before posting.
Schedule or publish posts — Create, draft, or immediately publish social media posts via schedulePostTool with platform-specific formatting.
Generate AI images for posts — Produce images directly through generateImageTool to attach to scheduled content.
Generate videos for posts — Explore available video options with generateVideoOptions and videoFunctionTool, then create videos using generateVideoTool.

Documentation

Introduction

Connectez des agents IA à Postiz en utilisant le Model Context Protocol (MCP)

MCP (Model Context Protocol) permet aux agents IA d'interagir directement avec Postiz — lister les intégrations, programmer 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.

Fonctionnement

Postiz expose un serveur MCP qui fournit 9 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`	Lister tous les comptes de réseaux sociaux connectés (filtrage optionnel par groupe)
`groupList`	Lister tous les groupes (clients) de votre organisation
`integrationSchema`	Obtenir les règles de publication et le schéma des paramètres spécifiques à la plateforme
`triggerTool`	Exécuter des assistants spécifiques à la plateforme (ex : lister les canaux Discord)
`schedulePostTool`	Programmer, créer un brouillon ou publier immédiatement des publications
`generateImageTool`	Générer des images IA pour les publications
`generateVideoOptions`	Lister les options de génération vidéo disponibles
`videoFunctionTool`	Obtenir les paramètres du générateur vidéo (ex : voix disponibles)
`generateVideoTool`	Générer des vidéos pour les publications

Authentification

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

Clé API

Obtenez votre clé API dans Paramètres > Développeurs > API publique dans Postiz. 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 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
```

Pour les instances auto-hébergées, remplacez `https://api.postiz.com` par votre `NEXT_PUBLIC_BACKEND_URL`.

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" — apprend les limites de caractères, les paramètres et les règles de X
L'agent appelle schedulePostTool — programme votre publication avec le format correct

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

"Programme une publication sur X pour demain à 10h : 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 que d'une OPENAI_API_KEY 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 renouvelée ?

Les clés API Postiz ne se renouvellent pas automatiquement, mais si vous en régénérez une dans Paramètres → Développeurs → API publique, chaque client MCP utilisant l'ancienne clé cesse 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 en tant que partie intégrante du backend Postiz et est accessible à /mcp (auth Bearer), /mcp/:apiKey (clé dans l'URL) et /mcp-oauth (protégé par OAuth). Votre proxy inverse doit transférer ces chemins vers le 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'y a pas de getComments ou replyToComment exposé via MCP. Les réponses aux commentaires doivent être déclenchées via l'interface utilisateur de Postiz.