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

# Intégrer les comptes sociaux des clients

> Utilisez le MCP Server pour intégrer les comptes sociaux de vos clients sous forme de sous-profils avec une URL d'association sociale JWT.

Les intégrateurs disposant d'un Business Plan ou Enterprise Plan peuvent intégrer les comptes sociaux de leurs clients sous forme de **sous-profils**. À l'aide du [MCP Server](/additional/mcp-action-server), un agent crée un sous-profil, le cible, et génère une URL d'association en authentification unique que le client ouvre pour connecter ses comptes.

## Flux

<Steps>
  <Step title="Créer un sous-profil">
    Appelez `create_profile` (au niveau du compte — sans `profileKey`). Il renvoie une **profile key** pour le nouveau sous-profil.
  </Step>

  <Step title="Cibler le sous-profil">
    Utilisez la profile key renvoyée sur les appels suivants — soit via l'en-tête `Profile-Key` sur la connexion, soit comme argument `profileKey` par appel. Consultez [Connect & Setup](/additional/mcp-action-connect#precedence-argument-wins-over-header) pour la priorité.
  </Step>

  <Step title="Générer une URL d'association sociale">
    Appelez `generate_jwt_social_linking_url` pour générer une URL d'association en authentification unique. La clé de signature JWT et le domaine d'onboarding sont dérivés **côté serveur** — l'appelant ne fournit **aucun** en-tête `X-Ayrshare-*` et aucune clé privée ni domaine.
  </Step>

  <Step title="Le client associe ses comptes">
    Le client ouvre l'URL et autorise (OAuth) ses comptes sociaux. Les comptes connectés sont associés au sous-profil.
  </Step>
</Steps>

## Prérequis

<Warning>
  `generate_jwt_social_linking_url` **requiert** un `profileKey`. Si aucun n'est résolu, l'appel renvoie **400** avec le message **« Profile Key is required… »**.

  Un **domaine d'association sociale doit être provisionné** pour votre compte. Cette fonctionnalité est disponible sur les **Business Plan** et **Enterprise Plan**.
</Warning>

### États d'erreur

| Condition                 | Réponse                                                                                                          |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Aucun domaine provisionné | **400** — « No social-linking domain is provisioned for this account (available on Business/Enterprise plans). » |
| Aucune clé de signature   | **400** — « No signing key found for this account's social-linking domain. »                                     |

## Étapes suivantes

<CardGroup cols={2}>
  <Card title="Connect & Setup" icon="plug" href="/additional/mcp-action-connect" horizontal>
    Authentification et ciblage de profil.
  </Card>

  <Card title="Tool Catalog" icon="list" href="/additional/mcp-action-tools" horizontal>
    Les 27 outils regroupés par domaine, avec leur portée et leur objectif.
  </Card>
</CardGroup>