Skip to main content
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.

​
Clients pris en charge

L’Action MCP Server s’authentifie uniquement avec un en-tête de requête statique Authorization: Bearer. Cette seule exigence détermine tout ce qui suit : un client capable de définir un en-tête HTTP personnalisé sur une connexion Streamable HTTP peut s’authentifier, et un client qui ne le peut pas, ne le peut pas. Identifiez votre client avant de commencer la configuration.

​
Pourquoi les connecteurs personnels ne peuvent pas s’authentifier

L’Action MCP d’Ayrshare nécessite un en-tête Authorization: Bearer statique. L’ajouter comme connecteur personnalisé personnel sur claude.ai, Claude Desktop ou Claude mobile ne fonctionne pas, car Ayrshare ne publie aucune métadonnée OAuth et l’alternative par en-tête de requête est une bêta limitée aux organisations approuvées. Sur un connecteur personnel, aucun réglage de votre côté ne corrige cela : il n’existe pas de champ pour un en-tête Authorization, ni d’API Key, de profil ou de paramètre de compte qui en active un. Ayrshare ne publie aucune métadonnée OAuth, le parcours OAuth du connecteur n’a donc rien à quoi se connecter. Utilisez plutôt un client du tableau ci-dessus : Claude Code, le plugin Claude Code, ou tout client vous permettant de définir un en-tête Authorization personnalisé. Si vous êtes administrateur d’une organisation participant à la bêta des en-têtes de requête d’Anthropic, consultez Organisations Team et Enterprise ci-dessous.
Si votre connecteur semble sain mais que chaque outil échoue. Le connecteur s’ajoute sans erreur, se déclare sain et liste le catalogue d’outils complet — puis chaque appel d’outil renvoie l’erreur Ayrshare 403 / code 102, « API Key not valid ». Il s’agit de cette limitation, et non d’une clé défectueuse — votre client ne peut pas envoyer l’en-tête Authorization: Bearer statique que ce serveur exige. initialize et tools/list sont accessibles avant l’authentification (consultez Authentification ci-dessous), donc rien n’échoue avant le premier appel d’outil, où il devient clair qu’aucun identifiant n’a jamais été envoyé.Capacité du client, ou clé réellement invalide ? Les deux renvoient une erreur identique ; utilisez donc la signature pour les distinguer. Un échec dû à la capacité du client signifie que le connecteur est sain et que chaque outil échoue, alors que la même clé fonctionne ailleurs. Une clé invalide produit la même erreur mais est reproductible en dehors du connecteur — elle échoue aussi sur un appel REST. Pour la sémantique de l’erreur elle-même, consultez Erreurs d’authentification ci-dessous.

​
Organisations Team et Enterprise

Le mécanisme static_headers d’Anthropic permet à un connecteur personnalisé d’envoyer un identifiant fixe comme en-tête de requête au lieu d’utiliser OAuth. Il est disponible en bêta pour les administrateurs d’organisation dans un ensemble limité d’organisations, et il n’est pas disponible pour les utilisateurs individuels qui ajoutent un connecteur personnel. Si votre organisation y a accès, l’administrateur doit saisir la valeur de l’en-tête sous la forme Bearer suivi de votre API Key Ayrshare, espace compris — Claude envoie la valeur exactement telle que saisie et n’ajoute pas le schéma pour vous. Pour la disponibilité actuelle et la configuration, consultez la documentation d’Anthropic sur l’authentification des connecteurs.
La clé est partagée par toute l’organisation. L’identifiant par en-tête de requête d’Anthropic est saisi une seule fois par un administrateur et utilisé par chaque membre de l’organisation ; tous agissent donc comme l’unique compte Ayrshare auquel cette clé appartient — avec accès à chaque User Profile qui en dépend sur une clé Business, et sans attribution par utilisateur dans votre historique ou vos analyses Ayrshare. Traitez-la comme un identifiant de service partagé, et non comme un accès individuel.

​
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 et vous permettant de définir un en-tête de requête personnalisé — consultez Clients pris en charge ci-dessus — 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) : 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 33 outils regroupés par domaine, avec leur portée et leur objectif.

Claude Code Plugin

Installez le plugin Ayrshare pour Claude Code.