Passer au contenu

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 Authorization en 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

  1. Ouvrez Paramètres → Agents IA et cliquez sur Nouveau jeton.
  2. Donnez-lui un nom reconnaissable (par exemple « Cursor sur mon portable ») et choisissez ses permissions.
  3. Copiez le jeton. Il n’est affiché qu’une seule fois. Si vous le perdez, révoquez-le et créez-en un nouveau.
  4. 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.

PermissionCe que l’assistant peut faire
Lecture (toujours activée)Voir les canaux, publications, médias et statistiques, et obtenir des suggestions d’horaires
ÉcritureCré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

OutilPermissionRôle
list_channelsLectureComptes et pages connectés sur lesquels vous pouvez publier
list_posts, get_postLectureBrouillons, publications programmées et publiées, avec liens et erreurs
get_analyticsLectureTotaux, répartition par plateforme, meilleurs horaires, meilleures publications
suggest_posting_timesLectureBons créneaux par plateforme
list_mediaLectureMédias importés récemment
generate_postÉcritureTexte de publication à partir d’un brief, éventuellement avec votre voix de marque
adapt_postÉcritureUn contenu réécrit pour chaque plateforme
create_imageÉcritureImages IA pour vos publications
upload_media, add_media_to_postÉcritureJoindre vos propres images et vidéos
create_post, update_postÉcritureCréer et modifier des brouillons ; indiquer une heure programme la publication (nécessite Publication)
publish_postPublicationPublier maintenant et renvoyer le lien de chaque plateforme
unschedule_postPublicationRemettre une publication programmée en brouillon
delete_postPublicationSupprimer 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 voyezPourquoiQue faire
401 / “invalid token”Le jeton est incorrect ou a été révoquéCréez un nouveau jeton et mettez à jour votre client
429Plus de 60 requêtes par minute depuis un jetonPatientez quelques secondes ; la réponse indique la durée
Un outil manqueLe jeton n’a pas la permission nécessaireCréez un jeton avec cette permission
scope_missingProgrammation ou publication sans la permission PublicationActivez Publication sur un nouveau jeton, ou programmez depuis l’application
quota_exceeded, credit_cap_exceededLa limite mensuelle de votre forfait est atteinteAttendez 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.