Agents IA (MCP)
PostClaw propose un serveur Model Context Protocol distant. Connectez-y un assistant IA et demandez-lui simplement : « écris trois publications pour la semaine prochaine et programme-les sur ma page Facebook ». L’assistant consulte vos canaux, rédige les publications et les place dans votre calendrier, en votre nom.
Disponible sur tous les forfaits, y compris Free. Les limites de votre forfait s’appliquent exactement comme dans l’application.
Ce qu’il vous faut
- Un compte PostClaw avec au moins un canal connecté.
- Un client MCP capable d’envoyer un en-tête
Authorizationen Streamable HTTP : Claude Code, Cursor, VS Code et la plupart des autres clients MCP. - Un jeton créé dans Paramètres → Agents IA.
Claude.ai et ChatGPT dans le navigateur ne sont pas encore pris en charge. Ils nécessitent une connexion OAuth, qui est prévue.
Connexion en deux minutes
- Ouvrez Paramètres → Agents IA et cliquez sur Nouveau jeton.
- Donnez-lui un nom reconnaissable (par exemple « Cursor sur mon portable ») et choisissez ses permissions.
- Copiez le jeton. Il n’est affiché qu’une seule fois. Si vous le perdez, révoquez-le et créez-en un nouveau.
- Ajoutez le serveur à votre client. La page des paramètres affiche ces extraits avec votre jeton déjà renseigné.
URL du serveur: https://app.postclaw.fun/mcp
Claude Code
claude mcp add --transport http postclaw https://app.postclaw.fun/mcp --header "Authorization: Bearer YOUR_TOKEN"
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"postclaw": {
"url": "https://app.postclaw.fun/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}
VS Code (.vscode/mcp.json)
{
"servers": {
"postclaw": {
"type": "http",
"url": "https://app.postclaw.fun/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}
Demandez ensuite à votre assistant quelque chose comme « Quels canaux ai-je dans PostClaw ? » pour vérifier la connexion.
Permissions
Chaque jeton a ses propres permissions. L’assistant ne voit que les outils autorisés par son jeton.
| Permission | Ce que l’assistant peut faire |
|---|---|
| Lecture (toujours activée) | Voir les canaux, publications, médias et statistiques, et obtenir des suggestions d’horaires |
| Écriture | Créer et modifier des brouillons, importer des médias, rédiger avec l’IA, créer des images IA |
| Publication (désactivée par défaut) | Programmer, publier, déprogrammer et supprimer des publications sur vos vrais comptes |
Sans Publication, un assistant ne peut que laisser des brouillons que vous relisez et approuvez dans PostClaw. Activez-la uniquement pour les assistants à qui vous confiez la publication en votre nom.
Vous pouvez avoir jusqu’à 10 jetons actifs. La révocation prend effet à la requête suivante de l’assistant.
Outils
| Outil | Permission | Rôle |
|---|---|---|
list_channels | Lecture | Comptes et pages connectés sur lesquels vous pouvez publier |
list_posts, get_post | Lecture | Brouillons, publications programmées et publiées, avec liens et erreurs |
get_analytics | Lecture | Totaux, répartition par plateforme, meilleurs horaires, meilleures publications |
suggest_posting_times | Lecture | Bons créneaux par plateforme |
list_media | Lecture | Médias importés récemment |
generate_post | Écriture | Texte de publication à partir d’un brief, éventuellement avec votre voix de marque |
adapt_post | Écriture | Un contenu réécrit pour chaque plateforme |
create_image | Écriture | Images IA pour vos publications |
upload_media, add_media_to_post | Écriture | Joindre vos propres images et vidéos |
create_post, update_post | Écriture | Créer et modifier des brouillons ; indiquer une heure programme la publication (nécessite Publication) |
publish_post | Publication | Publier maintenant et renvoyer le lien de chaque plateforme |
unschedule_post | Publication | Remettre une publication programmée en brouillon |
delete_post | Publication | Supprimer une publication de PostClaw |
Les médias doivent être une URL https:// ou un fichier envoyé via upload_media.
create_post et publish_post acceptent un idempotency_key facultatif. Si l’assistant renvoie un appel avec la même clé dans les 24 heures, PostClaw renvoie le premier résultat au lieu de créer ou publier deux fois.
Limites et crédits
Un assistant travaille avec le même forfait que vous dans l’application :
- Les publications par mois, les crédits IA et le quota d’images comptent de la même façon dans PostClaw et via un assistant.
- Les outils IA utilisent votre propre clé IA si vous en avez connecté une dans les paramètres.
- Chaque jeton peut envoyer jusqu’à 60 requêtes par minute.
- Chaque appel est enregistré dans votre compte.
Dépannage
| Ce que vous voyez | Pourquoi | Que faire |
|---|---|---|
401 / “invalid token” | Le jeton est incorrect ou a été révoqué | Créez un nouveau jeton et mettez à jour votre client |
429 | Plus de 60 requêtes par minute depuis un jeton | Patientez quelques secondes ; la réponse indique la durée |
| Un outil manque | Le jeton n’a pas la permission nécessaire | Créez un jeton avec cette permission |
scope_missing | Programmation ou publication sans la permission Publication | Activez Publication sur un nouveau jeton, ou programmez depuis l’application |
quota_exceeded, credit_cap_exceeded | La limite mensuelle de votre forfait est atteinte | Attendez la période suivante ou passez à un forfait supérieur |
| ”your … configuration failed” | Votre propre clé IA a renvoyé une erreur (quota, facturation, connexion expirée) | Corrigez ou supprimez la clé dans Paramètres → Providers |
Protégez vos jetons
Un jeton agit en votre nom. Traitez-le comme un mot de passe :
- Ne le commitez pas dans un dépôt et ne le collez pas dans des discussions partagées.
- Utilisez un jeton par appareil ou par outil, pour pouvoir en révoquer un sans affecter les autres.
- Révoquez les jetons inutilisés dans Paramètres → Agents IA.