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

# Підключення соціальних акаунтів клієнтів

> Використовуйте MCP Server для підключення соціальних акаунтів клієнтів під субпрофілями за допомогою JWT-URL для підключення соцмереж.

Інтегратори на плані Business або Enterprise можуть підключати соціальні акаунти своїх клієнтів під **субпрофілями**. За допомогою [MCP Server](/additional/mcp-action-server) агент створює субпрофіль, націлює на нього дії та формує URL єдиного входу для підключення, який клієнт відкриває, щоб під'єднати свої акаунти.

## Процес

<Steps>
  <Step title="Створіть субпрофіль">
    Викличте `create_profile` (на рівні акаунта — без `profileKey`). Він поверне **profile key** для нового субпрофіля.
  </Step>

  <Step title="Націльтеся на субпрофіль">
    Використовуйте отриманий profile key у подальших викликах — або через заголовок `Profile-Key` на з'єднанні, або як аргумент `profileKey` для кожного виклику. Про пріоритет див. [Connect & Setup](/additional/mcp-action-connect#precedence-argument-wins-over-header).
  </Step>

  <Step title="Сформуйте URL для підключення соцмереж">
    Викличте `generate_jwt_social_linking_url`, щоб сформувати URL єдиного входу для підключення. Ключ підпису JWT та домен підключення визначаються **на боці сервера** — виклик **не** передає жодних заголовків `X-Ayrshare-*`, приватного ключа чи домену.
  </Step>

  <Step title="Клієнт підключає свої акаунти">
    Клієнт відкриває URL і авторизує (через OAuth) свої соціальні акаунти. Підключені акаунти прив'язуються до субпрофіля.
  </Step>
</Steps>

## Вимоги

<Warning>
  `generate_jwt_social_linking_url` **вимагає** `profileKey`. Якщо жоден не визначено, виклик поверне **400** з повідомленням **"Profile Key is required…"**.

  Для вашого акаунта має бути **виділено домен для підключення соцмереж**. Ця можливість доступна на планах **Business** та **Enterprise**.
</Warning>

### Стани помилок

| Умова                   | Відповідь                                                                                                      |
| ----------------------- | -------------------------------------------------------------------------------------------------------------- |
| Немає виділеного домену | **400** — "No social-linking domain is provisioned for this account (available on Business/Enterprise plans)." |
| Немає ключа підпису     | **400** — "No signing key found for this account's social-linking domain."                                     |

## Наступні кроки

<CardGroup cols={2}>
  <Card title="Connect & Setup" icon="plug" href="/additional/mcp-action-connect" horizontal>
    Автентифікація та націлення на профіль.
  </Card>

  <Card title="Каталог інструментів" icon="list" href="/additional/mcp-action-tools" horizontal>
    27 інструментів, згрупованих за доменом, з описом призначення та області дії.
  </Card>
</CardGroup>