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

> Integrieren Sie die Ayrshare-Social-Media-API in Ihre n8n-Workflows, um die Social-Media-Konten Ihrer Nutzer zu veröffentlichen, zu planen und zu analysieren.

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

## Überblick

[n8n](https://n8n.io) ist eine Workflow-Automatisierungsplattform, mit der Sie Apps verbinden und Prozesse – einschließlich KI-Agenten – in der Cloud oder selbst gehostet orchestrieren können.

Die Ayrshare-Social-Media-API kann in Ihre n8n-Workflows integriert werden, um die Social-Media-Konten Ihrer Nutzer zu verwalten. Ein einziger API-Aufruf veröffentlicht auf Facebook, Instagram, LinkedIn, YouTube, TikTok, Pinterest, Reddit, Threads, Bluesky, Telegram, Google Business Profile, Snapchat und X, sodass Sie keinen plattformspezifischen API-Code schreiben oder pflegen müssen.

Es gibt zwei Möglichkeiten der Anbindung:

<ul class="custom-bullets">
  <li>**MCP-Server (agentengesteuert).** Verbinden Sie den [Ayrshare-MCP-Server](/additional/mcp-action-server) mit dem integrierten n8n-Node „MCP Client Tool", und Ihr KI-Agent kann den gesamten Loop eigenständig ausführen: einen Beitrag entwerfen, ihn gegen die Regeln jedes Netzwerks validieren, ihn veröffentlichen oder planen und anschließend die Analytics zurücklesen. Es ist nichts zu hosten und kein Community-Node zu installieren.</li>
  <li>**REST-API (fester Workflow).** Für deterministische, nicht-agentengesteuerte Workflows rufen Sie die [Ayrshare-REST-API](/apis/overview) direkt aus einem HTTP-Request-Node auf.</li>
</ul>

Die Verwaltung der sozialen Konten Ihrer Nutzer erfordert den [Business-Plan](/multiple-users/business-plan-overview), aber Sie können Ihre eigenen sozialen Konten auf ähnliche Weise mit dem Premium-Plan verwalten, indem Sie einfach den [API-Key](/apis/overview#authorization) im Request-Header verwenden.

## So funktioniert die Verbindung

Beim MCP-Pfad ist der Node **AI Agent** das Gehirn. Der Sub-Node **MCP Client Tool** wird daran angehängt, verbindet sich mit dem Ayrshare-MCP-Server, 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 auf die Netzwerke veröffentlicht.

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

<Note>
  Verwenden Sie den Transport **HTTP Streamable**, nicht SSE. Die [n8n-Anleitung](/additional/mcp-n8n) behandelt Transport, Authentifizierung und Setup im Detail.
</Note>

## Anleitung

Die vollständige n8n-Anleitung deckt den MCP-first-Pfad End-to-End ab: Voraussetzungen, Einrichten des MCP-Client-Tool-Nodes, den Validate-first-System-Prompt, ausgearbeitete Beispiele (Entwerfen und Veröffentlichen aus einer Chat-Nachricht, automatisches Veröffentlichen neuer Inhalte, ein wöchentlicher Analytics-Digest), Handeln im Namen von Kunden mit Sub-Profilen, den Menschen in der Loop halten, das REST-Fallback und Fehlerbehebung.

<Card title="n8n + Ayrshare-MCP-Anleitung" icon="book-open" href="/additional/mcp-n8n" horizontal>
  Verbinden Sie den AI-Agent von n8n mit dem Ayrshare-MCP-Server, um plattformübergreifend zu veröffentlichen, zu planen und zu analysieren – ohne plattformspezifischen API-Code.
</Card>

<Card title="Starter-Workflow für n8n herunterladen" icon="download" href="/files/ayrshare-n8n-mcp-workflow.json" horizontal>
  Ein importbereiter Workflow: Chat Trigger, AI Agent, ein Anthropic-Chat-Modell und der Ayrshare-MCP-Node, vorverdrahtet mit dem Validate-first-System-Prompt.
</Card>

## Posten auf X (ehemals Twitter)

<XByoNotice />

Stellen Sie in n8n die **Authentication** des MCP-Client-Tool-Nodes auf **Multiple Headers** um und fügen Sie neben `Authorization` die beiden Header `X-Twitter-OAuth1-*` hinzu. Siehe [Connect & Setup → X/Twitter BYO credentials](/additional/mcp-action-connect#xtwitter-byo-credentials).

## Mehr erfahren

<ul class="custom-bullets">
  <li>Erfahren Sie mehr über [n8n](https://n8n.io) und dessen Nodes [AI Agent](https://docs.n8n.io/advanced-ai/) und [MCP Client Tool](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/).</li>
  <li>Siehe die [MCP-Server-Übersicht](/additional/mcp-action-server), was der Server ist und wie er auf die Ayrshare-API abgebildet wird.</li>
  <li>Durchsuchen Sie den [Tool-Katalog](/additional/mcp-action-tools) nach Tools, die Ihr Agent aufrufen kann, gruppiert nach Domain.</li>
  <li>Lesen Sie [Connect & Setup](/additional/mcp-action-connect) für Details zu Endpoint, Transport, Authentifizierung und Profil-Targeting.</li>
</ul>