---
title: Add a remote MCP provider
slug: agent-platform/docs/add-a-remote-mcp-provider
docTags: 
createdAt: 2026-08-25T21:56:21.000Z
---

Model Context Protocol (MCP) is an open standard that lets AI applications connect to external tools and data sources. Connect Agent Platform to a remote MCP server to extend it with tools and data from an external system. [Mark administrators](docId\:pe0pbUJveWrG8ewvZWDRE) 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. [Mark users](docId\:L0Ntt9JQmG6fQIJK_Y7C7) and [agent builders](docId\:HOJ_6dibwNf8Qz7WMIDie) use the tile to authenticate with the MCP provider. They can then call [Mark tools](docId:-j4zNs-l3kIKD0n58bVPt) that use the remote MCP server.

## Prerequisites

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

- The Mark 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 Mark to an MCP server. To register a remote MCP provider, complete the following steps:

1. Go to **Connectors > External Providers**.
2. Click **Add Remote MCP Provider**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/V7V2nls91KzGew2X2kGnw_add-remote-mcp-server.png" size="100" isUploading="false" position="center" width="2350" height="828" darkWidth="2350" darkHeight="828" showCaption="false" indent="1"}

3. Enter the **MCP Server URL**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/cTZTXYn4XoK5zR-Pi5Y6R_enter-mcp-server-url.png" size="100" isUploading="false" position="center" width="1840" height="544" darkWidth="1840" darkHeight="544" showCaption="false" indent="1"}

4. Select **Bearer Token** or **Discover OAuth Endpoints** as your authentication method.
5. Go to the corresponding section to complete authentication.
   - [Authenticate with bearer token](docId:7N-ZjI4ey2sTP9jl_pTvg)
   - [Authenticate with OAuth](docId:7N-ZjI4ey2sTP9jl_pTvg)

### 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](docId:7N-ZjI4ey2sTP9jl_pTvg) 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**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/htv_5h4ck256huTuo5zu4_found-oauth-endpoints.png" size="100" isUploading="false" position="center" width="1724" height="744" darkWidth="1724" darkHeight="744" showCaption="false" indent="1"}

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**. Mark displays a confirmation message.
8. Click **Close**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/GNOMpJizzftp5bhY09ySZ_mcp-provider-added.png" size="100" isUploading="false" position="center" width="1018" height="334" darkWidth="1018" darkHeight="334" showCaption="false" indent="1"}

### 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 **Connectors > External Providers**.
2. Expand the external provider added in the [Register a remote MCP provider](docId:7N-ZjI4ey2sTP9jl_pTvg) section.
3. (Optional) Click **More > Edit**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/qIxW2qTtQ8mPJKzL_Jw4D_edit-scope-bundles.png" size="100" isUploading="false" position="center" width="2512" height="874" darkWidth="2512" darkHeight="874" showCaption="false" indent="1"}

4. (Optional) Enter a **Display Name** for the provider. The display name does not need to be globally unique.
5. (Optional) Paste the Scalable Vector Graphics (SVG) representation of the **Icon**.
6. Click **Save Changes**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/HjXlYQoYBVRNXqHfDaLY3_save-scope-bundles.png" size="90" isUploading="false" position="center" width="1078" height="936" darkWidth="1078" darkHeight="936" showCaption="false" indent="1"}

7. Click **More > Approve**. This lets Mark users and agent builders connect and log in to the remote MCP server.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/BOKQCFyrur1aF9MNa3LUl_approve-scope-bundles.png" size="100" isUploading="false" position="center" width="2512" height="882" darkWidth="2512" darkHeight="882" showCaption="false" indent="1"}

## Add the tools

After you [Register a remote MCP provider](docId:7N-ZjI4ey2sTP9jl_pTvg), you choose which of the provider's tools to make available to Mark users. To do so, complete the following steps:

1. Go to **Connectors > Connectors**.
2. Click **Connect** for the provider you added in the[Register a remote MCP provider](docId:7N-ZjI4ey2sTP9jl_pTvg) section.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/wQbrHDQr53XQt9EzOQHiB_connect-tools.png" size="100" isUploading="false" position="center" width="1376" height="768" darkWidth="1376" darkHeight="768" showCaption="false" indent="1"}

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

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/7J80H5rWJJC0QbJ5N2lMR_edit-tool-name.png" size="100" isUploading="false" position="center" width="1898" height="1002" darkWidth="1898" darkHeight="1002" showCaption="false" indent="1"}

The tools are now available in your Mark instance.

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

### Enable the tools in Mark chat (Optional)

If you want the tools available in [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM), enable them.

1. Go to **Connectors > Tools**.
2. (Optional) Select **Remote MCP** from the **Tool Type** filter drop-down list.
3. Toggle **Enable for Chat** on.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ojm_EsyuPpl857y8ovTZv_enable-tools-in-chat.png" size="100" isUploading="false" position="center" width="2502" height="1096" darkWidth="2502" darkHeight="1096" showCaption="false" indent="1"}

Mark can now reference the tools in Mark chat.

:::hint{type="info"}
**Note**

If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See [Turn generative AI off across Optimizely applications](docId\:X5U0kKD2azV5cIdNqwGNj).
:::
