> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Se connecter au MCP Server > Connectez n'importe quel client MCP au MCP Server Ayrshare — transport, endpoint et authentification. Le [MCP Server](/additional/mcp-action-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. ### 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](/additional/mcp-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 : ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp --header "Authorization: Bearer YOUR_API_KEY" ``` Pour cibler un sous-profil sur chaque appel, ajoutez l'en-tête optionnel `Profile-Key` : ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "Profile-Key: YOUR_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ête | Description | | ----------------------------- | ------------------------------------------------- | | `X-Twitter-OAuth1-Api-Key` | Votre OAuth 1.0a API Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | Votre 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](/apis/overview#xtwitter-byo-credentials) et le [guide de configuration des clés BYO X](/dashboard/connect-social-accounts/x-twitter-byo-keys) 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) : ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \ --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET" ``` ### 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`) : ```bash theme={"system"} claude mcp remove ayrshare claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \ --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET" ``` 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](/additional/mcp-claude-code-plugin#xtwitter-byo-credentials). ## Étapes suivantes Les 27 outils regroupés par domaine, avec leur portée et leur objectif. Installez le plugin Ayrshare pour Claude Code.