Retour aux Agents IA

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 Paramètres > Jetons API

Configuration pour Claude Code et Cursor

Ajoutez ceci à vos paramètres MCP et connectez-vous quand le navigateur s'ouvre. Pour Claude Code : <code>~/.claude/settings.json</code>. Pour Cursor : <code>.cursor/mcp.json</code>.

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/mcp

Ou 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 des Jetons API. Les clés commencent par adaptly_.

Configuration pour Claude Desktop

Claude Desktop se connecte via le pont <code>mcp-remote</code>, qui ouvre la page de connexion pour vous. Ajoutez ceci à votre <code>claude_desktop_config.json</code> :

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 <code>mcp-remote</code> 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/agent

Installe 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 18 outils. Votre IA les découvre automatiquement, demandez simplement en langage naturel.

OutilDescriptionParamètres clés
list_accountsListe tous les comptes de réseaux sociaux connectés avec leurs IDs, plateformes et noms d'utilisateur.None
upload_mediaTéléverse des médias depuis des URLs ou des données base64. Retourne des mediaUrls pour create_post.urls?, files?
get_upload_urlsObtient des URLs de téléversement présignées pour le téléchargement direct de fichiers vers le stockage.files (fileName + mimeType)
create_postCrée et planifie une publication sur une ou plusieurs plateformes.text, platforms, contentType, timezone, scheduledAt?, mediaUrls?, platformTexts?, saveAsDraft?, tiktokConfigs?, youtubeConfigs?, pinterestConfigs?
get_postObtient les détails complets d'une publication par ID.id
list_postsListe les publications avec des filtres optionnels par plateforme, statut ou période.statuses?, platforms?, startDate?, endDate?, sortOrder?, limit?, offset?
update_postMet à 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?, mediaUrls?, platformTexts?
delete_postSupprime une publication planifiée ou brouillon.id
publish_draftPublie un brouillon immédiatement ou le planifie pour plus tard.id, timezone, scheduledAt?
list_post_resultsVérifie les résultats de publication par plateforme, succès/échec avec détails des erreurs.id
retry_failed_platformsRéessaie la publication sur les plateformes qui ont échoué.id, platformIds
bulk_schedule_postsPlanifie plusieurs publications à la fois avec des plateformes et IDs de connexion partagés.platforms, timezone, posts[], connectionIds, platformConfigs?
get_analytics_overviewVues, 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_timeseriesLes mêmes indicateurs regroupés par jour, semaine ou mois, pour les questions de tendance.from, to, platforms?, granularity?
get_platform_breakdownLes mêmes indicateurs ventilés par plateforme, avec les indicateurs que chaque plateforme fournit.from, to
list_post_analyticsIndicateurs 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_statusDernière synchronisation de chaque compte et comptes à reconnecter pour les statistiques.None
trigger_analytics_syncActualise les statistiques maintenant. Une fois toutes les 10 minutes par espace de travail.None

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 des Jetons API. 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.