> ## 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.

# n8n

> Connectez l'agent IA de n8n au MCP Server Ayrshare pour publier, planifier et analyser sur 13 réseaux sociaux, sans code d'API par plateforme.

export const XByoNotice = () => <Info>
  <strong>Targeting X/Twitter?</strong> Starting March 31, 2026, all X operations require your own API credentials. After linking X via OAuth, include these 2 headers in your request:
  <br /><br />
  <code>X-Twitter-OAuth1-Api-Key</code> — Your API Key (Consumer Key)<br />
  <code>X-Twitter-OAuth1-Api-Secret</code> — Your API Key Secret (Consumer Secret)
  <br /><br />
  <strong>One-time setup per Ayrshare account.</strong> You create one X Developer App and reuse the same API Key and Secret across every sub-profile / end-user you link. You do <em>not</em> create a new app per customer.
  <br /><br />
  Not linked yet? See the <a href="/dashboard/connect-social-accounts/x-twitter-byo-keys">full setup guide</a> to connect your X account.
  <br /><br />
  Your keys are never logged or stored by Ayrshare.
</Info>;

n8n est l'endroit où vous câblez vos outils entre eux. Ayrshare est l'API unique qui publie sur Facebook, Instagram, LinkedIn, YouTube, TikTok, Pinterest, Reddit, Threads, Bluesky, Telegram, Google Business Profile, Snapchat et X en un seul appel. Connectez-les avec le [MCP Server Ayrshare](/additional/mcp-action-server) et votre agent IA n8n peut exécuter toute la boucle lui-même : rédiger une publication, la valider par rapport aux règles de chaque réseau, la publier ou la planifier, puis relire les statistiques.

<img class="center" src="https://mintcdn.com/ayrshare-docs/bAaTGuhaX8NvaXu8/images/packages-guides/n8n-mcp-workflow.webp?fit=max&auto=format&n=bAaTGuhaX8NvaXu8&q=85&s=a04e6040568f404db97046feb0066c53" alt="Le workflow de démarrage n8n sur le canevas : un déclencheur de chat vers un AI Agent, avec un modèle de chat Anthropic et le nœud d'outil MCP Ayrshare attachés en dessous, ainsi que des sticky notes de configuration et d'utilisation." width="2000" height="1100" data-path="images/packages-guides/n8n-mcp-workflow.webp" />

Puisque le MCP Server est un endpoint Streamable HTTP hébergé, vous le connectez avec le nœud **MCP Client Tool** intégré à n8n. Il n'y a rien à héberger, aucun code personnalisé et aucun nœud communautaire à installer. Vous pointez un nœud vers une URL et votre agent obtient les 27 outils sociaux.

<Card title="Télécharger le workflow de démarrage n8n" icon="download" href="/files/ayrshare-n8n-mcp-workflow.json" horizontal>
  Le workflow présenté ci-dessus, prêt à être importé : Chat Trigger, AI Agent, un modèle de chat Anthropic et le nœud MCP Ayrshare précâblé avec le prompt système « validate-first ».
</Card>

Pour l'utiliser : dans n8n, **Workflows → Import from file**, sélectionnez le JSON, puis créez les deux credentials qu'il attend (un credential **Bearer Auth** contenant votre clé Ayrshare, et un credential **Anthropic API**). Les deux badges d'avertissement disparaissent une fois les credentials attachés. Les instances auto-hébergées ont besoin d'un accès sortant vers `api.ayrshare.com` et vers votre fournisseur de modèle.

