Add an MCP server with OAuth 2.1
Add an MCP server with OAuth 2.1 in the AI Agent Studio.
Before you begin
Role required: sn_mcp_client.admin
About this task
OAuth is the standard method to authenticate MCP servers. If your MCP server supports it, choose OAuth 2.1 as the authentication method.
Procedure
-
Navigate to All > AI Agent Studio > Settings > Manage Model Contextual Protocol (MCP) Servers.
-
Select View against MCP Servers.
-
On the Model Context Protocol Server page, select New.
-
On the Add MCP Server Console form, enter a name and the web address for your MCP server.
-
In the Authentication Type field, select OAUTH 2.1.
[Omitted image "add-mcp-server-new.png"] Alt text: Screenshot that shows the Add MCP Server form and its fields.
-
Select Next.
The form extends with the registration details.
-
On the form, fill in the fields.
Note:
- If your MCP server doesn’t support dynamic client registration, register the OAuth client for AI agents manually. Update the client details in AI Agent Studio.
- The manual registration doesn’t auto-populate the field data and must be manually provided. [Omitted image "add-mcp-server-oauth-manual.png"] Alt text: Manual client registration for an OAuth MCP Server.
|
Field |
Description |
|---|---|
|
Grant Type |
How you want to obtain an access token when accessing protected resources.The following options are available:
|
|
Token Authentication Method |
Method using which the client credentials are sent when requesting tokens from the Authorization server.You can one of the two options:
|
|
Client ID |
Unique ID for authentication and authorization purposes. |
|
Client Secret |
Unique credentials used for authentication. |
|
Auth Scopes |
Specific permissions for an application.Note: The Auth scopes must be comma-separated values. |
|
Authorization URL |
Web address of your server to direct authorization. |
|
Token URL |
Web address containing the token. |
|
Token Revocation URL |
Web address to revoke the previously provided token. |
You're redirected to the Model Context Protocol Server Console record to authenticate the MCP server for adding an MCP tool to an AI agent.
**Note:** On the Model Context Protocol Server Console record, you will see a warning that server requires authentication.
-
Select Save and continue to complete filling the Server details, Access rules, and Tools.
-
Verify the Server details.
The Server name, Connection Alias, and Application fields are auto-populated with the information from previous steps. Additionally, you can provide a description for the server.
-
Define Security controls for the MCP Servers.
For more information, see Define security controls for MCP Servers.
-
Define the Tools for the Model Context Protocol Sever.
You can configure the MCP tools in the Assistant Designer. For more information see .
-
Select Authenticate to request a new token.
-
In the third-party authorization page, select Authorize.
Note: When OAuth access or refresh tokens aren’t available, you must authenticate the OAuth configuration on the MCP server record to add it as an AI agent tool.
---
title: Add an MCP server with OAuth 2.1
description: Add an MCP server with OAuth 2.1 in the AI Agent Studio.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/intelligent-experiences/add-mcp-server-aoauth-2.1.html
release: brazil
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 2
breadcrumb: [Adding an MCP Server Console in AI Agent Studio, MCP Client, AI Agent Studio, AI agents and agentic workflows, Enable AI Experiences]
---
# Add an MCP server with OAuth 2.1
Add an MCP server with OAuth 2.1 in the AI Agent Studio.
## Before you begin
Role required: sn\_mcp\_client.admin
## About this task
OAuth is the standard method to authenticate MCP servers. If your MCP server supports it, choose OAuth 2.1 as the authentication method.
## Procedure
1. Navigate to **All** > **AI Agent Studio** > **Settings** > **Manage Model Contextual Protocol \(MCP\) Servers**.
2. Select **View** against **MCP Servers**.
3. On the Model Context Protocol Server page, select **New**.
4. On the Add MCP Server Console form, enter a name and the web address for your MCP server.
5. In the **Authentication Type** field, select **OAUTH 2.1**.
\[Omitted image "add-mcp-server-new.png"\] Alt text: Screenshot that shows the Add MCP Server form and its fields.
6. Select **Next**.
The form extends with the registration details.
7. On the form, fill in the fields.
**Note:**
- If your MCP server doesn’t support dynamic client registration, register the OAuth client for AI agents manually. Update the client details in AI Agent Studio.
- The manual registration doesn’t auto-populate the field data and must be manually provided.
\[Omitted image "add-mcp-server-oauth-manual.png"\] Alt text: Manual client registration for an OAuth MCP Server.
<table id="table_yds_tsh_xfc"><thead><tr><th>
Field
</th><th>
Description
</th></tr></thead><tbody><tr><td>
Grant Type
</td><td>
How you want to obtain an access token when accessing protected resources.The following options are available:
- **Authorization Code**: A system-generated code used for granting access to an application or resource.
- **Client Credentials**: An access token provided by the administrator to access the application directly.
</td></tr><tr><td>
Token Authentication Method
</td><td>
Method using which the client credentials are sent when requesting tokens from the Authorization server.You can one of the two options:
- **Client Secret Basic**
- **Client Secret Post**
</td></tr><tr><td>
Client ID
</td><td>
Unique ID for authentication and authorization purposes.
</td></tr><tr><td>
Client Secret
</td><td>
Unique credentials used for authentication.
</td></tr><tr><td>
Auth Scopes
</td><td>
Specific permissions for an application.**Note:** The Auth scopes must be comma-separated values.
</td></tr><tr><td>
Authorization URL
</td><td>
Web address of your server to direct authorization.
</td></tr><tr><td>
Token URL
</td><td>
Web address containing the token.
</td></tr><tr><td>
Token Revocation URL
</td><td>
Web address to revoke the previously provided token.
</td></tr></tbody>
</table>8. Select **Add**.
You're redirected to the Model Context Protocol Server Console record to authenticate the MCP server for adding an MCP tool to an AI agent.
**Note:** On the Model Context Protocol Server Console record, you will see a warning that server requires authentication.
9. Select **Save** and continue to complete filling the Server details, Access rules, and Tools.
10. Verify the Server details.
The Server name, Connection Alias, and Application fields are auto-populated with the information from previous steps. Additionally, you can provide a description for the server.
11. Define Security controls for the MCP Servers.
For more information, see [Define security controls for MCP Servers](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/intelligent-experiences/define-sec-mcp.md).
12. Define the Tools for the Model Context Protocol Sever.
You can configure the MCP tools in the Assistant Designer. For more information see .
13. Select **Authenticate** to request a new token.
14. In the third-party authorization page, select **Authorize**.
**Note:** When OAuth access or refresh tokens aren’t available, you must authenticate the OAuth configuration on the MCP server record to add it as an AI agent tool.
| title | Add an MCP server with OAuth 2.1 |
| description | Add an MCP server with OAuth 2.1 in the AI Agent Studio. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/intelligent-experiences/add-mcp-server-aoauth-2.1.html |
| release | brazil |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 2 |
| breadcrumb | Adding an MCP Server Console in AI Agent StudioMCP ClientAI Agent StudioAI agents and agentic workflowsEnable AI Experiences |