Claude Code Plugin

Das Ayrshare-Plugin für Claude Code bündelt die Konfiguration des MCP Server, einen Setup-Befehl, Agents, Skills und einen Sicherheits-Hook. Nach der Installation können Sie direkt aus Claude Code Beiträge veröffentlichen, Verlauf und Analytics abrufen, Profile verwalten und vieles mehr. Bevor etwas live geht, validiert der Agent jeden Beitrag gegen die Regeln des jeweiligen Netzwerks und fragt Sie um Bestätigung – so werden vermeidbare Ablehnungen im Vorfeld erkannt. Der Beitragsverlauf steht zur Verfügung, um den Ton einer Marke zu treffen, und Analytics können zurückgelesen werden, um den nächsten Beitrag zu planen. Das Plugin ist Open Source. Interna finden Sie im Repository: ayrshare/ayrshare-social-media-api-claude-plugin.

Installation

Marketplace hinzufügen (einmalig)

claude plugin marketplace add ayrshare/ayrshare-social-media-api-claude-plugin

Das Plugin installieren

claude plugin install ayrshare@ayrshare

Installations-Scopes

Scope	Gilt für
Global (Standard)	Jedes Projekt auf diesem Rechner.
`--scope local`	Aktuelles Projekt, nicht in Git eingecheckt.
`--scope project`	Aktuelles Projekt, eingecheckt und im Team geteilt.

Das CLI von Claude Code nennt den globalen Scope --scope user.

Anmeldedaten

Stellen Sie Ihren Ayrshare API Key auf eine dieser Arten bereit:

Führen Sie /ayrshare:setup aus, um den Schlüssel zu konfigurieren oder zu wechseln.
Setzen Sie die Umgebungsvariable AYRSHARE_API_KEY.

Die im Plugin enthaltene .mcp.json deklariert bereits den Authorization-Header sowie die optionalen Profile-Key- und X-BYOK-Header, jeweils mit einem leeren Standardwert (${VAR:-}). Sie aktivieren einen Header also einfach, indem Sie die zugehörige Umgebungsvariable setzen (Claude Code ersetzt die Werte beim Start). Um bei jedem Aufruf ein Sub-Profil anzusprechen, setzen Sie AYRSHARE_PROFILE_KEY (über /ayrshare:setup oder den env-Block Ihrer settings.json) und starten Sie Claude Code neu; der eingebundene Profile-Key-Header übernimmt den Wert und bleibt leer (wird als nicht gesetzt behandelt), wenn er nicht gesetzt ist. Um stattdessen für einen einzelnen Aufruf ein Sub-Profil anzusprechen, übergeben Sie ein profileKey-Tool-Argument (keine Konfigurationsänderung nötig). Sie müssen die eingebundene .mcp.json nicht bearbeiten und sollten es auch nicht tun, denn claude plugin update überschreibt sie.

Der MCP-Server wird zu Sitzungsbeginn initialisiert. Starten Sie Claude Code neu, nachdem Sie das Plugin installiert oder Ihren Schlüssel geändert haben.

X/Twitter BYO-Anmeldedaten

Das Posten auf X/Twitter erfordert Ihre eigenen X-Developer-App-Anmeldedaten (die X-BYO-Key-Vorgabe, wirksam ab 31. März 2026; siehe API-Übersicht). Die eingebundene .mcp.json deklariert bereits beide X-BYOK-Header mit leeren Standardwerten – neben Authorization und Profile-Key:

"headers": {
  "Authorization": "Bearer ${AYRSHARE_API_KEY}",
  "Profile-Key": "${AYRSHARE_PROFILE_KEY:-}",
  "X-Twitter-OAuth1-Api-Key": "${X_TWITTER_OAUTH1_API_KEY:-}",
  "X-Twitter-OAuth1-Api-Secret": "${X_TWITTER_OAUTH1_API_SECRET:-}"
}

Sie setzen also nur die passenden Umgebungsvariablen (X_TWITTER_OAUTH1_API_KEY, X_TWITTER_OAUTH1_API_SECRET) über /ayrshare:setup oder das env Ihrer settings.json und starten Claude Code dann neu; die eingebundene .mcp.json bearbeiten Sie nicht (sie wird bei claude plugin update überschrieben). Setzen Sie beide oder keinen: Ist keiner gesetzt, gibt ein X-/Twitter-Aufruf den Fehler 419 (x_credentials_required) zurück; ist nur einer gesetzt, gibt es Fehler 400. Es handelt sich um ein Schlüsselpaar pro Ayrshare-Konto, das bei jeder X-Anfrage mitgesendet wird (dasselbe Paar für alle Sub-Profile).

Bevorzugen Sie eine direkte Verbindung anstelle des Plugins? Die gleichen BYO-Header können über claude mcp add --header übergeben werden – siehe Verbinden & Einrichten → X/Twitter BYO-Anmeldedaten.

