Skip to main content

​
Overview

Once Contentful is connected, the Dema Agent can work with your content directly inside a conversation. It can find entries missing key fields before a launch, bulk-update entries (pricing, seasonal copy), create and publish new entries, upload and publish assets, audit the content model — content types, tags, and locales — for localization gaps, and invoke reusable AI Actions to localize or refresh content. The agent only acts when you ask it to, and Dema asks you to confirm sensitive changes before they are applied.
Installing the MCP app in Contentful and connecting in Dema are both required. The MCP app gates which tools work in each space and environment, so a connection in Dema only reaches the spaces and environments where the app is installed and authorized.

​
Prerequisites

  • A Contentful account with permission to install Marketplace apps in the target space.
  • The Contentful MCP app installed and configured per space and per environment (see below).
  • Your data region — Global/US or EU — which determines the MCP URL.

​
Connect Contentful

1

Install and configure the Contentful MCP app (per space + environment)

  1. Log in to the Contentful web app (use be.eu.contentful.com if your org is EU-resident, otherwise be.contentful.com).
  2. In the top navigation open Apps then Marketplace.
  3. Find the Contentful MCP app and click Install.
  4. Select the target space and environment and click Authorize access.
  5. Choose which tool categories are enabled and set each to read-only or read/write (start read-only). Save.
  6. Repeat for every space + environment the agent needs.
Start with everything read-only and enable write only on the spaces and environments where you actually want the agent to make changes.
2

Connect in Dema

In Dema, go to Agents → Settings → Integrations, find Contentful, and click Connect. Enter:
  • MCP URL — your region’s URL: Global/US https://mcp.contentful.com/mcp or EU https://mcp.eu.contentful.com/mcp.
Click Add. Complete the one-click OAuth sign-in and select the space/environment pair(s) in Contentful’s configuration UI. Dema marks the integration as Active.
Reference the environment ID, not an alias. Environment aliases are not supported and cause a Forbidden error.

​
Troubleshooting

You must select the space/environment in Contentful’s configuration UI on each connection, and the MCP app must also be installed in that space + environment. Confirm both, then reconnect.
Reference the environment ID directly — environment aliases are not supported. Replace the alias with the actual environment ID and reconnect.
If your org is EU-resident, use https://mcp.eu.contentful.com/mcp and sign in via be.eu.contentful.com.
If you are still stuck, contact support with the error message you see.

​
Additional resources