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

# Social-Media-Konten von Kunden einbinden

> Nutzen Sie den MCP Server, um die Social-Media-Konten Ihrer Kunden unter Sub-Profilen mit einer JWT-Social-Linking-URL einzubinden.

Integratoren mit einem Business- oder Enterprise-Plan können die Social-Media-Konten ihrer Kunden unter **Sub-Profilen** einbinden. Über den [MCP Server](/additional/mcp-action-server) erstellt ein Agent ein Sub-Profil, adressiert es und erzeugt eine Single-Sign-On-Linking-URL, die der Kunde öffnet, um seine Konten zu verbinden.

## Ablauf

<Steps>
  <Step title="Sub-Profil erstellen">
    Rufen Sie `create_profile` auf (auf Konto-Ebene – ohne `profileKey`). Es liefert einen **Profile Key** für das neue Sub-Profil zurück.
  </Step>

  <Step title="Sub-Profil ansprechen">
    Verwenden Sie den zurückgegebenen Profile Key bei nachfolgenden Aufrufen – entweder über den `Profile-Key`-Header der Verbindung oder als pro Aufruf übergebenes `profileKey`-Argument. Zur Vorrangregelung siehe [Verbinden & Einrichten](/additional/mcp-action-connect#precedence-argument-wins-over-header).
  </Step>

  <Step title="Social-Linking-URL erzeugen">
    Rufen Sie `generate_jwt_social_linking_url` auf, um eine Single-Sign-On-Linking-URL zu erzeugen. Der JWT-Signing-Key und die Onboarding-Domain werden **serverseitig** abgeleitet – der Aufrufer übergibt **keine** `X-Ayrshare-*`-Header und keinen privaten Schlüssel oder Domain.
  </Step>

  <Step title="Kunde verknüpft seine Konten">
    Der Kunde öffnet die URL und autorisiert (per OAuth) seine Social-Media-Konten. Die verbundenen Konten werden mit dem Sub-Profil verknüpft.
  </Step>
</Steps>

## Voraussetzungen

<Warning>
  `generate_jwt_social_linking_url` **erfordert** einen `profileKey`. Wenn keiner ermittelt werden kann, gibt der Aufruf **400** mit der Meldung **„Profile Key is required…"** zurück.

  Für Ihr Konto muss eine **Social-Linking-Domain bereitgestellt** sein. Dies ist im **Business**- und **Enterprise**-Plan verfügbar.
</Warning>

### Fehlerzustände

| Bedingung                    | Antwort                                                                                                        |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Keine bereitgestellte Domain | **400** – „No social-linking domain is provisioned for this account (available on Business/Enterprise plans)." |
| Kein Signing-Key             | **400** – „No signing key found for this account's social-linking domain."                                     |

## Nächste Schritte

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