Contentful remote MCP connector

  • Updated

The Contentful remote Model Context Protocol (MCP) connector in Optimizely Opal helps you manage, query, and automate your content ecosystem. From creating content entries to running AI-driven workflows, these tools provide a direct connection to your Contentful spaces and let you manage assets, localized tags, and environment configurations.

The Contentful remote MCP is managed by Contentful. For details, see Model Context Protocol (MCP) server in the Contentful documentation.

First, an Opal administrator must connect the Contentful remote MCP to Opal. After connecting the MCP server, individual Opal users and agent builders can log in to Contentful to access their information from Opal. Administrators only need to connect the Contentful remote MCP once.

Connect the Contentful remote MCP to Opal

The first person to connect a third-party service to Opal should be an administrator of that service. Administrator access installs the complete set of tools, so Opal adds every available tool. If a non-administrator connects the service first, Opal installs only the tools that account can access.

Opal administrators connect and grant access to Contentful from Opal. After granting access, administrators select which tools to enable in Opal and optionally customize their display names.

Add Contentful connection

As an Opal administrator, complete the following steps:

  1. Go to Connectors in Opal.
  2. (Optional) Enter Contentful in the search bar to filter the connectors list.

  3. Click Connect on the Contentful tile. 

  4. Log in to your Contentful account. 

  5. Configure the connector.
  6. Click Accept.

A confirmation message displays and you can close the pop-up window.

Configure Opal tools

After adding the Contentful connection, Opal prompts you to select which tools to enable and optionally customize their display names.

As an Opal administrator, complete the following steps:

  1. Deselect any tools you do not want to add to Opal.
  2. (Optional) Update any tool's display name.

  3. Click Finish. 

The Contentful tile displays Connect on the Connectors tab for Opal users to authenticate with their personal accounts.

To update the available tools or names, see Update tools.

Authenticate with Contentful

Each Opal user and agent builder logs in to Contentful individually to access their Contentful data from Opal. User-level authentication ensures you access only the data your Contentful account is authorized to view.

Before you begin, confirm that an Opal administrator has connected the Contentful remote MCP to Opal. Until an administrator connects it, the Contentful tile displays Contact admin instead of Connect and you cannot select it.

To authenticate, complete the following steps in Opal:

  1. Go to Connectors.
  2. (Optional) Enter Contentful in the search bar to filter the connectors list.
  3. Click Connect on the Contentful tile.
  4. Log in to Contentful.

After you connect to Contentful, the Contentful connector tools your administrator added become available in Opal Chat, agents, and workflows.

Contentful connector tools

The Contentful connector tools are available in Opal after an administrator connects the Contentful remote MCP to Opal and you log in to Contentful. The available tools depend on which tools your administrator enabled. For a full list of available tools and actions, see Model Context Protocol (MCP) server in the Contentful documentation.

Update tools

To rename, add, or remove tools, an Opal administrator must delete the Contentful tools registry and re-add it. To do so, complete the following steps:

  1. Follow the steps in Delete a tool registry.
  2. Add Contentful connection.
  3. Configure Opal tools.

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.