Skip to content

Commit 0c3ac64

Browse files
Add this sections only for next and asgardeo
1 parent 7107ca7 commit 0c3ac64

7 files changed

Lines changed: 30 additions & 0 deletions

File tree

en/includes/guides/agentic-ai/mcp/index.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,9 +34,15 @@ MCP servers can be registered as protected resources in {{ product_name }}. This
3434

3535
## [Setting up MCP clients]({{base_path}}/guides/agentic-ai/mcp/register-mcp-client-app/)
3636

37+
{% if is_version == "next" or product_name == "Asgardeo" %}
3738
An MCP client is a connection component that host applications use to interface with MCP servers through dedicated, stateful sessions. When connecting to an MCP server, you can register the client application in {{ product_name }}, which also creates an OAuth 2.1 client meeting the necessary standards. Applications can be authorized with specific scopes that define their permitted access to MCP servers, ensuring they operate only within authorized boundaries and maintain a secure ecosystem for model interactions.
3839

3940
{{ product_name }} provides a specialized **MCP Client Application** template for quickly setting up applications optimized for MCP connections. However, MCP servers can also be accessed by most other application types (such as Single Page Applications, Traditional Web Applications, and Mobile Applications), with the exception of Digital Wallet applications.
41+
{% else %}
42+
An MCP client is a connection component that host applications use to interface with MCP servers through dedicated, stateful sessions. When connecting to an MCP server, you can register the client in {{ product_name }}, which also creates an OAuth 2.1 client meeting the necessary standards. Clients can be authorized with specific scopes that define their permitted access to MCP servers, ensuring they operate only within authorized boundaries and maintain a secure ecosystem for model interactions.
43+
44+
{{ product_name }} provides an application template with default configurations to register an MCP client with minimal effort.
45+
{% endif %}
4046

4147
!!! info
4248
Refer to the [MCP Client Registration guide]({{base_path}}/guides/agentic-ai/mcp/register-mcp-client-app/) for detailed steps on setting up MCP clients and authorizing them to access MCP servers.

en/includes/guides/applications/register-mcp-client-app.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,14 @@
22

33
The Model Context Protocol (MCP) specification defines that authorization is initiated by MCP clients. These clients handle authorization flows, manage tokens and sessions with MCP servers, and provide end-user experiences based on user permissions.
44

5+
{% if is_version == "next" or product_name == "Asgardeo" %}
56
{{ product_name }} provides an **MCP Client Application** template with default configurations to register an MCP client with minimal effort. This template has been configured to create an OAuth application that adheres to the guidelines and best practices outlined in the [MCP authorization specification](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization).
67

78
!!! info "Other Application Types"
89
While the MCP Client Application template is optimized for MCP connections, MCP servers can also be accessed by most other application types in {{ product_name }}, including Single Page Applications, Traditional Web Applications, Mobile Applications, and M2M Applications. The only exception is Digital Wallet applications, which cannot access MCP servers.
10+
{% else %}
11+
{{ product_name }} provides an application template with default configurations to register an MCP client with minimal effort. This template has been configured to create an OAuth application that adheres to the guidelines and best practices outlined in the [MCP authorization specification](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization).
12+
{% endif %}
913

1014
## Register an MCP Client Application
1115

en/includes/guides/authorization/mcp-server-authorization.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,13 +58,21 @@ To register an MCP server,
5858
Applications, by default, don't have permissions to access MCP servers. Administrators can selectively grant authorization for applications to use specific MCP servers, so that users logging into the application will have access to that MCP server, provided they're assigned to a role that grants the necessary permissions.
5959

6060
!!! note
61+
{% if is_version == "next" or product_name == "Asgardeo" %}
6162
MCP servers can be authorized to all OIDC application types including Custom OIDC applications, Traditional Web applications, Single-Page applications (SPA), Mobile applications, and Machine-to-Machine (M2M) applications. The [MCP Client Application]({{base_path}}/guides/applications/register-mcp-client-app/) template provides a pre-configured option for MCP-specific use cases. Digital Wallet applications can only access Verifiable Credential resources and cannot authorize MCP servers.
63+
{% else %}
64+
Currently MCP servers can only be authorized to applications that are created from the [MCP client Application]({{base_path}}/guides/applications/register-mcp-client-app/) template.
65+
{% endif %}
6266

6367
To authorize an application to consume an MCP server,
6468

6569
1. On the {{ product_name }} Console, go to **Applications**.
6670

71+
{% if is_version == "next" or product_name == "Asgardeo" %}
6772
2. Select your application and go to its **Authorization** tab.
73+
{% else %}
74+
2. Select the MCP client application and go to its **Authorization** tab.
75+
{% endif %}
6876

