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

# Đưa các tài khoản mạng xã hội của khách hàng vào hệ thống

> Sử dụng MCP Server để đưa các tài khoản mạng xã hội của khách hàng vào dưới các sub-profile với một URL social-linking JWT.

Các nhà tích hợp trên Business Plan hoặc Enterprise Plan có thể đưa các tài khoản mạng xã hội của khách hàng vào dưới **các sub-profile**. Sử dụng [MCP Server](/additional/mcp-action-server), một agent tạo một sub-profile, nhắm tới nó và tạo một URL liên kết single sign-on mà khách hàng mở ra để kết nối các tài khoản của họ.

## Quy trình

<Steps>
  <Step title="Tạo một sub-profile">
    Gọi `create_profile` (cấp tài khoản — không có `profileKey`). Nó trả về một **profile key** cho sub-profile mới.
  </Step>

  <Step title="Nhắm tới sub-profile">
    Sử dụng profile key được trả về trên các lệnh gọi tiếp theo — hoặc qua header `Profile-Key` trên kết nối hoặc dưới dạng đối số `profileKey` theo lệnh gọi. Xem [Kết nối & Thiết lập](/additional/mcp-action-connect#precedence-argument-wins-over-header) để biết thứ tự ưu tiên.
  </Step>

  <Step title="Tạo URL social-linking">
    Gọi `generate_jwt_social_linking_url` để tạo một URL liên kết single sign-on. Khóa ký JWT và tên miền onboarding được lấy **phía server** — người gọi **không** cung cấp header `X-Ayrshare-*` và không cần khóa riêng hoặc tên miền.
  </Step>

  <Step title="Khách hàng liên kết tài khoản của họ">
    Khách hàng mở URL và ủy quyền (OAuth) các tài khoản mạng xã hội của họ. Các tài khoản đã kết nối được liên kết với sub-profile.
  </Step>
</Steps>

## Yêu cầu

<Warning>
  `generate_jwt_social_linking_url` **yêu cầu** một `profileKey`. Nếu không có, lệnh gọi trả về **400** với thông báo **"Profile Key is required…"**.

  Một **tên miền social-linking phải được cấp phép** cho tài khoản của bạn. Điều này có sẵn trên các gói **Business** và **Enterprise**.
</Warning>

### Trạng thái lỗi

| Điều kiện                       | Phản hồi                                                                                                       |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Không có tên miền được cấp phép | **400** — "No social-linking domain is provisioned for this account (available on Business/Enterprise plans)." |
| Không có khóa ký                | **400** — "No signing key found for this account's social-linking domain."                                     |

## Các bước tiếp theo

<CardGroup cols={2}>
  <Card title="Kết nối & Thiết lập" icon="plug" href="/additional/mcp-action-connect" horizontal>
    Xác thực và nhắm tới profile.
  </Card>

  <Card title="Danh mục Công cụ" icon="list" href="/additional/mcp-action-tools" horizontal>
    27 công cụ được nhóm theo miền, với phạm vi và mục đích.
  </Card>
</CardGroup>