Guide de configuration MCP
Connectez AdaptlyPost à votre assistant IA en moins d'une minute. Collez l'URL, connectez-vous à l'invite et commencez à publier.
Prérequis
Un compte AdaptlyPost actif s'inscrire
Au moins un compte de réseau social connecté
Optionnel : un jeton API pour les agents headless et les clients sans OAuth, depuis Gérer > API et agents IA
Configuration pour Claude Code et Cursor
Ajoutez ceci à vos paramètres MCP et connectez-vous quand le navigateur s'ouvre. Pour Claude Code : ~/.claude/settings.json. Pour Cursor : .cursor/mcp.json.
MCP config
{
"mcpServers": {
"adaptlypost": {
"type": "http",
"url": "https://mcp.adaptlypost.com/mcp"
}
}
}Claude Code CLI
claude mcp add --transport http adaptlypost https://mcp.adaptlypost.com/mcpOu utilisez la commande CLI Claude Code en une ligne. Elle ouvre la page de connexion à la première utilisation :
Alternative avec clé API
{
"mcpServers": {
"adaptlypost": {
"type": "http",
"url": "https://mcp.adaptlypost.com/mcp",
"headers": {
"Authorization": "Bearer adaptly_your_key"
}
}
}
}Pour les agents headless ou les clients sans OAuth, ajoutez un en-tête Authorization avec un jeton de la page API et agents IA. Les clés commencent par adaptly_.
Configuration pour Claude Desktop
Claude Desktop se connecte via le pont mcp-remote, qui ouvre la page de connexion pour vous. Ajoutez ceci à votre claude_desktop_config.json :
claude_desktop_config.json
{
"mcpServers": {
"adaptlypost": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.adaptlypost.com/mcp"]
}
}
}Configuration pour d'autres clients MCP
Tout client MCP prenant en charge le transport HTTP peut se connecter directement.
Endpoint
https://mcp.adaptlypost.com/mcp
Authentification
Connectez-vous à l'invite (OAuth), ou envoyez Authorization: Bearer adaptly_your_key
Transport
HTTP (Streamable HTTP)
Sans en-tête Bearer, le serveur répond 401 avec un en-tête WWW-Authenticate, donc les clients compatibles OAuth ouvrent la page de connexion d'eux-mêmes.
Pour les clients qui ne prennent en charge que le transport stdio, utilisez le pont mcp-remote comme indiqué dans la section Claude Desktop.
Alternative : Agent Skill
Pour Claude Code, Cursor, Windsurf et Codex, vous pouvez également installer AdaptlyPost en tant qu'agent skill, aucune configuration MCP nécessaire.
npx skills add adaptlypost/agentInstalle un SKILL.md et un script CLI qui enseigne à votre agent l'API AdaptlyPost. Voir sur GitHub
Référence des outils
Le serveur MCP expose 33 outils. Votre IA les découvre automatiquement, demandez simplement en langage naturel.
| Outil | Description | Paramètres clés |
|---|---|---|
| list_workspaces | Liste les espaces de travail dans lesquels votre connexion peut agir. Passez un id comme workspaceId à n'importe quel autre outil pour travailler dans cet espace de travail. | None |
| list_accounts | Liste les comptes de réseaux sociaux connectés avec leurs IDs, plateformes, noms d'utilisateur et statut. Un compte marqué unauthorized doit être reconnecté avant de pouvoir publier. | None |
| upload_media | Téléverse des médias depuis des URLs ou des données base64. Retourne des mediaUrls pour create_post. | urls?, files? |
| get_upload_urls | Obtient des URLs de téléversement présignées pour le téléchargement direct de fichiers vers le stockage. | files (fileName + mimeType) |
| open_upload_widget | Affiche une zone de téléversement dans ChatGPT ou Claude pour que l'utilisateur ajoute des photos, vidéos ou documents depuis son appareil. À la fin, la zone renvoie les mediaUrls. | None |
| get_upload_ticket | Appelé par la zone de téléversement une fois par fichier. Invisible pour l'IA. | None |
| create_post | Crée une publication pour une ou plusieurs plateformes : publication immédiate, planifiée, en brouillon ou répétée chaque jour, semaine, mois ou année. | platforms, contentType, timezone, text?, scheduledAt?, saveAsDraft?, recurrence?, mediaUrls?, mediaAltTexts?, platformTexts?, *ConnectionIds, pageIds?, *Configs? |
| get_post | Obtient les détails complets d'une publication par ID. | id |
| list_posts | Liste les publications avec des filtres optionnels par plateforme, statut ou période. | statuses?, platforms?, startDate?, endDate?, sortOrder?, limit?, offset? |
| update_post | Met à jour le texte, la planification, les médias ou les configurations de plateforme d'une publication planifiée ou brouillon. | id, text?, platforms?, contentType?, scheduledAt?, timezone?, mediaUrls?, mediaAltTexts?, platformTexts?, *ConnectionIds, *Configs? |
| delete_post | Supprime une publication. Une publication planifiée ne partira pas ; une publication déjà parue reste en ligne sur les réseaux. | id |
| unschedule_post | Retire une publication programmée du calendrier et la garde comme brouillon sans date. | id |
| publish_draft | Publie un brouillon immédiatement ou le planifie pour plus tard. | id, timezone, scheduledAt? |
| list_post_results | Vérifie les résultats de publication par plateforme, succès/échec avec détails des erreurs. | id |
| retry_failed_platforms | Réessaie la publication sur les plateformes qui ont échoué. | id, platformIds? |
| bulk_schedule_posts | Planifie plusieurs publications à la fois avec des plateformes et IDs de connexion partagés. | platforms, timezone, posts[], *ConnectionIds, pageIds?, *Configs? |
| list_recurring_posts | Liste les publications récurrentes (séries) avec leur statut, leur calendrier et la prochaine occurrence. | statuses?, limit?, offset? |
| get_recurring_post | Récupère une publication récurrente par ID, avec la raison de la pause et la prochaine date. | id |
| pause_recurring_post | Met une série en pause et supprime sa prochaine publication planifiée. | id |
| resume_recurring_post | Reprend une série en pause à partir de la prochaine date. Les dates manquées sont ignorées. | id |
| delete_recurring_post | Arrête une série définitivement. Les publications déjà parues sont conservées. | id |
| get_analytics_overview | Vues, likes, commentaires, partages, abonnés et taux d'engagement sur une période, chacun comparé à la période précédente. | from, to, platforms? |
| get_analytics_timeseries | Les mêmes indicateurs regroupés par jour, semaine ou mois, pour les questions de tendance. | from, to, platforms?, granularity? |
| get_platform_breakdown | Les mêmes indicateurs ventilés par plateforme, avec les indicateurs que chaque plateforme fournit. | from, to |
| list_post_analytics | Indicateurs par publication, triables selon chaque indicateur. Meilleures publications et "comment cette publication a-t-elle marché". | from, to, platforms?, sortBy?, page?, limit? |
| get_analytics_sync_status | Dernière synchronisation de chaque compte et comptes à reconnecter pour les statistiques. | None |
| trigger_analytics_sync | Actualise les statistiques maintenant. Une fois toutes les 10 minutes par espace de travail. | None |
| generate_caption | Rédige une légende à partir d'un prompt, dans la limite de caractères de la plateforme choisie. Coûte 2 crédits IA. | prompt, platform? |
| refine_caption | Réécrit une légende existante selon une consigne comme "plus courte", ou termine une légende commencée. Coûte 2 crédits IA. | prompt, originalText, partialText?, platform? |
| generate_image | Lance une image IA et renvoie tout de suite un ID de tâche. 2 crédits IA en standard, 4 en premium, remboursés en cas d'échec. | prompt, aspectRatio?, model?, quality?, sessionId?, referenceImages? |
| get_image_job | Suit une tâche d'image jusqu'à ce qu'elle soit terminée, avec une URL publique prête pour la publication, ou en échec. | jobId |
Gestion de l'accès
Les agents connectés perdent l'accès quand vous retirez le connecteur dans votre client ou vous déconnectez. Vous pouvez consulter et révoquer les jetons API à tout moment depuis votre page API et agents IA. La révocation d'un jeton déconnecte immédiatement tout agent qui l'utilise.
Prêt à vous connecter ?
Collez l'URL dans vos paramètres MCP, connectez-vous une fois et commencez à publier depuis votre IA.