Postiz MCP

Introduction

Connectez des agents IA à Postiz à l'aide du protocole de contexte de modèle (MCP)

MCP (Model Context Protocol) permet aux agents IA d'interagir directement avec Postiz, de lister les intégrations, de planifier des publications, de générer des images et des vidéos, de découper de longues vidéos en courts métrages, 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 13 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 (éventuellement filtrés par groupe)
groupList	Lister tous les groupes (clients) de votre organisation
integrationSchema	Obtenir les règles de publication et le schéma de paramètres spécifiques à la plateforme
triggerTool	Exécuter des assistants spécifiques à la plateforme (par exemple, lister les canaux Discord)
schedulePostTool	Planifier, rédiger ou publier immédiatement des publications
postsListTool	Lister 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 non encore publié
generateImageTool	Générer des images IA pour les publications
generateVideoOptions	Lister les options disponibles de génération de vidéos
videoFunctionTool	Obtenir les paramètres du générateur de vidéos (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 rédiger des brouillons de publications
clippingStatusTool	Vérifier un découpage et obtenir 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 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 :

```text theme={null}
URL: https://mcp.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 :

```text theme={null}
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, reçoit vos comptes connectés (X, LinkedIn, etc.)
2. L'agent appelle integrationSchema avec platform: "x" et apprend les limites de caractères, les paramètres et les règles de X
3. 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 propres fonctionnalités IA de Postiz (génération d'images, copilote), qui sont distinctes des outils MCP présenté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 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 Postiz.

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