refactor: refine wording

Author: gao-sun

docs/use-cases/ai/README.mdx

@@ -1,6 +1,6 @@
 ---
 sidebar_position: 3
-sidebar_label: AI use cases
+sidebar_label: AI
 description: Explore how Logto can help you build secure, AI-enabled experiences.
 ---
 

docs/use-cases/ai/enable-ai-agent-access.mdx renamed to docs/use-cases/ai/enable-third-party-ai-agent-access.mdx

@@ -1,9 +1,9 @@
 ---
 sidebar_position: 3
-sidebar_label: Enable AI agent access to app
+sidebar_label: Enable third-party AI agent access to app
 ---
 
-# Enable AI agent access to your app
+# Enable third-party AI agent access to your app
 
 :::caution
 👷 This tutorial is still in progress. Please check back later for updates. 🚧

docs/use-cases/ai/fragments/_catalog.mdx

@@ -21,10 +21,10 @@ Explore how Logto empowers you to build secure, AI-enabled experiences. Whether
     },
     {
       type: 'link',
-      label: 'Enable AI agent and third-party app access to your MCP server',
-      href: '/use-cases/ai/mcp-server-enable-ai-agent-and-third-party-access',
+      label: 'Enable third-party AI agent access to your MCP server',
+      href: '/use-cases/ai/mcp-server-enable-third-party-ai-agent-access',
       description:
-        'Find out how to enable authentication and authorization for AI agents and third-party apps connecting to your MCP server.',
+        'Find out how to enable authentication and authorization for third-party AI agents and apps connecting to your MCP server.',
       customProps: {
         icon: <FlaskIcon />,
       },
@@ -38,10 +38,10 @@ Explore how Logto empowers you to build secure, AI-enabled experiences. Whether
   items={[
     {
       type: 'link',
-      label: 'Enable AI agent access to your app',
-      href: '/use-cases/ai/enable-ai-agent-access',
+      label: 'Enable third-party AI agent access to your app',
+      href: '/use-cases/ai/enable-third-party-ai-agent-access',
       description:
-        'Discover how to add authentication and authorization for AI agents accessing your app, ensuring security and control across AI-driven workflows.',
+        'Discover how to add authentication and authorization for third-party AI agents accessing your app, ensuring security and control across AI-driven workflows.',
       customProps: {
         icon: <RobotIcon />,
       },

docs/use-cases/ai/mcp-server-enable-ai-agent-and-third-party-access.mdx renamed to docs/use-cases/ai/mcp-server-enable-third-party-ai-agent-access.mdx

@@ -1,6 +1,6 @@
 ---
 sidebar_position: 2
-sidebar_label: Enable AI agent and third-party app access to MCP server
+sidebar_label: Enable third-party AI agent access to MCP server
 ---
 
 import QuickStartsReference from '../../quick-starts/third-party/oidc/_quick-starts-reference.md';
@@ -10,10 +10,10 @@ import Prerequisites from './fragments/_mcp-prerequisites.mdx';
 import SampleCode from './fragments/_mcp-sample-code.mdx';
 import SetUpServer from './fragments/_mcp-set-up-server.mdx';
 
-# Enable AI agent and third-party app access to your MCP server
+# Enable third-party AI agent access to your MCP server
 
 :::note
-If you want to integrate your MCP server with your own app, please refer to the [Enable auth for your MCP-powered apps with Logto](./mcp-server-add-auth) guide.
+If you want to integrate your MCP server with your own AI agent or app, please refer to the [Enable auth for your MCP-powered apps with Logto](./mcp-server-add-auth) guide.
 :::
 
 This guide walks you through integrating Logto with your MCP server using [mcp-auth](https://mcp-auth.dev), allowing you to authenticate users and securely retrieve their identity information using the standard OpenID Connect flow.
@@ -22,28 +22,30 @@ You'll learn how to:
 
 - Configure Logto as the authorization server for your MCP server.
 - Set up a “whoami” tool to return the current user's identity claims.
-- Test the flow with an AI agent or third-party app.
+- Test the flow with a third-party AI agent.
 
 After this tutorial, your MCP server will:
 
 - Authenticate users in your Logto tenant.
 - Return identity claims (`sub`, `username`, `name`, `email`, etc.) for the "whoami" tool invocation.
 
-<Prerequisites clientDescription="The AI agent or third-party app will be used as the client in this guide." />
+<Prerequisites clientDescription="The third-party AI agent will be used as the client in this guide." />
 
-## Set up AI agent or third-party app
+## Set up third-party AI agent
 
-To enable the AI agent or third-party app (client) to access your MCP server, you need to set up the following:
+To enable the third-party AI agent to access your MCP server, you need to set up the following:
 
 1. The client should be able to make MCP requests to invoke the tools exposed by the MCP server.
 2. The client should be able to handle the 401 Unauthorized response. See [Authorization Flow Steps](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization#2-5-authorization-flow-steps) for more details.
 3. After successful authentication, the client should be able to make requests to the MCP server with the access token obtained from Logto.
 
-## Set up app in Logto
+## Set up AI agent in Logto
 
-### Allow developers to create third-party apps
+To enable the third-party AI agent to access your MCP server, you need to set up a **third-party app** in Logto. This app will be used to represent the AI agent and obtain the necessary credentials for authentication and authorization.
 
-If you are building a marketplace or want to allow developers to create third-party apps, you can leverage [Logto Management API](/integrate-logto/interact-with-management-api) to create third-party apps programmatically. This allows developers to register their applications and obtain the necessary credentials for authentication.
+### Allow developers to create third-party apps in Logto
+
+If you are building a marketplace or want to allow developers to create third-party apps in Logto, you can leverage [Logto Management API](/integrate-logto/interact-with-management-api) to create third-party apps programmatically. This allows developers to register their applications and obtain the necessary credentials for authentication.
 
 You'll need to host your own service to handle the client registration process. This service will interact with the Logto Management API to create third-party apps on behalf of developers.
 
@@ -57,7 +59,7 @@ flowchart LR
 
 Alternatively, you can manually create third-party apps in Logto Console to get familiar with the process.
 
-### Manually create a third-party app
+### Manually create a third-party app in Logto
 
 You can manually create a third-party app in Logto Console for testing purposes or ad-hoc integrations. This is useful when you want to quickly test the integration without implementing a full client-registration flow.
 
@@ -84,7 +86,7 @@ You can manually create a third-party app in Logto Console for testing purposes
 ## Test the integration
 
 1. Start the MCP server.
-2. Start the AI agent or third-party app (client).
+2. Start the AI agent.
 3. In the client, invoke the `whoami` tool to retrieve the current user's identity claims.
 4. The client should handle the 401 Unauthorized response and redirect the user to Logto for authentication.
 5. After successful authentication, the client should receive an access token and use it to make requests to the MCP server.

docs/use-cases/authorization/README.mdx

@@ -1,6 +1,6 @@
 ---
 sidebar_position: 1
-sidebar_label: Authorization use cases
+sidebar_label: Authorization
 description: Explore how Logto can help you build flexible authorization with role-based access control (RBAC) and resource indicators.
 ---
 

docs/use-cases/multi-tenancy/README.mdx

@@ -1,6 +1,6 @@
 ---
 sidebar_position: 2
-sidebar_label: Multi-tenancy use cases
+sidebar_label: Multi-tenancy
 description: Explore how Logto can help you build multi-tenancy applications with ease.
 ---