6977
3. Click **Authorize a resource**.
7078

@@ -80,7 +88,11 @@ To authorize an application to consume an MCP server,
8088
</tr>
8189
<tr>
8290
<td><b>Authorized Scopes</b></td>
91+
{% if is_version == "next" or product_name == "Asgardeo" %}
8392
<td>Select the scopes that the application should be able to request.</td>
93+
{% else %}
94+
<td>Select the scopes that the MCP client should be able to request.</td>
95+
{% endif %}
8496
</tr>
8597
</table>
8698

en/includes/quick-starts/agent-auth-py.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,8 +50,10 @@ To allow your agent (or user acting through the agent) to authenticate and conne
5050
!!! Info
5151
The **authorized redirect URL** defines the location Asgardeo sends users to after a successful login, typically the address of the client application that connects to the MCP server.
5252
In this guide, the AI agent behaves as the client, which consists of a lightweight OAuth 2.1 callback server running at `http://localhost:6274/oauth/callback` to capture the authorization code. So, we will use this URL as the authorized redirect for this guide.
53+
{% if is_version == "next" or product_name == "Asgardeo" %}
5354

5455
While we're using the **MCP Client Application** template here for optimized MCP settings, you can also use other application types (Single Page App, Traditional Web App, Mobile App, or M2M App) to access MCP servers, except Digital Wallet applications.
56+
{% endif %}
5557

5658
Make a note of the **client-id** from the **Protocol** tab of the registered application. You will need it during the [Build an AI Agent](#build-an-ai-agent) section of this guide.
5759

en/includes/quick-starts/agent-auth-ts.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,8 +51,10 @@ To allow your agent (or user acting through the agent) to authenticate and conne
5151
!!! Info
5252
The **authorized redirect URL** defines the location Asgardeo sends users to after a successful login, typically the address of the client application that connects to the MCP server.
5353
In this guide, the AI agent behaves as the client, which consists of a lightweight OAuth 2.1 callback server running at `http://localhost:3001/callback` to capture the authorization code. So, we will use this URL as the authorized redirect for this guide.
54+
{% if is_version == "next" or product_name == "Asgardeo" %}
5455

5556
While we're using the **MCP Client Application** template here for optimized MCP settings, you can also use other application types (Single Page App, Traditional Web App, Mobile App, or M2M App) to access MCP servers, except Digital Wallet applications.
57+
{% endif %}
5658

5759
Make a note of the **Client ID** from the **Protocol** tab of the registered application. You will need it during the [Build an AI Agent](#build-an-ai-agent) section of this guide.
5860

en/includes/quick-starts/mcp-auth-server-py.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,8 +27,10 @@ To enable clients to sign in and safely connect to the MCP server, an applicatio
2727
!!! Info
2828
The authorized redirect URL defines the location Asgardeo sends users to after a successful login, typically the address of the client application that connects to the MCP server.
2929
For this guide, we will use ["MCP Inspector"](https://modelcontextprotocol.io/docs/tools/inspector) to test the MCP server, so we will use `http://localhost:6274/oauth/callback`, as the authorized redirect URL.
30+
{% if is_version == "next" or product_name == "Asgardeo" %}
3031

3132
While we're using the **MCP Client Application** template here for optimized MCP settings, you can also use other application types (Single Page App, Traditional Web App, Mobile App, or M2M App) to access MCP servers, except Digital Wallet applications.
33+
{% endif %}
3234

3335
Make a note of the **client-id** from the **Protocol** tab of the registered application. You will need it during the [Test the MCP server with authentication](#test-the-mcp-server-with-authentication) section of this guide.
3436

en/includes/quick-starts/mcp-auth-server.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -323,8 +323,10 @@ To register MCP Inspector as a MCP client in {{product_name}}:
323323
!!! Info
324324
The authorized redirect URL determines where users are sent after sign-in, typically where the client app connecting to the MCP server is running.
325325
For this guide, we'll use ["MCP Inspector"](https://modelcontextprotocol.io/docs/tools/inspector) to test the MCP server, so we'll use `http://localhost:6274/oauth/callback/debug`, as the authorized redirect URL.
326+
{% if is_version == "next" or product_name == "Asgardeo" %}
326327

327328
While we're using the **MCP Client Application** template here for optimized MCP settings, you can also use other application types (Single Page App, Traditional Web App, Mobile App, or M2M App) to access MCP servers, except Digital Wallet applications.
329+
{% endif %}
328330

329331
Make a note of the **client-id** from the **Protocol** tab of the registered application. You will need it during next step.
330332

0 commit comments

Comments
 (0)