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

# Incorporar cuentas sociales de clientes

> Usa el MCP Server para incorporar las cuentas sociales de tus clientes bajo sub-perfiles con una URL de vinculación social JWT.

Los integradores con un plan Business o Enterprise pueden incorporar las cuentas sociales de sus clientes bajo **sub-perfiles**. Usando el [MCP Server](/additional/mcp-action-server), un agente crea un sub-perfil, lo apunta y genera una URL de vinculación con single sign-on que el cliente abre para conectar sus cuentas.

## Flujo

<Steps>
  <Step title="Crea un sub-perfil">
    Llama a `create_profile` (a nivel de cuenta — sin `profileKey`). Devuelve una **profile key** para el nuevo sub-perfil.
  </Step>

  <Step title="Apunta al sub-perfil">
    Usa la profile key devuelta en las llamadas siguientes — ya sea con la cabecera `Profile-Key` en la conexión o como un argumento `profileKey` por llamada. Consulta [Conexión y configuración](/additional/mcp-action-connect#precedence-argument-wins-over-header) para la precedencia.
  </Step>

  <Step title="Genera una URL de vinculación social">
    Llama a `generate_jwt_social_linking_url` para generar una URL de vinculación con single sign-on. La clave de firma del JWT y el dominio de onboarding se derivan **del lado del servidor** — el llamador **no** proporciona cabeceras `X-Ayrshare-*` ni clave privada ni dominio.
  </Step>

  <Step title="El cliente vincula sus cuentas">
    El cliente abre la URL y autoriza (OAuth) sus cuentas sociales. Las cuentas conectadas quedan vinculadas al sub-perfil.
  </Step>
</Steps>

## Requisitos

<Warning>
  `generate_jwt_social_linking_url` **requiere** un `profileKey`. Si no se resuelve ninguno, la llamada devuelve **400** con el mensaje **"Profile Key is required…"**.

  Debe estar **provisionado un dominio de vinculación social** para tu cuenta. Esto está disponible en los planes **Business** y **Enterprise**.
</Warning>

### Estados de error

| Condición                | Respuesta                                                                                                      |
| ------------------------ | -------------------------------------------------------------------------------------------------------------- |
| Sin dominio provisionado | **400** — "No social-linking domain is provisioned for this account (available on Business/Enterprise plans)." |
| Sin clave de firma       | **400** — "No signing key found for this account's social-linking domain."                                     |

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Conexión y configuración" icon="plug" href="/additional/mcp-action-connect" horizontal>
    Autenticación y direccionamiento de perfiles.
  </Card>

  <Card title="Catálogo de herramientas" icon="list" href="/additional/mcp-action-tools" horizontal>
    Las 27 herramientas agrupadas por dominio, con alcance y propósito.
  </Card>
</CardGroup>