Was es mitbringt

Befehl

/ayrshare:setup – Ayrshare API Key konfigurieren oder wechseln.

Agents

social-manager: veröffentlicht, plant und analysiert Inhalte plattformübergreifend.
profile-manager: erstellt und listet Profile auf und erzeugt JWT-Social-Linking-URLs für Kundenprofile unter einem Business-Konto.
insights-analyst: schreibgeschütztes Reporting. Ruft Kennzahlen und Beitragsverlauf ab und fasst die Performance zusammen; veröffentlicht, kommentiert, versendet oder ändert niemals etwas.

Skills

Skill	Zweck
`getting-started`	Orientierung und Verbindung für die erste Nutzung.
`post`	Beiträge erstellen, validieren, aktualisieren und erneut versuchen.
`history`	Beitrags- und Plattformverlauf abrufen.
`analytics`	Analytics pro Beitrag und auf Konto-Ebene abrufen.
`comments`	Kommentare lesen, hinzufügen und beantworten.
`messages`	Direktnachrichten lesen und senden sowie Auto-Antworten konfigurieren.
`profiles`	Sub-Profile erstellen und auflisten.
`media`	Prüfen, ob Medien-URLs erreichbar sind.
`generate`	KI-Entwürfe für Beitragstexte und Hashtag-Empfehlungen.
`webhooks`	Webhooks registrieren, abmelden und auflisten.
`errors`	Ayrshare-Fehlercodes dekodieren.
`draft-in-brand-voice`	Beitragstexte in einem konsistenten Markenton entwerfen.
`plan-and-schedule-campaign`	Eine Mehr-Beitrags-Kampagne planen und terminieren.

Bestätigungs-Hook

Ein PreToolUse-Hook fragt vor jeder Veröffentlichung oder Sendeaktion um Bestätigung. Er deckt genau diese 7 Tools ab:

create_post
update_post
retry_post
add_comment
reply_comment
send_message
set_auto_response

FAQ

Validiert das Plugin Beiträge vor der Veröffentlichung?

Ja. Das Plugin führt validate_post aus, um Ihren Inhalt gegen die Regeln jedes Netzwerks – Länge, Format und Medienanforderungen – im Dry-Run zu prüfen, bevor er veröffentlicht wird, sodass Sie vermeidbare Ablehnungen im Vorfeld erkennen.

Fragt es nach, bevor auf meine Live-Konten gepostet wird?

Ja. Ein PreToolUse-Bestätigungs-Hook fordert Sie vor jeder Veröffentlichungs- oder Sendeaktion zur Genehmigung auf: create_post, update_post, retry_post, add_comment, reply_comment, send_message und set_auto_response.

Kann das Plugin den Ton meiner Marke treffen?

Ja. Der Skill draft-in-brand-voice liest Ihren Beitragsverlauf, um neue Texte in einem konsistenten Markenton zu entwerfen. Er erzeugt nur Entwürfe – ohne Ihre Bestätigung wird nichts veröffentlicht.

Kann ich Analytics lesen, um den nächsten Beitrag zu planen?

Ja. Die Analytics-Tools liefern Kennzahlen pro Beitrag und auf Konto-Ebene, sodass Sie Ergebnisse zurücklesen und Ihre nächsten Beiträge daran ausrichten können.

Was benötige ich, um das Plugin zu nutzen?

Einen Ayrshare API Key (einen Business-Plan-Schlüssel für Profile und Sub-Profile) und Claude Code. Konfigurieren Sie den Schlüssel mit /ayrshare:setup oder der Umgebungsvariable AYRSHARE_API_KEY und starten Sie Claude Code anschließend neu.

Braucht das Posten auf X/Twitter zusätzliche Einrichtung?

Ja. X/Twitter erfordert Ihre eigenen OAuth-1.0a-Anmeldedaten, die als zwei Verbindungs-Header (X-Twitter-OAuth1-Api-Key und X-Twitter-OAuth1-Api-Secret) hinzugefügt werden. Siehe X/Twitter BYO-Anmeldedaten oben.

Installation

Installations-Scopes

Anmeldedaten

X/Twitter BYO-Anmeldedaten

Was es mitbringt

Befehl

Agents

Skills

Bestätigungs-Hook

FAQ

Nächste Schritte

Verbinden & Einrichten

Tool-Katalog

​Installation

​Installations-Scopes

​Anmeldedaten

​X/Twitter BYO-Anmeldedaten

​Was es mitbringt

​Befehl

​Agents

​Skills

​Bestätigungs-Hook

​FAQ

​Nächste Schritte

Verbinden & Einrichten

Tool-Katalog

Installation

Installations-Scopes

Anmeldedaten

X/Twitter BYO-Anmeldedaten

Was es mitbringt

Befehl

Agents

Skills

Bestätigungs-Hook

FAQ

Nächste Schritte