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

> Verbinden Sie den KI-Agenten von n8n mit dem Ayrshare MCP Server, um mit einem einzigen Aufruf auf 13 sozialen Netzwerken zu veröffentlichen, zu planen und zu analysieren – ohne plattformspezifischen API-Code.

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 ist der Ort, an dem Sie Ihre Tools verdrahten. Ayrshare ist die eine API, die mit einem einzigen Aufruf auf Facebook, Instagram, LinkedIn, YouTube, TikTok, Pinterest, Reddit, Threads, Bluesky, Telegram, Google Business Profile, Snapchat und X veröffentlicht. Verbinden Sie beide mit dem [Ayrshare MCP Server](/additional/mcp-action-server), und Ihr n8n-KI-Agent kann den gesamten Zyklus selbst ausführen: einen Beitrag entwerfen, gegen die Regeln jedes Netzwerks validieren, veröffentlichen oder planen und anschließend die Analytics zurücklesen.

<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="The n8n starter workflow on the canvas: a chat trigger into an AI Agent, with an Anthropic chat model and the Ayrshare MCP tool node attached below, plus setup and usage sticky notes." width="2000" height="1100" data-path="images/packages-guides/n8n-mcp-workflow.webp" />

Da der MCP Server ein gehosteter Streamable-HTTP-Endpunkt ist, verbinden Sie ihn mit dem in n8n integrierten **MCP Client Tool**-Node. Es gibt nichts zu hosten, keinen eigenen Code und keinen Community-Node zu installieren. Sie richten einen Node auf eine URL, und Ihr Agent erhält alle 27 Social-Tools.

<Card title="Den n8n-Starter-Workflow herunterladen" icon="download" href="/files/ayrshare-n8n-mcp-workflow.json" horizontal>
  Der oben gezeigte Workflow – bereit zum Importieren: Chat Trigger, AI Agent, ein Anthropic Chat Model und der Ayrshare-MCP-Node, vorverdrahtet mit dem Validate-First-System-Prompt.
</Card>

So verwenden Sie ihn: Wählen Sie in n8n **Workflows → Import from file**, wählen Sie die JSON-Datei aus und erstellen Sie dann die beiden erwarteten Anmeldedaten (eine **Bearer Auth**-Anmeldung mit Ihrem Ayrshare-Schlüssel und eine **Anthropic API**-Anmeldung). Die beiden Warnhinweis-Badges verschwinden, sobald die Anmeldedaten angehängt sind. Selbst gehostete Instanzen benötigen ausgehenden Zugriff auf `api.ayrshare.com` und Ihren Modellanbieter.

