Skip to main content
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.

​
Unterstützte Clients

Die Authentifizierung beim Action MCP Server erfolgt ausschließlich über einen statischen Authorization: Bearer-Request-Header. Diese eine Anforderung entscheidet über alles Folgende: Ein Client, der auf einer Streamable-HTTP-Verbindung einen benutzerdefinierten HTTP-Header setzen kann, kann sich authentifizieren – ein Client, der das nicht kann, kann es nicht. Suchen Sie Ihren Client heraus, bevor Sie mit der Einrichtung beginnen.

​
Warum persönliche Connectors sich nicht authentifizieren können

Ayrshares Action MCP erfordert einen statischen Authorization: Bearer-Header. Ihn als persönlichen Custom Connector auf claude.ai, Claude Desktop oder Claude mobile hinzuzufügen, funktioniert nicht, weil Ayrshare keine OAuth-Metadaten veröffentlicht und die Request-Header-Alternative eine Beta ist, die auf zugelassene Organisationen beschränkt ist. Bei einem persönlichen Connector lässt sich das durch keine Einstellung auf Ihrer Seite beheben: Es gibt kein Feld für einen Authorization-Header und keinen API-Key, kein Profil und keine Kontoeinstellung, die einen solchen aktiviert. Ayrshare veröffentlicht keine OAuth-Metadaten, der OAuth-Pfad des Connectors hat also nichts, womit er sich verbinden könnte. Verwenden Sie stattdessen einen Client aus der obigen Tabelle: Claude Code, das Claude Code-Plugin oder jeden Client, mit dem Sie einen benutzerdefinierten Authorization-Header setzen können. Wenn Sie Administrator einer Organisation in Anthropics Request-Header-Beta sind, siehe Team- und Enterprise-Organisationen weiter unten.
Wenn Ihr Connector gesund aussieht, aber jedes Tool fehlschlägt. Der Connector lässt sich sauber hinzufügen, meldet sich als gesund und listet den vollständigen Tool-Katalog auf – und dann gibt jeder Tool-Aufruf Ayrshare-403 / Code 102, „API Key not valid” zurück. Das ist genau diese Einschränkung, kein defekter Schlüssel – Ihr Client kann den statischen Authorization: Bearer-Header, den dieser Server erfordert, nicht senden. initialize und tools/list sind vor der Authentifizierung erreichbar (siehe Authentifizierung weiter unten), daher schlägt nichts fehl bis zum ersten Tool-Aufruf – dann wird klar, dass nie Anmeldedaten gesendet wurden.Client-Fähigkeit oder tatsächlich ein ungültiger Schlüssel? Beide liefern denselben Fehler zurück, unterscheiden Sie sie daher anhand der Signatur. Ein Fehlschlag aufgrund der Client-Fähigkeit bedeutet: Der Connector ist gesund und jedes Tool schlägt fehl, während derselbe Schlüssel anderswo funktioniert. Ein ungültiger Schlüssel erzeugt denselben Fehler, ist aber außerhalb des Connectors reproduzierbar – er schlägt auch bei einem REST-Aufruf fehl. Zur Fehlersemantik selbst siehe Authentifizierungsfehler weiter unten.

​
Team- und Enterprise-Organisationen

Anthropics static_headers-Mechanismus ermöglicht es einem Custom Connector, statt OAuth feste Anmeldedaten als Request-Header zu senden. Er ist in der Beta für Organisationsadministratoren einer begrenzten Zahl von Organisationen verfügbar und steht einzelnen Nutzern, die einen persönlichen Connector hinzufügen, nicht zur Verfügung. Wenn Ihre Organisation Zugriff hat, muss der Administrator den Header-Wert als Bearer gefolgt von Ihrem Ayrshare-API-Key eingeben – einschließlich des Leerzeichens: Claude sendet den Wert exakt wie eingegeben und fügt das Schema nicht für Sie hinzu. Aktuelle Verfügbarkeit und Einrichtung finden Sie in Anthropics Dokumentation zur Connector-Authentifizierung.
Der Schlüssel wird von der gesamten Organisation geteilt. Anthropics Request-Header-Anmeldedaten werden einmal von einem Administrator eingegeben und von jedem Mitglied der Organisation verwendet – alle agieren also als das eine Ayrshare-Konto, dem dieser Schlüssel gehört: mit Zugriff auf jedes User Profile darunter bei einem Business-Schlüssel und ohne Zuordnung zu einzelnen Nutzern in Ihrer Ayrshare-Historie oder -Analytics. Behandeln Sie ihn als geteilte Dienst-Anmeldedaten, nicht als individuellen Zugang.

​
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 und Ihnen das Setzen eines benutzerdefinierten Request-Headers erlaubt – siehe Unterstützte Clients weiter oben –, 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: 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 33 Tools nach Domäne gruppiert, mit Scope und Zweck.

Claude Code Plugin

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