> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.com/llms.txt
> Use this file to discover all available pages before exploring further.

# UCPリソースサーバーを構成する

> APIをUCPサーバーとして構成し、そのスコープをテナントの検出メタデータで公開します。

> [!WARNING]
>
> **Auth for UCP機能は[早期アクセス](https://auth0.com/docs/ja-jp/troubleshoot/product-lifecycle/product-release-stages.md)段階にあります。**
>
> この機能を使用することで、OktaのMaster Subscription Agreementに定める該当の無料トライアル条件に同意したものとみなされます。参加をご希望の場合は、[Limited Early Access Partnership Programフォーム](https://forms.gle/7qjaSh4ZQSqrysf27)にご記入のうえ、ご関心をお知らせください。

Geminiなどのエージェントプラットフォームは、認可サーバーが公開するスコープをもとに同意画面を構築します。UCPスコープを検出できるようにするには、APIをUCPリソースサーバーとして設定してください。これにより、Auth0がそのスコープをテナントの[検出メタデータ](https://auth0.com/docs/ja-jp/ai-agents-mcp/auth-for-ucp/scope-discovery-metadata.md)で公開します。

## 前提条件

* UCPサーバーを表す[API](https://auth0.com/docs/ja-jp/get-started/apis)。
* Resource Parameter Compatibility Profile (任意) ：MCPクライアントを使用する場合は、テナント設定でこのプロファイルを有効にすることをお勧めします。これを有効にすると、オーディエンスが指定されていない場合に認可サーバーがresourceパラメーターを確認し、リソース固有のリクエスト ([RFC 8707](https://www.rfc-editor.org/rfc/rfc8707.html#name-resource-parameter)) を処理できるようになります。

## UCPリソースサーバーを構成する

UCPリソースサーバーとして構成できるAPIは、1つのテナントにつき1つだけです。

> [tab] Auth0 Dashboard
>
> 1. \*\*［ダッシュボード］>［Applications］>［APIs］\*\*に移動して、対象のAPIを選択します。
> 2. \*\*［Settings (設定) ］**タブで、**［Universal Commerce Protocol］\*\*セクションを探します。
> 3. \*\*［UCP Resource Server (UCPリソースサーバー) ］\*\*を有効にします。
> 4. \*\*［Save (保存) ］\*\*を選択します。
>
> テナント内の別のAPIでこの設定がすでに有効になっている場合は、保存時にエラーが発生し、競合しているAPIの名前が表示されます。
>
> APIにUCPを構成したら、UCPスコープを追加します。
>
> 1. \*\*［Permissions (権限) ］\*\*タブを選択します。
> 2. UCPサーバーがサポートするスコープをそれぞれ追加します。UCPスコープは`dev.ucp`で始まります (例：`dev.ucp.shopping.order:read`、`dev.ucp.shopping.cart:manage`、`dev.ucp.shopping.checkout:manage`) 。各スコープには説明を入力してください。

> [tab] Management API
>
> Management APIのアクセストークンに`create:resource_servers`または`update:resource_servers`権限が付与されていることを確認してください。
>
> 新しいUCPリソースサーバーを作成するには、`/api/v2/resource-servers`に`POST`リクエストを送信します。
>
> ```bash theme={null}
> curl --request POST \
>   --url 'https://YOUR_AUTH0_DOMAIN/api/v2/resource-servers' \
>   --header 'Content-Type: application/json' \
>   --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN' \
>   --data '{
>     "name": "Acme UCP Server",
>     "identifier": "https://ucp.acme.example.com",
>     "type": "universal_commerce_protocol_server",
>     "scopes": [
>       { "value": "dev.ucp.shopping.order:read", "description": "Read orders" },
>       { "value": "dev.ucp.shopping.cart:manage", "description": "Manage carts" },
>       { "value": "dev.ucp.shopping.checkout:manage", "description": "Manage checkout" }
>     ]
>   }'
> ```
>
> 既存のAPIをUCPサーバーとして構成するには、`"type": "universal_commerce_protocol_server"`を指定して`/api/v2/resource-servers/{id}`に`PATCH`リクエストを送信します。typeは、`dev.ucp.*`スコープを追加する前に設定するか、スコープの追加と同じリクエスト内で設定してください。標準のAPIにUCPスコープを追加しようとするリクエストは拒否されます。

## デフォルトのオーディエンスを設定する

Geminiなどのエージェントプラットフォームは、`scope`パラメーターを送信しますが、`audience`パラメーターは送信しません。オーディエンスが指定されていないと、Auth0はどのAPI向けにトークンを発行すればよいかを判断できません。早期アクセス期間中、Auth0はテナントのデフォルトのオーディエンスを使ってこれを解決します。

UCPリソースサーバーの識別子を、テナントのデフォルトのオーディエンスとして設定します。

1. **［ダッシュボード］>［Settings (設定) ］>［General (一般) ］**に移動します。
2. **［API Authorization Settings (API認可設定) ］**で、**［Default Audience (デフォルトのオーディエンス) ］**にUCPリソースサーバーの識別子を設定します。
3. **［保存］**を選択します。

アプリケーションごとにデフォルトのオーディエンスを設定する機能は、今後のリリースで提供される予定です。

## 次のステップ

* [標準アカウントリンクをセットアップする](https://auth0.com/docs/ja-jp/ai-agents-mcp/auth-for-ucp/set-up-standard-account-linking.md)