> ## 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. # Mit dem MCP Server verbinden > Verbinden Sie jeden MCP-Client mit dem Ayrshare MCP Server: Transport, Endpunkt und Authentifizierung. Der Ayrshare [MCP Server](/additional/mcp-action-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. ### 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](/additional/mcp-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: ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp --header "Authorization: Bearer YOUR_API_KEY" ``` Um bei jedem Aufruf ein Sub-Profil anzusprechen, fügen Sie den optionalen `Profile-Key`-Header hinzu: ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "Profile-Key: YOUR_PROFILE_KEY" ``` 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: | Header | Beschreibung | | ----------------------------- | ----------------------------------------------- | | `X-Twitter-OAuth1-Api-Key` | Ihr OAuth-1.0a-API-Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | Ihr 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](/apis/overview#xtwitter-byo-credentials) und der [X BYO Key Setup-Anleitung](/dashboard/connect-social-accounts/x-twitter-byo-keys). 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): ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \ --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET" ``` ### 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`): ```bash theme={"system"} claude mcp remove ayrshare claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \ --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET" ``` 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](/additional/mcp-claude-code-plugin#xtwitter-byo-credentials). ## Nächste Schritte Die 27 Tools nach Domäne gruppiert, mit Scope und Zweck. Installieren Sie das Ayrshare-Plugin für Claude Code.