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

# 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](/additional/mcp-action-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](https://github.com/ayrshare/ayrshare-social-media-api-claude-plugin).

## Installation

<Steps>
  <Step title="Marketplace hinzufügen (einmalig)">
    ```bash theme={"system"}
    claude plugin marketplace add ayrshare/ayrshare-social-media-api-claude-plugin
    ```
  </Step>

  <Step title="Das Plugin installieren">
    ```bash theme={"system"}
    claude plugin install ayrshare@ayrshare
    ```
  </Step>
</Steps>

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

<Note>
  Das CLI von Claude Code nennt den globalen Scope `--scope user`.
</Note>

## Anmeldedaten

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

<ul class="custom-bullets">
  <li>Führen Sie `/ayrshare:setup` aus, um den Schlüssel zu konfigurieren oder zu wechseln.</li>
  <li>Setzen Sie die Umgebungsvariable `AYRSHARE_API_KEY`.</li>
</ul>

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.

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

### 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](/apis/overview#xtwitter-byo-credentials)). Die eingebundene `.mcp.json` deklariert bereits beide X-BYOK-Header mit leeren Standardwerten – neben `Authorization` und `Profile-Key`:

```json theme={"system"}
"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).

<Note>
  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](/additional/mcp-action-connect#xtwitter-byo-credentials).
</Note>

## Was es mitbringt

### Befehl

<ul class="custom-bullets">
  <li>`/ayrshare:setup` – Ayrshare API Key konfigurieren oder wechseln.</li>
</ul>

### Agents

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

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

<ul class="custom-bullets">
  <li>`create_post`</li>
  <li>`update_post`</li>
  <li>`retry_post`</li>
  <li>`add_comment`</li>
  <li>`reply_comment`</li>
  <li>`send_message`</li>
  <li>`set_auto_response`</li>
</ul>

## FAQ

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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`.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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](#xtwitter-byo-credentials) oben.
  </Accordion>
</AccordionGroup>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Verbinden & Einrichten" icon="plug" href="/additional/mcp-action-connect" horizontal>
    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>
</CardGroup>