Claude Code Plugin

Installieren Sie das Ayrshare-Plugin für Claude Code, um Beiträge direkt aus Ihrem Editor zu veröffentlichen, zu planen und zu analysieren – mit Validierung vor der Veröffentlichung, einer Bestätigungsabfrage vor dem Publish, Entwürfen im Markenton und dem Zurücklesen von Analytics.

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

1. Marketplace hinzufügen (einmalig)

   claude plugin marketplace add ayrshare/ayrshare-social-media-api-claude-plugin
   
2. 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.

​

Nächste Schritte

Verbinden & Einrichten

Authentifizierung, Profil-Targeting und BYO-Anmeldedaten.

Tool-Katalog

Die 27 Tools nach Domäne gruppiert, mit Scope und Zweck.