Den n8n-Starter-Workflow herunterladen
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.
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.
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:- 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_postund die richtigen Parameter selbst. - Validierung, bevor etwas live geht.
validate_postprü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. - Ein Aufruf, viele Netzwerke. Ein einzelner
create_postverteilt an jede verknüpfte Plattform. - Plattformänderungen sind Ayrshares Problem. Wenn ein Netzwerk seine API ändert, pflegt Ayrshare die Integration und Ihr Workflow läuft weiter.
- 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.
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 unterhttps://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.
Voraussetzungen
- 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.
- Ein Ayrshare-Konto und API Key (Dashboard → Settings → API Key), oder starten Sie eine kostenlose Testphase.
- Mindestens ein verknüpftes Social-Media-Konto in Ayrshare. Der Agent kann nur dort veröffentlichen, wo Sie eine Verbindung hergestellt haben.
- Eine Chat-Model-Anmeldung für den AI-Agent-Node (Anthropic, OpenAI usw.).
- (Optional) Ein Business- oder Enterprise-Plan, wenn Sie mehrere Kunden über Sub-Profile verwalten.
Den MCP-Client-Tool-Node einrichten
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).
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) |
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.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 zuerstvalidate_postauf und melde etwaige Probleme. Rufecreate_posterst 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 mitvalidate_media.
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.
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. 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.- Trigger: Chat Trigger (oder ein Form Trigger mit einem Feld „Was sollen wir posten?”).
- 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.”
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.- Trigger: RSS-Read-Node für Ihren Blog-Feed, ein Webhook aus Ihrem CMS oder eine neue Zeile in Google Sheets oder Airtable.
- 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.”
- Fügen Sie optional vor dem
create_post-Schritt eine Human-in-the-Loop-Freigabe hinzu, damit eine Person abzeichnet.
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.- Trigger: Schedule-Node, z. B. jeden Montag um 8 Uhr.
- 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.”
- Der Agent nutzt
get_social_network_analyticsfür Zahlen auf Konto-Ebene undget_post_analyticsfür einzelne Beiträge; anschließend leiten Sie seine Zusammenfassung an einen Slack-, Gmail- oder Notion-Node weiter.
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:- Pro Verbindung: Fügen Sie dem MCP-Client-Tool-Node einen
Profile-Key-Header hinzu (verwenden Sie Multiple Headers als Auth, damit Sie sowohlAuthorizationals auchProfile-Keysenden können). Jeder Aufruf auf diesem Node wirkt dann als dieser Kunde. Gut, wenn ein Workflow einem Kunden dient. - 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. Gut, wenn ein Workflow zwischen Kunden routet.
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
Wechseln Sie in n8n die Authentication des MCP-Client-Tool-Nodes auf Multiple Headers und fügen Sie die beidenX-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.
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:- Immer zuerst validieren. Bauen Sie „rufe
validate_postvorcreate_postauf” fest in den System-Prompt ein. Die Validierung veröffentlicht nichts und erkennt Regelverstöße früh. - 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_postverwenden, um einen auf Freigabe wartenden Beitrag zu überarbeiten.
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:- Method:
POST - URL:
https://api.ayrshare.com/api/post - Authentication: Header Auth,
Authorization: Bearer YOUR_API_KEY
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 liefern – nutzen Sie daher immer api.ayrshare.com.) Dasselbe Muster funktioniert für die anderen REST-Endpunkte. 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. |
explain_error verfügbar machen, damit er jeden Ayrshare-Fehlercode selbstständig in Ursache und Behebung dekodiert.
Nächste Schritte
Verbinden & Einrichten
Endpunkt, Transport, Authentifizierung, Profil-Targeting und BYO-Anmeldedaten.
Tool-Katalog
Die 27 Tools nach Domäne gruppiert, mit Scope und Zweck.
MCP Server
Was der MCP Server ist und wie er auf die Ayrshare API abgebildet wird.
Claude Code Plugin
Derselbe Server – als Paket für Claude Code.