メインコンテンツへスキップ
Business または Enterprise プランのインテグレーターは、クライアントのソーシャルアカウントを サブプロファイル 配下にオンボーディングできます。MCP Server を使用すると、エージェントがサブプロファイルを作成し、対象を指定して、クライアントが開いてアカウントを接続するためのシングルサインオンリンキング URL を発行します。

​
フロー

1

サブプロファイルを作成

create_profile を呼び出します（アカウントレベル — profileKey なし）。新しいサブプロファイルの profile key が返されます。
2

サブプロファイルをターゲットにする

以降の呼び出しでは、返された profile key を使用します — 接続の Profile-Key ヘッダー経由、または呼び出しごとの profileKey 引数として指定します。優先順位については Connect & Setup を参照してください。
3

ソーシャルリンキング URL を発行

generate_jwt_social_linking_url を呼び出してシングルサインオンリンキング URL を発行します。JWT の署名鍵およびオンボーディングドメインは サーバー側 で導出されます — 呼び出し側は X-Ayrshare-* ヘッダー、秘密鍵、ドメインを一切提供しません。
4

クライアントがアカウントを連携

クライアントは URL を開き、ソーシャルアカウントを認可（OAuth）します。接続されたアカウントはサブプロファイルに紐付けられます。

​
要件

generate_jwt_social_linking_url は profileKey を 必須 とします。解決できない場合、呼び出しは 400 と “Profile Key is required…” メッセージを返します。アカウントに ソーシャルリンキング用ドメインがプロビジョニングされている必要があります。これは Business および Enterprise プランで利用できます。

​
エラー状態

​
次のステップ

Connect & Setup

認証とプロファイルターゲティング。

Tool Catalog

ドメイン別にグループ化された 27 のツール、スコープと目的。