Ce guide couvre le chemin MCP-first de bout en bout. Si vous préférez construire un workflow fixe et non-agent, il y a un court [repli REST](#rest-fallback-no-agent) à la fin.

## Pourquoi MCP plutôt qu'écrire des appels d'API

Vous pouvez appeler l'API REST Ayrshare directement depuis un nœud HTTP Request, ce qui convient aux workflows fixes et prévisibles. Le MCP Server prend tout son sens lorsqu'un LLM est dans la boucle :

<ul class="custom-bullets">
  <li>**L'agent choisit l'outil.** Décrivez l'objectif (« publie ceci sur nos canaux professionnels et planifie le suivi pour mardi ») et l'agent choisit lui-même `validate_post`, `create_post` et les bons paramètres.</li>
  <li>**Validation avant toute mise en ligne.** `validate_post` teste à blanc votre contenu par rapport aux règles de longueur, de format et de médias de chaque plateforme, de sorte que l'agent ne publie pas une publication qu'un réseau va rejeter.</li>
  <li>**Un appel, plusieurs réseaux.** Un seul `create_post` se diffuse vers chaque plateforme associée.</li>
  <li>**Les changements de plateforme sont le problème d'Ayrshare.** Lorsqu'un réseau modifie son API, Ayrshare maintient l'intégration et votre workflow continue de fonctionner.</li>
  <li>**Mêmes règles que l'API REST.** Chaque appel d'outil MCP s'exécute en interne via la même chaîne d'API Ayrshare : mêmes auth, limites de débit, quota et validation. Il n'y a pas de comportement distinct à apprendre.</li>
</ul>

## Comment il se connecte

Le nœud **AI Agent** est le cerveau. Le sous-nœud **MCP Client Tool** s'attache à lui, se connecte au MCP Server Ayrshare à `https://api.ayrshare.com/mcp`, découvre les outils disponibles et les expose à l'agent. Lorsque l'agent agit, le nœud distribue l'appel à Ayrshare, qui publie sur les réseaux.

```
Trigger  ->  AI Agent (+ Chat Model)  ->  MCP Client Tool  ->  Ayrshare MCP Server  ->  13 networks
```

Pour les détails d'endpoint, de transport et d'authentification, consultez [Connect & Setup](/additional/mcp-action-connect). Pour la liste complète des outils, consultez le [Catalogue des outils](/additional/mcp-action-tools).

## Prérequis

<ul class="custom-bullets">
  <li>Une **instance n8n** (Cloud ou auto-hébergée) sur une version récente avec les nœuds AI Agent et MCP Client Tool. Le nœud MCP Client Tool est intégré. Vous n'avez pas besoin d'un nœud communautaire, car le serveur Ayrshare parle Streamable HTTP.</li>
  <li>Un **compte Ayrshare et une API Key** (Dashboard → Settings → API Key), ou démarrez un [essai gratuit](https://billing.ayrshare.com/b/9B6bJ15Oidr9fz615u1Nu0h).</li>
  <li>**Au moins un compte social associé** dans Ayrshare. L'agent ne peut publier que là où vous êtes connecté.</li>
  <li>Un **credential de modèle de chat** pour le nœud AI Agent (Anthropic, OpenAI, etc.).</li>
  <li>*(Optionnel)* Un **Business Plan ou Enterprise Plan** si vous allez gérer plusieurs clients via des sous-profils.</li>
</ul>

## Configurer le nœud MCP Client Tool

<Steps>
  <Step title="Ajouter un nœud AI Agent">
    Ouvrez ou créez un workflow et ajoutez un nœud **AI Agent** (sous les nœuds *Advanced AI*).
  </Step>

  <Step title="Attacher le nœud MCP Client Tool">
    Sur le nœud AI Agent, cliquez sur le connecteur **Tool** et ajoutez un nœud **MCP Client Tool**. Configurez-le :

    | Champ                | Valeur                                                               |
    | -------------------- | -------------------------------------------------------------------- |
    | **Endpoint**         | `https://api.ayrshare.com/mcp`                                       |
    | **Server Transport** | `HTTP Streamable`                                                    |
    | **Authentication**   | `Bearer Auth`                                                        |
    | **Tools to Include** | `All` (ou `Selected` pour exposer uniquement des outils spécifiques) |
  </Step>

  <Step title="Ajouter votre clé Ayrshare en tant que credential Bearer">
    Pour **Credential**, créez un nouveau credential **Bearer Auth** et collez votre API Key Ayrshare comme jeton. n8n l'envoie sous forme d'`Authorization: Bearer YOUR_API_KEY`. Lorsque vous enregistrez, n8n se connecte et liste les 27 outils.
  </Step>

  <Step title="Câbler le modèle de chat et le prompt système">
    Attachez un sous-nœud **Chat Model** et sélectionnez votre credential de modèle. Donnez à l'agent un prompt système qui fixe les règles, par exemple :

    > Vous êtes un assistant réseaux sociaux ayant accès aux outils Ayrshare. Avant de publier quoi que ce soit, appelez toujours `validate_post` en premier et signalez tout problème. N'appelez `create_post` qu'après validation réussie. Utilisez par défaut les plateformes que l'utilisateur nomme ; si aucune n'est nommée, demandez. N'inventez jamais d'URL de médias ; utilisez uniquement les URL fournies par l'utilisateur, et confirmez-les avec `validate_media` en cas de doute.
  </Step>

  <Step title="Ajouter un déclencheur">
    Pour les tests, le **Manual Trigger** ou le **Chat Trigger** est le plus simple. Pour la production, utilisez ce qui déclenche le workflow (planification, webhook, formulaire, nouvelle ligne dans une feuille).
  </Step>
</Steps>

<Note>
  **Utilisez HTTP Streamable, pas SSE.** Le MCP Server Ayrshare utilise le transport moderne Streamable HTTP et est sans état. L'option SSE de n8n est obsolète, et le serveur rejette le flux SSE. Choisissez toujours **HTTP Streamable**.
</Note>

## La surface d'outils

Votre agent voit les 27 outils via l'unique nœud MCP. Vous les appelez rarement par leur nom ; vous décrivez l'intention et l'agent sélectionne. Les domaines sont Publications, Historique, Statistiques, Commentaires, Messages, Profils, Médias, Génération, Webhooks et Erreurs. Pour la liste complète avec l'objectif et la portée de chaque outil, consultez le [Catalogue des outils](/additional/mcp-action-tools).

Deux se distinguent pour la sécurité : **`validate_post`** teste à blanc une publication avec la même entrée que `create_post` mais ne publie rien, et **`explain_error`** transforme n'importe quel code d'erreur Ayrshare en une cause et un correctif en langage clair, afin que l'agent puisse s'auto-diagnostiquer.

## Exemple 1 : rédiger, valider et publier depuis un message de chat

Le « hello world » de cette intégration. Déclenchez le workflow avec un message de chat ou un formulaire, et laissez l'agent faire le reste.

<ul class="custom-bullets">
  <li>**Déclencheur :** Chat Trigger (ou un Form Trigger avec un champ « que devons-nous publier ? »).</li>
  <li>**Prompt à l'agent :** *« Rédige une annonce de lancement conviviale pour notre nouveau tableau de bord de statistiques et publie-la sur LinkedIn, Facebook et Instagram. Valide d'abord. »*</li>
</ul>

Ce que l'agent fait tout seul : il appelle `validate_post` avec votre texte et les trois plateformes ; si Instagram signale une image manquante, il vous le dit au lieu d'échouer silencieusement ; une fois la validation réussie, il appelle `create_post` et renvoie les URL des publications en direct. Parce que la validation est exécutée en premier, vous êtes informé d'un problème avant que quoi que ce soit ne soit public.

## Exemple 2 : publier automatiquement du nouveau contenu sur vos canaux

Transformez une source de contenu en publications multi-réseaux sans y toucher.

<ul class="custom-bullets">
  <li>**Déclencheur :** un nœud RSS Read sur le flux de votre blog, un webhook depuis votre CMS ou une nouvelle ligne dans Google Sheets ou Airtable.</li>
  <li>**Étape AI Agent :** *« Résume cet article en une courte publication sociale avec 2 à 3 hashtags pertinents, puis valide et publie sur LinkedIn, Facebook et Threads. »*</li>
  <li>Ajoutez éventuellement une approbation [humain dans la boucle](#keep-a-human-in-the-loop) avant l'étape `create_post` afin qu'une personne valide.</li>
</ul>

Vous pouvez vous appuyer sur `recommend_hashtags` pour des tags basés sur les données et sur `generate_post` si vous voulez qu'Ayrshare rédige le texte plutôt que votre modèle de chat.

## Exemple 3 : synthèse hebdomadaire des statistiques

Exécutez la boucle à l'envers : lisez les performances et rendez-en compte.

<ul class="custom-bullets">
  <li>**Déclencheur :** nœud Schedule, par exemple chaque lundi à 8 h.</li>
  <li>**Étape AI Agent :** *« Récupère les statistiques du compte de la semaine dernière pour LinkedIn, Instagram et Facebook, et résume les 3 meilleures publications par engagement. »*</li>
  <li>L'agent utilise `get_social_network_analytics` pour les chiffres au niveau du compte et `get_post_analytics` pour les publications individuelles, puis vous acheminez son résumé vers un nœud **Slack**, **Gmail** ou **Notion**.</li>
</ul>

Une note sur la cadence : la plupart des publications reçoivent l'essentiel de leur engagement dans les 24 premières heures, et les métriques ne se mettent pas à jour à la seconde. Une planification quotidienne ou hebdomadaire est amplement suffisante. N'interrogez pas les statistiques toutes les quelques minutes, sinon vous atteindrez les limites de débit pour aucune nouvelle donnée.

## Agir au nom des clients (multi-tenant)

Si vous gérez les réseaux sociaux pour plusieurs clients, les profils Ayrshare permettent à un seul compte de publier vers de nombreux ensembles distincts de comptes associés. Sur un Business Plan ou Enterprise Plan, vous avez deux façons de cibler un client depuis n8n :

<ul class="custom-bullets">
  <li>**Par connexion :** ajoutez un en-tête `Profile-Key` au nœud MCP Client Tool (utilisez l'auth **Multiple Headers** pour pouvoir envoyer à la fois `Authorization` et `Profile-Key`). Chaque appel sur ce nœud agit alors en tant que ce client. Bien lorsqu'un workflow sert un seul client.</li>
  <li>**Par appel :** de nombreux outils acceptent un argument `profileKey`, que l'agent peut définir par action. Lorsque les deux sont présents, l'[argument par appel l'emporte](/additional/mcp-action-connect#precedence-argument-wins-over-header). Bien lorsqu'un workflow route vers plusieurs clients.</li>
</ul>

Pour intégrer un nouveau client, l'agent peut appeler `create_profile` puis `generate_jwt_social_linking_url` pour générer une page hébergée où le client associe ses propres comptes. Aucun identifiant ne transite par votre workflow.

## Publier sur X/Twitter

<XByoNotice />

Dans n8n, basculez l'**Authentication** du nœud MCP Client Tool sur **Multiple Headers** et ajoutez les deux en-têtes `X-Twitter-OAuth1-*` aux côtés de `Authorization`. Il s'agit d'une configuration ponctuelle par compte Ayrshare, et la même paire de clés s'applique à chaque profil. Pour tout le reste (Facebook, Instagram, LinkedIn, YouTube, TikTok, et les autres), aucun en-tête supplémentaire n'est nécessaire. Consultez [Connect & Setup → Identifiants X/Twitter BYO](/additional/mcp-action-connect#xtwitter-byo-credentials).

## Gardez un humain dans la boucle

Les outils MCP rendent la publication triviale pour un agent, ce qui est précisément pourquoi vous devriez la contrôler. Deux garde-fous peu coûteux :

<ul class="custom-bullets">
  <li>**Toujours valider en premier.** Intégrez « appeler `validate_post` avant `create_post` » dans le prompt système. La validation ne publie rien et détecte les violations des règles de la plateforme en amont.</li>
  <li>**Ajouter une étape d'approbation.** Insérez le nœud **Send and Wait for Response** de n8n (Slack ou e-mail) entre le brouillon et l'action de publication afin qu'une personne approuve avant toute mise en ligne. Pour le contenu planifié, l'agent peut utiliser `update_post` pour réviser une publication en attente d'approbation.</li>
</ul>

## Repli REST (sans agent)

Si vous voulez un workflow fixe et déterministe sans LLM, contournez MCP et appelez l'API REST avec un nœud **HTTP Request** :

<ul class="custom-bullets">
  <li>**Méthode :** `POST`</li>
  <li>**URL :** `https://api.ayrshare.com/api/post`</li>
  <li>**Authentication :** Header Auth, `Authorization: Bearer YOUR_API_KEY`</li>
</ul>

```json theme={"system"}
{
  "post": "Excited to announce our new feature!",
  "platforms": ["facebook", "linkedin", "instagram"],
  "mediaUrls": ["https://example.com/image.jpg"],
  "scheduleDate": "2026-07-01T10:00:00Z"
}
```

Utilisez l'hôte API `api.ayrshare.com`, et non l'hôte du tableau de bord `app.ayrshare.com`. (`app.ayrshare.com` acceptera les appels d'API, mais ce n'est pas l'endpoint documenté et peut renvoyer des [erreurs de passerelle 502/504](/help-center/technical-support/response_bad_gateway_502_or_504_error) intermittentes, alors utilisez toujours `api.ayrshare.com`.) Le même schéma fonctionne pour les autres [endpoints REST](/apis/overview). C'est le bon outil lorsque le workflow est entièrement prévisible et que vous n'avez pas besoin qu'un agent décide de quoi que ce soit.

## Dépannage

| Symptôme                                                          | Cause probable                                               | Correctif                                                                                                                                                 |
| ----------------------------------------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| L'appel d'outil renvoie `403` / code `102`, « API Key not valid » | API Key incorrecte ou manquante                              | Vérifiez que le credential Bearer Auth contient exactement votre clé Ayrshare. Réenregistrez le nœud après modification.                                  |
| n8n ne parvient pas à se connecter au serveur MCP                 | Transport ou endpoint incorrect                              | L'endpoint doit être `https://api.ayrshare.com/mcp` ; le transport doit être **HTTP Streamable**, pas SSE.                                                |
| La publication X/Twitter échoue avec l'erreur `419`               | Identifiants X BYO manquants                                 | Ajoutez les deux en-têtes `X-Twitter-OAuth1-*` via l'auth Multiple Headers.                                                                               |
| La publication échoue pour une seule plateforme                   | Ce réseau n'est pas associé, ou un champ requis est manquant | Associez-le dans le tableau de bord ; ajoutez `title` pour YouTube, `title` + `subreddit` pour Reddit, `mediaUrls` pour Instagram.                        |
| Publication Instagram rejetée                                     | Aucun média                                                  | Instagram nécessite `mediaUrls` pour la plupart des types de publication. Faites confirmer par l'agent avec `validate_media`.                             |
| Un média joint sous forme de fichier ou binaire n'apparaît pas    | MCP est en JSON uniquement                                   | Référencez le média par une URL `mediaUrls` publique ; le chemin MCP n'accepte pas les téléversements de fichiers. Confirmez l'URL avec `validate_media`. |
| Les appels fonctionnent, mais agissent sur le mauvais client      | Ciblage de profil                                            | Définissez un en-tête `Profile-Key` (par connexion) ou un argument `profileKey` (par appel) ; l'argument l'emporte si les deux sont définis.              |
| `429 Too Many Requests`                                           | Interrogation trop fréquente                                 | Réduisez la fréquence d'interrogation des statistiques et des commentaires ; les métriques ne se mettent pas à jour à la seconde.                         |
| Le changement de configuration n'a pas pris effet                 | La connexion MCP s'initialise au démarrage de la session     | Réenregistrez le nœud ou redémarrez le workflow après avoir modifié la clé ou les en-têtes.                                                               |

Vous pouvez également exposer l'outil `explain_error` à l'agent afin qu'il décode lui-même n'importe quel code d'erreur Ayrshare en une cause et un correctif.

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Connect & Setup" icon="plug" href="/additional/mcp-action-connect" horizontal>
    Endpoint, transport, authentification, ciblage de profil et identifiants BYO.
  </Card>

  <Card title="Tool Catalog" icon="list" href="/additional/mcp-action-tools" horizontal>
    Les 27 outils regroupés par domaine, avec leur portée et leur objectif.
  </Card>

  <Card title="MCP Server" icon="server" href="/additional/mcp-action-server" horizontal>
    Ce qu'est le MCP Server et comment il correspond à l'API Ayrshare.
  </Card>

  <Card title="Claude Code Plugin" icon="terminal" href="/additional/mcp-claude-code-plugin" horizontal>
    Le même serveur, empaqueté pour Claude Code.
  </Card>
</CardGroup>