Diese Anleitung deckt den MCP-First-Weg End-to-End ab. Wenn Sie stattdessen einen festen, nicht agentenbasierten Workflow bauen möchten, finden Sie am Ende einen kurzen [REST-Fallback](#rest-fallback-no-agent).

## Warum MCP statt eigenem API-Code

Sie können Ayrshares REST-API direkt aus einem HTTP-Request-Node aufrufen – das ist für feste, vorhersehbare Workflows in Ordnung. Der MCP Server zeigt seine Stärken, wenn ein LLM im Spiel ist:

<ul class="custom-bullets">
  <li>**Der Agent wählt das Tool.** Beschreiben Sie das Ziel („veröffentliche das auf unseren Business-Kanälen und plane das Follow-up für Dienstag"), und der Agent wählt `validate_post`, `create_post` und die richtigen Parameter selbst.</li>
  <li>**Validierung, bevor etwas live geht.** `validate_post` prüft Ihren Inhalt im Dry-Run gegen die Länge-, Format- und Medienregeln jeder Plattform, sodass der Agent keinen Beitrag versendet, den ein Netzwerk ablehnen wird.</li>
  <li>**Ein Aufruf, viele Netzwerke.** Ein einzelner `create_post` verteilt an jede verknüpfte Plattform.</li>
  <li>**Plattformänderungen sind Ayrshares Problem.** Wenn ein Netzwerk seine API ändert, pflegt Ayrshare die Integration und Ihr Workflow läuft weiter.</li>
  <li>**Dieselben Regeln wie die REST-API.** Jeder MCP-Tool-Aufruf läuft in-process durch dieselbe Ayrshare-API-Kette: gleiche Authentifizierung, gleiche Ratenlimits, gleiches Kontingent und gleiche Validierung. Es gibt kein separates Verhalten zu lernen.</li>
</ul>

## Wie es sich verbindet

Der **AI Agent**-Node ist das Gehirn. Der **MCP Client Tool**-Sub-Node hängt sich an ihn, verbindet sich mit dem Ayrshare MCP Server unter `https://api.ayrshare.com/mcp`, erkennt die verfügbaren Tools und stellt sie dem Agenten zur Verfügung. Wenn der Agent handelt, leitet der Node den Aufruf an Ayrshare weiter, das dann in den Netzwerken veröffentlicht.

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

Für Endpunkt, Transport und Authentifizierung siehe [Verbinden & Einrichten](/additional/mcp-action-connect). Für die vollständige Tool-Liste siehe den [Tool-Katalog](/additional/mcp-action-tools).

## Voraussetzungen

<ul class="custom-bullets">
  <li>Eine **n8n-Instanz** (Cloud oder selbst gehostet) in einer aktuellen Version mit den Nodes AI Agent und MCP Client Tool. Der MCP-Client-Tool-Node ist eingebaut. Ein Community-Node ist nicht nötig, weil der Ayrshare-Server Streamable HTTP spricht.</li>
  <li>Ein **Ayrshare-Konto und API Key** (Dashboard → Settings → API Key), oder starten Sie eine [kostenlose Testphase](https://billing.ayrshare.com/b/9B6bJ15Oidr9fz615u1Nu0h).</li>
  <li>**Mindestens ein verknüpftes Social-Media-Konto** in Ayrshare. Der Agent kann nur dort veröffentlichen, wo Sie eine Verbindung hergestellt haben.</li>
  <li>Eine **Chat-Model-Anmeldung** für den AI-Agent-Node (Anthropic, OpenAI usw.).</li>
  <li>*(Optional)* Ein **Business- oder Enterprise-Plan**, wenn Sie mehrere Kunden über Sub-Profile verwalten.</li>
</ul>

## Den MCP-Client-Tool-Node einrichten

<Steps>
  <Step title="Einen AI-Agent-Node hinzufügen">
    Öffnen oder erstellen Sie einen Workflow und fügen Sie einen **AI Agent**-Node hinzu (unter den *Advanced AI*-Nodes).
  </Step>

  <Step title="Den MCP-Client-Tool-Node anhängen">
    Klicken Sie im AI-Agent-Node auf den **Tool**-Konnektor und fügen Sie einen **MCP Client Tool**-Node hinzu. Konfigurieren Sie ihn:

    | Feld                 | Wert                                                                |
    | -------------------- | ------------------------------------------------------------------- |
    | **Endpoint**         | `https://api.ayrshare.com/mcp`                                      |
    | **Server Transport** | `HTTP Streamable`                                                   |
    | **Authentication**   | `Bearer Auth`                                                       |
    | **Tools to Include** | `All` (oder `Selected`, um nur bestimmte Tools verfügbar zu machen) |
  </Step>

  <Step title="Ihren Ayrshare-Key als Bearer-Anmeldung hinzufügen">
    Erstellen Sie unter **Credential** eine neue **Bearer Auth**-Anmeldung und fügen Sie Ihren Ayrshare API Key als Token ein. n8n sendet ihn als `Authorization: Bearer YOUR_API_KEY`. Beim Speichern verbindet sich n8n und listet die 27 Tools auf.
  </Step>

  <Step title="Chat-Model und System-Prompt verdrahten">
    Hängen Sie einen **Chat Model**-Sub-Node an und wählen Sie Ihre Modell-Anmeldung. Geben Sie dem Agenten einen System-Prompt, der die Regeln festlegt, zum Beispiel:

    > Du bist ein Social-Media-Assistent mit Zugriff auf Ayrshare-Tools. Rufe vor jeder Veröffentlichung zuerst `validate_post` auf und melde etwaige Probleme. Rufe `create_post` erst auf, wenn die Validierung erfolgreich ist. Verwende standardmäßig die vom Nutzer genannten Plattformen; sind keine genannt, frage nach. Erfinde niemals Medien-URLs; verwende nur die vom Nutzer angegebenen URLs und bestätige sie im Zweifel mit `validate_media`.
  </Step>

  <Step title="Einen Trigger hinzufügen">
    Zum Testen sind der **Manual Trigger** oder **Chat Trigger** am einfachsten. Für den Produktivbetrieb verwenden Sie, was den Workflow auslöst (Zeitplan, Webhook, Formular, neue Zeile in einem Sheet).
  </Step>
</Steps>

<Note>
  **Verwenden Sie HTTP Streamable, nicht SSE.** Der Ayrshare MCP Server nutzt den modernen Streamable-HTTP-Transport und ist stateless. Die SSE-Option von n8n ist veraltet, und der Server lehnt den SSE-Stream ab. Wählen Sie immer **HTTP Streamable**.
</Note>

## Die Tool-Oberfläche

Ihr Agent sieht alle 27 Tools über den einen MCP-Node. Sie rufen sie selten namentlich auf; Sie beschreiben die Absicht, und der Agent wählt aus. Die Domänen sind Posts, History, Analytics, Comments, Messages, Profiles, Media, Generate, Webhooks und Errors. Die vollständige Liste mit Zweck und Scope jedes Tools finden Sie im [Tool-Katalog](/additional/mcp-action-tools).

Zwei stechen sicherheitsseitig hervor: **`validate_post`** führt einen Beitrag als Dry-Run mit denselben Eingaben wie `create_post` aus, veröffentlicht aber nichts, und **`explain_error`** wandelt jeden Ayrshare-Fehlercode in eine verständliche Ursache und Behebung um, sodass sich der Agent selbst diagnostizieren kann.

## Beispiel 1: entwerfen, validieren und aus einer Chat-Nachricht heraus veröffentlichen

Das „Hello World" dieser Integration. Lösen Sie den Workflow mit einer Chat-Nachricht oder einem Formular aus und lassen Sie den Agenten den Rest erledigen.

<ul class="custom-bullets">
  <li>**Trigger:** Chat Trigger (oder ein Form Trigger mit einem Feld „Was sollen wir posten?").</li>
  <li>**Prompt an den Agenten:** *„Schreibe eine freundliche Launch-Ankündigung für unser neues Analytics-Dashboard und veröffentliche sie auf LinkedIn, Facebook und Instagram. Validiere zuerst."*</li>
</ul>

Was der Agent selbst tut: Er ruft `validate_post` mit Ihrem Text und den drei Plattformen auf; wenn Instagram ein fehlendes Bild bemängelt, sagt er es Ihnen, statt still zu scheitern; sobald die Validierung erfolgreich ist, ruft er `create_post` auf und gibt die Live-Beitrags-URLs zurück. Weil zuerst validiert wird, erfahren Sie von einem Problem, bevor irgendetwas öffentlich ist.

## Beispiel 2: neue Inhalte automatisch auf Ihren Kanälen veröffentlichen

Verwandeln Sie eine Inhaltsquelle in Beiträge für mehrere Netzwerke, ohne sie anzufassen.

<ul class="custom-bullets">
  <li>**Trigger:** RSS-Read-Node für Ihren Blog-Feed, ein Webhook aus Ihrem CMS oder eine neue Zeile in Google Sheets oder Airtable.</li>
  <li>**AI-Agent-Schritt:** *„Fasse diesen Artikel zu einem kurzen Social-Beitrag mit 2 bis 3 passenden Hashtags zusammen, validiere und veröffentliche dann auf LinkedIn, Facebook und Threads."*</li>
  <li>Fügen Sie optional vor dem `create_post`-Schritt eine [Human-in-the-Loop-Freigabe](#keep-a-human-in-the-loop) hinzu, damit eine Person abzeichnet.</li>
</ul>

Sie können sich auf `recommend_hashtags` für datengetriebene Tags stützen und auf `generate_post`, wenn Ayrshare den Text statt Ihres Chat-Models entwerfen soll.

## Beispiel 3: wöchentliches Analytics-Digest

Betreiben Sie den Zyklus umgekehrt: Performance lesen und berichten.

<ul class="custom-bullets">
  <li>**Trigger:** Schedule-Node, z. B. jeden Montag um 8 Uhr.</li>
  <li>**AI-Agent-Schritt:** *„Hole die kontobezogenen Analytics der letzten Woche für LinkedIn, Instagram und Facebook und fasse die Top-3-Beiträge nach Engagement zusammen."*</li>
  <li>Der Agent nutzt `get_social_network_analytics` für Zahlen auf Konto-Ebene und `get_post_analytics` für einzelne Beiträge; anschließend leiten Sie seine Zusammenfassung an einen **Slack**-, **Gmail**- oder **Notion**-Node weiter.</li>
</ul>

Ein Hinweis zur Taktung: Die meisten Beiträge erhalten den Großteil ihres Engagements in den ersten 24 Stunden, und Kennzahlen aktualisieren sich nicht sekundengenau. Ein tägliches oder wöchentliches Intervall reicht völlig. Fragen Sie Analytics nicht alle paar Minuten ab – Sie werden nur Ratenlimits erreichen, ohne neue Daten zu bekommen.

## Im Auftrag von Kunden handeln (Mandantenfähigkeit)

Wenn Sie Social Media für mehrere Kunden verwalten, ermöglichen Ihnen die Profile von Ayrshare, mit einem Konto auf viele separate Sätze verknüpfter Konten zu posten. Im Business- oder Enterprise-Plan gibt es zwei Wege, aus n8n heraus auf einen Kunden abzuzielen:

<ul class="custom-bullets">
  <li>**Pro Verbindung:** Fügen Sie dem MCP-Client-Tool-Node einen `Profile-Key`-Header hinzu (verwenden Sie **Multiple Headers** als Auth, damit Sie sowohl `Authorization` als auch `Profile-Key` senden können). Jeder Aufruf auf diesem Node wirkt dann als dieser Kunde. Gut, wenn ein Workflow einem Kunden dient.</li>
  <li>**Pro Aufruf:** Viele Tools akzeptieren ein `profileKey`-Argument, das der Agent pro Aktion setzen kann. Sind beide vorhanden, hat das [pro Aufruf angegebene Argument Vorrang](/additional/mcp-action-connect#precedence-argument-wins-over-header). Gut, wenn ein Workflow zwischen Kunden routet.</li>
</ul>

Um einen neuen Kunden zu onboarden, kann der Agent `create_profile` und anschließend `generate_jwt_social_linking_url` aufrufen, um eine gehostete Seite zu erzeugen, auf der der Kunde seine Konten selbst verknüpft. Es fließen keine Anmeldedaten durch Ihren Workflow.

## Auf X/Twitter posten

<XByoNotice />

Wechseln Sie in n8n die **Authentication** des MCP-Client-Tool-Nodes auf **Multiple Headers** und fügen Sie die beiden `X-Twitter-OAuth1-*`-Header zusammen mit `Authorization` hinzu. Es handelt sich um eine einmalige Einrichtung pro Ayrshare-Konto, und dasselbe Schlüsselpaar gilt für jedes Profil. Für alles andere (Facebook, Instagram, LinkedIn, YouTube, TikTok und die übrigen) sind keine zusätzlichen Header nötig. Siehe [Verbinden & Einrichten → X/Twitter BYO-Anmeldedaten](/additional/mcp-action-connect#xtwitter-byo-credentials).

## Einen Menschen einbinden

Die MCP-Tools machen es einem Agenten sehr leicht zu veröffentlichen – genau deshalb sollten Sie den Ablauf absichern. Zwei kostengünstige Vorkehrungen:

<ul class="custom-bullets">
  <li>**Immer zuerst validieren.** Bauen Sie „rufe `validate_post` vor `create_post` auf" fest in den System-Prompt ein. Die Validierung veröffentlicht nichts und erkennt Regelverstöße früh.</li>
  <li>**Einen Freigabeschritt einbauen.** Fügen Sie den n8n-Node **Send and Wait for Response** (Slack oder E-Mail) zwischen Entwurf und Publish-Aktion ein, damit eine Person freigibt, bevor etwas live geht. Für geplante Inhalte kann der Agent `update_post` verwenden, um einen auf Freigabe wartenden Beitrag zu überarbeiten.</li>
</ul>

## REST-Fallback (kein Agent)

Wenn Sie einen festen, deterministischen Workflow ohne LLM wollen, überspringen Sie MCP und rufen Sie die REST-API mit einem **HTTP Request**-Node auf:

<ul class="custom-bullets">
  <li>**Method:** `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"
}
```

Verwenden Sie den API-Host `api.ayrshare.com`, nicht den Dashboard-Host `app.ayrshare.com`. (`app.ayrshare.com` akzeptiert zwar API-Aufrufe, ist aber nicht der dokumentierte Endpunkt und kann sporadische [502/504 Gateway-Fehler](/help-center/technical-support/response_bad_gateway_502_or_504_error) liefern – nutzen Sie daher immer `api.ayrshare.com`.) Dasselbe Muster funktioniert für die anderen [REST-Endpunkte](/apis/overview). Das ist das richtige Werkzeug, wenn der Workflow vollständig vorhersehbar ist und kein Agent Entscheidungen treffen soll.

## Fehlerbehebung

| Symptom                                                      | Wahrscheinliche Ursache                                        | Behebung                                                                                                                                                  |
| ------------------------------------------------------------ | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tool-Aufruf liefert `403` / Code `102`, „API Key not valid"  | Falscher oder fehlender API Key                                | Prüfen Sie, ob die Bearer-Auth-Anmeldung Ihren exakten Ayrshare-Schlüssel enthält. Node nach der Änderung erneut speichern.                               |
| n8n kann keine Verbindung zum MCP-Server herstellen          | Falscher Transport oder Endpunkt                               | Endpunkt muss `https://api.ayrshare.com/mcp` sein; Transport muss **HTTP Streamable** sein, nicht SSE.                                                    |
| X-/Twitter-Beitrag scheitert mit Fehler `419`                | Fehlende X-BYO-Anmeldedaten                                    | Fügen Sie die beiden `X-Twitter-OAuth1-*`-Header über die Multiple-Headers-Auth hinzu.                                                                    |
| Beitrag scheitert nur bei einer Plattform                    | Dieses Netzwerk ist nicht verknüpft oder ein Pflichtfeld fehlt | Verknüpfen Sie es im Dashboard; ergänzen Sie `title` für YouTube, `title` + `subreddit` für Reddit, `mediaUrls` für Instagram.                            |
| Instagram-Beitrag abgelehnt                                  | Keine Medien                                                   | Instagram erfordert `mediaUrls` für die meisten Beitragstypen. Lassen Sie den Agenten mit `validate_media` bestätigen.                                    |
| Als Datei oder Binärdaten angehängte Medien erscheinen nicht | MCP ist reines JSON                                            | Referenzieren Sie Medien über eine öffentliche `mediaUrls`-URL; der MCP-Pfad akzeptiert keine Datei-Uploads. Bestätigen Sie die URL mit `validate_media`. |
| Aufrufe funktionieren, wirken aber auf den falschen Kunden   | Profil-Targeting                                               | Setzen Sie einen `Profile-Key`-Header (pro Verbindung) oder ein `profileKey`-Argument (pro Aufruf); das Argument hat Vorrang, wenn beide gesetzt sind.    |
| `429 Too Many Requests`                                      | Zu häufiges Polling                                            | Reduzieren Sie die Polling-Frequenz für Analytics und Kommentare; Kennzahlen aktualisieren sich nicht sekundengenau.                                      |
| Konfigurationsänderung greift nicht                          | Die MCP-Verbindung wird zu Sitzungsbeginn initialisiert        | Speichern Sie den Node erneut oder starten Sie den Workflow neu, nachdem Sie den Schlüssel oder die Header geändert haben.                                |

Sie können dem Agenten auch das Tool `explain_error` verfügbar machen, damit er jeden Ayrshare-Fehlercode selbstständig in Ursache und Behebung dekodiert.

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Verbinden & Einrichten" icon="plug" href="/additional/mcp-action-connect" horizontal>
    Endpunkt, Transport, Authentifizierung, Profil-Targeting und BYO-Anmeldedaten.
  </Card>

  <Card title="Tool-Katalog" icon="list" href="/additional/mcp-action-tools" horizontal>
    Die 27 Tools nach Domäne gruppiert, mit Scope und Zweck.
  </Card>

  <Card title="MCP Server" icon="server" href="/additional/mcp-action-server" horizontal>
    Was der MCP Server ist und wie er auf die Ayrshare API abgebildet wird.
  </Card>

  <Card title="Claude Code Plugin" icon="terminal" href="/additional/mcp-claude-code-plugin" horizontal>
    Derselbe Server – als Paket für Claude Code.
  </Card>
</CardGroup>