> ## Documentation Index
> Fetch the complete documentation index at: https://help.semji.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contentful integration: connect your space to publish from Semji

> Connect your Contentful space to Semji in one click. You connect to Contentful, approve the access, and you're done.

## At a glance

* **What you can do**: give Semji's agents read and update access to your Contentful content.
* **Who it's for**: workspace owners with a Contentful account.
* **Compatibility**: all Contentful versions.

The connection runs through Contentful's official hosted MCP server ([https://mcp.contentful.com/mcp](https://mcp.contentful.com/mcp)), over OAuth. With OAuth, you authorize Semji directly from Contentful, without ever copying or pasting a key.

To learn more about this server, see the Contentful MCP server documentation: [https://www.contentful.com/developers/docs/tools/mcp-server/](https://www.contentful.com/developers/docs/tools/mcp-server/)

## Prerequisites

* A Contentful account with access to the space you want Semji to work in.
* You are a workspace owner in Semji. The connection is shared with the whole workspace.
* A browser that allows popups from Semji. The Contentful sign-in screen opens in a new tab.

<Note>
  Availability of the Contentful integration depends on your Semji plan. If the Connect button opens an upgrade dialog instead, contact your account manager.
</Note>

## How to connect Contentful

You must be a workspace owner, since the connection applies to the whole team.

<Steps>
  <Step title="Open the CMS integrations">
    In Semji, open Settings → Integrations, go to the CMS tab, and click Connect on the Contentful row.

    <video autoPlay muted loop playsInline src="https://mintcdn.com/semji/ZF6m599EYafA5y4i/images/help-center/connect-your-tools/cms-publisher/01-cms-integration.mp4?fit=max&auto=format&n=ZF6m599EYafA5y4i&q=85&s=901ef6b3c1b91a4cb6762427eaaade8c" title="CMS Integration" data-path="images/help-center/connect-your-tools/cms-publisher/01-cms-integration.mp4" />
  </Step>

  <Step title="Start the connection">
    Click Connect Contentful. A new tab opens on Contentful's sign-in and authorization screen.

    <img src="https://mintcdn.com/semji/ql0fCIIUu6X2284g/images/help-center/connect-your-tools/integration-contentful/01-connect-contentful.jpg?fit=max&auto=format&n=ql0fCIIUu6X2284g&q=85&s=f64f0b93745b5354123f05b62ca1e2db" alt="connect contentful" width="670" height="389" data-path="images/help-center/connect-your-tools/integration-contentful/01-connect-contentful.jpg" />
  </Step>

  <Step title="Sign in and approve">
    Sign in with your Contentful account and approve the requested access. Do it within 10 minutes: after that, the attempt expires and you have to start over.

    <Tip>
      nothing to copy or configure on the Contentful side. All the authorization happens on this screen.
    </Tip>
  </Step>

  <Step title="Done">
    The tab closes and you land back in Semji, where the Contentful row now shows as connected for the whole workspace.
  </Step>
</Steps>

## What Semji can do once connected

The available actions come from Contentful's MCP server, typically reading and updating entries. Agents discover these actions as they use them.

<Info>
  Semji's publishing agents never delete content, even if the server offers a delete action.
</Info>

## Manage or disconnect

From Settings → Integrations → CMS, the Contentful row offers Disconnect, which removes the access for the whole workspace. To switch Contentful accounts, disconnect, then reconnect with the other account.

## Network

The connection runs only between Semji and Contentful's cloud. Semji never calls your own infrastructure, so there's nothing to allow on your side for Contentful.

## Troubleshooting

<AccordionGroup>
  <Accordion title="The popup was blocked by your browser. Allow popups to connect to the MCP server.">
    Your browser prevented the Contentful tab from opening. Allow popups for the Semji domain, then click Connect Contentful again.
  </Accordion>

  <Accordion title="The authorization tab closed but nothing changed">
    Start the connection again, and complete the authorization within 10 minutes of clicking Connect Contentful. The attempt works only once and expires after that.
  </Accordion>

  <Accordion title="Failed to connect to the CMS connector.">
    The connection didn't go through. You may have denied the access, or the attempt expired. Click Connect Contentful and try again.
  </Accordion>

  <Accordion title="The connection shows as Expired">
    Contentful no longer accepts the stored access, and agents skip Contentful in the meantime. A workspace owner must reopen the integration and reconnect.
  </Accordion>

  <Accordion title="Agents say they have no Contentful tools">
    The connection was removed or expired. A workspace owner must reconnect Contentful under Settings → Integrations → CMS.
  </Accordion>
</AccordionGroup>

## Related

* [CMS Publisher: publish your content to your CMS without leaving Semji](/en/connect-your-tools/cms-publisher)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.