Zum Hauptinhalt springen
Der Ayrshare MCP Server ermöglicht es einem KI-Agenten, die Ayrshare API zu steuern. Auf dieser Seite wird beschrieben, wie Sie sich verbinden und wie die Authentifizierung funktioniert.

​
Endpunkt und Transport

Der produktive MCP Server ist erreichbar unter: https://api.ayrshare.com/mcp Er verwendet den Streamable HTTP-Transport und ist stateless – zwischen den Aufrufen wird keine Session aufrechterhalten.

​
Authentifizierung

Die Authentifizierung wird durch dieselbe Ayrshare-API-Kette erzwungen, die auch die REST-API antreibt.
  • Erforderlich: Authorization: Bearer YOUR_API_KEY – Ihr Konto-API-Key (Business-Plan-Schlüssel für Profile und Sub-Profile).
  • Optional: Profile-Key: YOUR_PROFILE_KEY – zielt bei jedem Aufruf der Verbindung auf ein Sub-Profil ab.
  • Optional pro Aufruf: ein profileKey-Tool-Argument – zielt für einen einzelnen Tool-Aufruf auf ein Sub-Profil ab.

​
Vorrang: Argument hat Vorrang vor Header

Wenn ein Tool-Aufruf ein profileKey-Argument enthält und die Verbindung einen Profile-Key-Header hat, hat das pro Aufruf angegebene profileKey-Argument Vorrang. Der Header wird nur verwendet, wenn kein gültiges Argument angegeben ist. Eine Ausnahme: Bei get_platform_history und get_social_network_analytics muss ein userId-/userName-Lookup für X/Twitter ausschließlich den Konto-API-Key verwenden; das Angeben eines profileKey-Arguments oder eines Profile-Key-Headers gibt hier Fehler 400 zurück.
Die MCP-Methoden initialize und tools/list sind vor der Authentifizierung erreichbar – sie liefern nur Metadaten und führen nichts aus. Jeder Tool-Aufruf wird authentifiziert.

​
Authentifizierungsfehler

Ein nicht authentifizierter oder ungültiger Schlüssel bei einem Tool-Aufruf liefert einen Ayrshare-Fehler 403 / Code 102 mit der Meldung „API Key not valid” zurück. Gemäß MCP-Spezifikation werden Fehler bei der Tool-Ausführung inline zurückgegeben: Das Tool-Ergebnis enthält isError: true und diese Meldung, während der MCP-Transport selbst mit HTTP 200 antwortet. (Die 403/102 ist Ayrshares Anwendungsfehler, nicht der Transportstatus.)

​
Verbinden

​
Option A: Claude Code-Plugin

Wenn Sie Claude Code verwenden, installieren Sie das Ayrshare-Plugin. Es enthält die MCP-Server-Konfiguration, einen Setup-Befehl, Agents, Skills und einen Bestätigungs-Hook. Vollständige Installationsschritte finden Sie auf der Seite Claude Code Plugin.

​
Option B: Beliebiger MCP-Client

Für jeden MCP-Client, der Streamable HTTP unterstützt, registrieren Sie den Server direkt. In Claude Code:
Um bei jedem Aufruf ein Sub-Profil anzusprechen, fügen Sie den optionalen Profile-Key-Header hinzu:
Die MCP-Verbindung wird zu Sitzungsbeginn initialisiert. Starten Sie Ihren MCP-Client neu, nachdem Sie den Server installiert oder Ihren Schlüssel geändert haben, damit die neue Konfiguration wirksam wird.

​
X/Twitter BYO-Anmeldedaten

Seit dem 31. März 2026 erfordern X-/Twitter-Operationen über Ayrshare Ihre eigenen OAuth-1.0a-Anmeldedaten. Wenn ein Tool-Aufruf auf X/Twitter abzielt, senden Sie diese beiden Header über die Verbindung zusammen mit Ihren Authorization-Headern (und optional Profile-Key) mit:
HeaderBeschreibung
X-Twitter-OAuth1-Api-KeyIhr OAuth-1.0a-API-Key (Consumer Key)
X-Twitter-OAuth1-Api-SecretIhr OAuth-1.0a-API-Key-Secret (Consumer Secret)
Dies sind dieselben Header, die auch die REST-API verwendet – ein OAuth-1.0a-Schlüsselpaar pro Ayrshare-Konto, das bei jeder X-Anfrage mitgesendet wird (dasselbe Paar gilt für alle Sub-Profile). Ayrshare verwendet hier kein OAuth 2.0. Details zu Setup, Richtlinien und Fehlerbehebung finden Sie in der API-Übersicht und der X BYO Key Setup-Anleitung.
Ohne diese Header gibt ein X-/Twitter-Tool-Aufruf den Fehler 419 (x_credentials_required) zurück.

​
Verbinden mit den BYO-Headern

Um X/Twitter-BYO-Anmeldedaten von Anfang an einzurichten, fügen Sie den Server mit beiden OAuth-1.0a-Headern zusammen mit Ihrem Authorization-Header hinzu (schließen Sie auch Profile-Key ein, wenn Sie bei jedem Aufruf auf ein Sub-Profil abzielen):

​
Die BYO-Header zu einer bestehenden Verbindung hinzufügen

Verbindungs-Header werden beim Hinzufügen des Servers festgelegt. Wenn Sie sich bereits ohne die BYO-Header verbunden haben, entfernen Sie den Server und fügen Sie ihn mit dem vollständigen Satz erneut hinzu (schließen Sie alle bereits verwendeten Header wieder ein, z. B. Profile-Key):
Starten Sie Ihren MCP-Client neu, nachdem Sie Header geändert haben, damit die neue Konfiguration wirksam wird. Verwenden Sie das Claude Code-Plugin statt einer direkten Verbindung? Siehe Claude Code Plugin → X/Twitter BYO-Anmeldedaten.

​
Nächste Schritte

Tool-Katalog

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

Claude Code Plugin

Installieren Sie das Ayrshare-Plugin für Claude Code.