Passer au contenu principal
Le MCP Server Ayrshare permet à un agent IA de piloter l’API Ayrshare. Cette page explique comment vous y connecter et comment fonctionne l’authentification.

​
Endpoint et transport

Le MCP Server de production est disponible à l’adresse : https://api.ayrshare.com/mcp Il utilise le transport Streamable HTTP et est sans état — il n’y a pas de session à maintenir entre les appels.

​
Authentification

L’authentification est appliquée par la même chaîne d’API Ayrshare qui alimente l’API REST.
  • Requis : Authorization: Bearer YOUR_API_KEY — l’API Key de votre compte (clé Business Plan pour les profils et sous-profils).
  • Optionnel : Profile-Key: YOUR_PROFILE_KEY — cible un sous-profil pour chaque appel sur la connexion.
  • Optionnel par appel : un argument d’outil profileKey — cible un sous-profil pour un seul appel d’outil.

​
Priorité : l’argument l’emporte sur l’en-tête

Lorsqu’un appel d’outil inclut un argument profileKey et que la connexion possède un en-tête Profile-Key, l’argument profileKey par appel l’emporte. L’en-tête n’est utilisé que lorsqu’aucun argument valide n’est fourni. Une exception : sur get_platform_history et get_social_network_analytics, une recherche X/Twitter par userId/userName doit utiliser uniquement l’API Key du compte ; fournir un argument profileKey ou un en-tête Profile-Key dans ce cas renvoie l’erreur 400.
Les méthodes MCP initialize et tools/list sont accessibles avant l’authentification — elles renvoient uniquement des métadonnées et n’exécutent rien. Chaque appel d’outil est authentifié.

​
Erreurs d’authentification

Une clé non authentifiée ou invalide sur un appel d’outil renvoie une erreur 403 / code 102 d’Ayrshare avec le message « API Key not valid ». Conformément à la spécification MCP, les erreurs d’exécution d’outil sont renvoyées en flux : le résultat de l’outil porte isError: true et ce message, tandis que le transport MCP lui-même répond HTTP 200. (Les 403/102 correspondent à l’erreur applicative Ayrshare, et non au statut du transport.)

​
Se connecter

​
Option A : plugin Claude Code

Si vous utilisez Claude Code, installez le plugin Ayrshare. Il regroupe la configuration du MCP Server, une commande de configuration, des agents, des compétences et un hook de confirmation. Consultez la page Claude Code Plugin pour les étapes d’installation complètes.

​
Option B : n’importe quel client MCP

Pour tout client MCP prenant en charge le Streamable HTTP, enregistrez le serveur directement. Dans Claude Code :
Pour cibler un sous-profil sur chaque appel, ajoutez l’en-tête optionnel Profile-Key :
La connexion MCP s’initialise au démarrage de la session. Redémarrez votre client MCP après avoir installé le serveur ou modifié votre clé afin que la nouvelle configuration prenne effet.

​
Identifiants X/Twitter BYO

Depuis le 31 mars 2026, les opérations X/Twitter via Ayrshare nécessitent vos propres identifiants OAuth 1.0a. Lorsqu’un appel d’outil cible X/Twitter, transmettez ces deux en-têtes sur la connexion aux côtés de vos en-têtes Authorization (et Profile-Key optionnel) :
En-têteDescription
X-Twitter-OAuth1-Api-KeyVotre OAuth 1.0a API Key (Consumer Key)
X-Twitter-OAuth1-Api-SecretVotre OAuth 1.0a API Key Secret (Consumer Secret)
Ce sont les mêmes en-têtes que ceux utilisés par l’API REST — une paire de clés OAuth 1.0a par compte Ayrshare, envoyée sur chaque requête ciblant X (la même paire s’applique à tous les sous-profils). Ayrshare n’utilise pas OAuth 2.0 ici. Consultez la présentation de l’API et le guide de configuration des clés BYO X pour la configuration, la politique et le dépannage.
Sans ces en-têtes, un appel d’outil X/Twitter renvoie l’erreur 419 (x_credentials_required).

​
Se connecter avec les en-têtes BYO

Pour configurer les identifiants BYO X/Twitter dès le départ, ajoutez le serveur avec les deux en-têtes OAuth 1.0a aux côtés de votre en-tête Authorization (incluez également Profile-Key si vous ciblez un sous-profil sur chaque appel) :

​
Ajouter les en-têtes BYO à une connexion existante

Les en-têtes de connexion sont figés au moment de l’ajout du serveur ; si vous êtes déjà connecté sans les en-têtes BYO, supprimez le serveur et rajoutez-le avec l’ensemble complet (réincluez tous les en-têtes que vous utilisiez déjà, comme Profile-Key) :
Redémarrez votre client MCP après avoir modifié les en-têtes afin que la nouvelle configuration prenne effet. Vous utilisez le plugin Claude Code plutôt qu’une connexion brute ? Consultez Claude Code Plugin → Identifiants X/Twitter BYO.

​
Étapes suivantes

Tool Catalog

Les 27 outils regroupés par domaine, avec leur portée et leur objectif.

Claude Code Plugin

Installez le plugin Ayrshare pour Claude Code.