Add a remote MCP provider

Model Context Protocol (MCP) is an open standard that lets AI applications connect to external tools and data sources. Connect Opal to a remote MCP server to extend it with tools and data from an external system. Optimizely Opal administrators add and manage remote MCP servers on the External Providers tab.

After an administrator registers a remote MCP provider and adds the tools, a tile becomes available on the Connectors tab. Opal users and agent builders use the tile to authenticate with the MCP provider. They can then call Opal tools that use the remote MCP server.

Prerequisites

To add a remote MCP provider to Opal, you must have the following:

• The Opal administrator role.
• The MCP server URL.
• Either a bearer token or the OAuth credentials the MCP server requires.

Register a remote MCP provider

Registering the provider is the first step in connecting Opal to an MCP server. To register a remote MCP provider, complete the following steps:

1. Go to Tools > External Providers.

2. Click Add Remote MCP Provider.

   

3. Enter the MCP Server URL.

   

4. Select Bearer Token or Discover OAuth Endpoints as your authentication method.
5. Go to the corresponding section to complete authentication.
   • Authenticate with a bearer token
   • Authenticate with OAuth

Authenticate with a bearer token

If you select bearer token, complete the following steps:

1. Enter your bearer token.
2. Click Next.

Bearer token authentication does not use scopes, so there is no scope bundle to approve. Continue to the Add the tools section to grant access to specific tools from your MCP provider.

Authenticate with OAuth

If you select Discover OAuth Endpoints, complete the following steps:

1. Review the Found OAuth endpoints and Scopes.

   

2. Click Next.
3. Enter a Provider Name. The provider name must be globally unique.
4. (Optional) Enter a Description.
5. Review the OAuth Credentials. The remote MCP server determines which fields are populated and which are required.
6. Enter any required fields.
7. Click Register. Opal displays a confirmation message.

8. Click Close.

   

Approve the scope bundles

A scope bundle is a named, reviewable set of OAuth permissions. Administrators approve it once, and users consent to it when they connect a tool.

1. Go to Tools > External Providers.
2. Expand the external provider added in the Register a remote MCP provider section.

3. (Optional) Click More > Edit.

   

   1. (Optional) Enter a Display Name for the provider. The display name does not need to be globally unique.
   2. (Optional) Paste the Scalable Vector Graphics (SVG) representation of the Icon.

   3. Click Save Changes.

      

4. Click More > Approve. This lets Opal users and agent builders connect and log in to the remote MCP server.

   

Add the tools

After you Register a remote MCP provider, you choose which of the provider's tools to make available to Opal users. To do so, complete the following steps:

1. Go to Tools > Connectors.

2. Click Connect for the provider you added in the Register a remote MCP provider section.

   

3. Log in to the remote MCP server.
4. Grant Opal the access it requests.
5. Click Continue.
6. (Optional) Deselect any tools you do not want to add to Opal.
7. (Optional) Update the Display Name for the tools.

8. Click Finish.

   

The tools are now available in your Opal instance.

To use the tools, Opal users and agent builders go to Tools > Connectors and click Connect. They log in to the MCP server with their own credentials.

Enable the tools in Opal Chat (Optional)

If you want the tools available in Opal Chat, enable them.

1. Go to Tools > Tools.
2. (Optional) Select Remote MCP from the Tool Type filter drop-down list.

3. Toggle Enable for Chat on.

   

Opal can now reference the tools in Opal Chat.