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

# Onboarding de Contas Sociais de Clientes

> Use o MCP Server para fazer o onboarding das contas sociais de clientes sob sub-profiles com uma URL de vinculação social JWT.

Integradores no Business Plan ou Enterprise Plan podem fazer o onboarding das contas sociais dos seus clientes sob **sub-profiles**. Usando o [MCP Server](/additional/mcp-action-server), um agente cria um sub-profile, o direciona e gera uma URL de vinculação com single sign-on que o cliente abre para conectar suas contas.

## Fluxo

<Steps>
  <Step title="Crie um sub-profile">
    Chame `create_profile` (nível de conta — sem `profileKey`). Ele retorna uma **profile key** para o novo sub-profile.
  </Step>

  <Step title="Direcione para o sub-profile">
    Use a profile key retornada nas chamadas seguintes — seja via o header `Profile-Key` na conexão ou como argumento `profileKey` por chamada. Veja [Conectar e Configurar](/additional/mcp-action-connect#precedence-argument-wins-over-header) para a precedência.
  </Step>

  <Step title="Gere uma URL de vinculação social">
    Chame `generate_jwt_social_linking_url` para gerar uma URL de vinculação com single sign-on. A chave de assinatura JWT e o domínio de onboarding são derivados **no servidor** — o chamador **não** fornece headers `X-Ayrshare-*` nem chave privada ou domínio.
  </Step>

  <Step title="O cliente vincula suas contas">
    O cliente abre a URL e autoriza (OAuth) suas contas sociais. As contas conectadas são vinculadas ao sub-profile.
  </Step>
</Steps>

## Requisitos

<Warning>
  `generate_jwt_social_linking_url` **exige** uma `profileKey`. Se nenhuma for resolvida, a chamada retorna **400** com a mensagem **"Profile Key is required…"**.

  Um **domínio de vinculação social deve estar provisionado** para sua conta. Isso está disponível nos planos **Business** e **Enterprise**.
</Warning>

### Estados de erro

| Condição                    | Resposta                                                                                                       |
| --------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Nenhum domínio provisionado | **400** — "No social-linking domain is provisioned for this account (available on Business/Enterprise plans)." |
| Nenhuma chave de assinatura | **400** — "No signing key found for this account's social-linking domain."                                     |

## Próximos passos

<CardGroup cols={2}>
  <Card title="Conectar e Configurar" icon="plug" href="/additional/mcp-action-connect" horizontal>
    Autenticação e direcionamento de profile.
  </Card>

  <Card title="Catálogo de Tools" icon="list" href="/additional/mcp-action-tools" horizontal>
    As 27 tools agrupadas por domínio, com escopo e propósito.
  </Card>
</CardGroup>