NewEdit your site from ChatGPT or Claude. Same rules as the built-in assistant.See how

← All guides

AI CMS

Headless CMS With AI Editing: Options Compared

How AI editing works in a headless CMS: assistants, agents and MCP servers in Sanity, Contentful, Strapi and Storyblok, and what to check before AI writes.

November 5, 20269 min readBy CMS Chat Team

A headless CMS with AI editing lets a language model read and change the structured entries in your content store, instead of a person filling in every field. In practice that happens in three ways: an assistant inside the editor, an agent that proposes changes for someone to approve, or an MCP server that lets an outside assistant such as Claude or ChatGPT work on the content.

The big vendors now offer at least one of these, and the differences that matter are less about the AI than about the limits around it: what it can write, whether it can publish, and what happens when it gets something wrong. Sometimes the better answer is not a headless CMS at all, and that case is covered below too.

Why Structured Content Suits AI Editing

A headless CMS keeps content in typed fields, separate from the code that displays it. A product entry has a name, a price and a description, and each field has rules. That structure gives an AI something firm to work with. It can see that a field is a price and not a heading, and a request like "add a German translation to every product description" has a clear target.

Sanity describes this directly: its Agent Actions documentation says the actions "know about your content model". The same structure is also the limit. The AI can only reach what has been modelled, so anything still hard-coded in a component stays out of its reach.

Three Ways AI Reaches Your Content

An assistant inside the editor

This is the most common form. The dashboard stays the same, and AI helps fill in fields.

  • Sanity: AI Assist adds a document-aware assistant to Sanity Studio, where editors write reusable instructions in plain language. The docs list it for projects on the Growth plan and up.
  • Strapi: Strapi AI helps content managers design content structures, translate content and generate image metadata from the admin panel. It is a paid feature that uses AI credits.
  • Storyblok: the AI Suite lists translations, SEO help, alt text and brand voice settings for editors.

An assistant fits best when your editors already work in the dashboard and mainly want to go faster on drafting, translating and metadata.

An agent that proposes changes

An agent works across many entries from one instruction. Sanity Content Agent is the clearest example: a conversational assistant for searching, auditing and updating content across a project. Its documentation states that it "never makes changes without your approval". Proposed edits wait in a Changes tab, and confirming them creates drafts or adds them to a content release. It will not publish, and it cannot delete documents.

This suits jobs that are tedious by hand: find every page that mentions an old product name, then fix them all. The review step is what makes that safe, so check that it exists before trusting any bulk tool.

An MCP server for outside assistants

MCP is "an open-source standard for connecting AI applications to external systems". A CMS that offers an MCP server lets you stay in Claude, ChatGPT, Cursor or another client and ask it to work on your content there. All four vendors in this guide document one: Sanity, Contentful, Strapi and Storyblok.

This is the most flexible of the three and needs the most care. The assistant is no longer inside a screen built for editors. It calls tools, and those tools can include publishing and deleting. We explain the protocol in more depth in editing a website from Claude or ChatGPT.

Where Each Vendor Draws the Line

These notes come from each vendor's documentation at the time of writing. The products are changing quickly, so check the linked pages before you decide.

  • Sanity MCP server: edits made with its patch tool are saved to a draft or release, "never directly to published content". A separate publish tool exists, and the docs note that custom validation rules are currently skipped when run through MCP. If you rely on those rules, that matters.
  • Contentful MCP server: on the hosted server, an admin picks tool categories and sets each one to read-only or read/write. The local open-source server has no such gating: its docs say to treat the access token as the security boundary. Contentful recommends turning on human confirmation of tool calls in your client and starting with read-only access.
  • Strapi MCP server: AI clients can create, update, delete, publish and unpublish through the Content Manager, limited by the permissions of the Admin token. The docs are blunt that deletions are permanent, with "no trash and no undo".
  • Storyblok MCP server: it exposes the Management API, keeps reads, writes and deletes in separate tools, and requires explicit user confirmation before destructive calls. Its docs say results are non-deterministic and point to the CLI for repeatable, large-scale work.

Defaults vary, so the person connecting the AI is making real security decisions.

What to Check Before You Allow AI Writes

Whichever product you use, work through this list before an AI gets write access:

  1. Start read-only. Let the assistant search and report first. Add write access once you know how it behaves on your content.
  2. Scope the credentials. Give it the fewest spaces, content types and permissions the job needs, using a token made for that purpose, not a personal admin login.
  3. Keep publishing as a separate step. Prefer a setup where AI writes drafts and a person publishes.
  4. Check deletion. Find out whether delete tools are available, whether they ask first, and whether anything can be restored. Turn them off if you do not need them.
  5. Confirm that validation runs. Required fields and custom rules protect your content. Check that they apply on the AI path too.
  6. Try it somewhere safe. Use a test environment or dataset for the first runs, especially for bulk changes.
  7. Read the plan before it runs. Ask the assistant to list what it will change. Approve that list, not a vague summary.
  8. Know how usage is billed. Sanity and Strapi both describe AI credits for some features. Sanity's Content Agent docs note that a single message can trigger several tool executions.
  9. Protect search-critical fields. A rewritten page title or meta description can change how a page performs in search. Our guide to SEO-safe edits covers what to look at first.

When a Headless CMS With AI Is the Right Choice

If your content already lives in a headless CMS, use that CMS's AI features. You keep the content model, the workflow and the roles you already have, and moving content elsewhere just to get a chat box rarely pays off.

It is also a strong choice when you are starting fresh and the content justifies the structure: many editors working in parallel, large libraries of similar entries, content reused across a website and an app, or scheduled publishing across several languages.

When It Is the Wrong Starting Point

The harder case is a finished site where the text lives in the code: a Next.js or Astro project, a Hugo site, plain HTML, or something exported from an AI builder. Every approach above works on entries inside the CMS, so none of them can touch that text yet.

To use them, someone first has to model the content, wire each component to the API and move the copy across. We walk through that work in CMS Chat vs headless CMS. For a site with an editorial team, it can be money well spent. For a site whose owner changes a phone number or a price a few times a year, it is a large project to support small edits.

Those sites have lighter options. A Git-based editor such as Decap or TinaCMS works on content files in the repository, and our guide to letting clients edit a Next.js site without a CMS compares that route with others. You can also apply AI to the repository itself, which is the second main type described in what an AI CMS is.

Where CMS Chat Fits

CMS Chat takes that second route. It is not a headless CMS, and it is not a plugin for one: it does not connect to Sanity, Contentful, Strapi or Storyblok. You install its GitHub App on the repository you choose, it detects the framework, and it scans the repo to map editable zones in TSX, MDX, Markdown, HTML and JSON files. There is no content migration, and the Git repository stays the source of truth.

Each zone has a guardrail: editable, warn, escalate or locked. Editors describe a change in plain language, the AI finds the file and makes the edit, and routine edits are committed. Page titles, meta descriptions, H1s and H2s ask first. Layout changes and riskier code edits are not guessed at: they go to the developer as a pull request. Agencies get client portals and an activity history, and each change can be reverted. See how it works for the full flow.

The same guardrails apply from outside assistants. Through the CMS Chat MCP server, ChatGPT, Claude, Claude Code or Cursor can edit the same sites, and connecting an assistant shows what it can and cannot change. If you need structured content across many channels, a headless CMS remains the better fit.

Frequently Asked Questions

Which headless CMS has the best AI editing?

It depends on what you want AI to do. For approved bulk changes, look at an agent with a review step, such as Sanity Content Agent. To work from your own assistant, compare the MCP servers and their permission controls. If your team already uses a CMS, start with what it offers.

Can an AI publish directly to a headless CMS?

Yes, in some setups. The Sanity, Contentful and Strapi MCP servers all list publish tools, so it depends on the permissions you grant. If you want a person to publish, withhold that permission or restrict the assistant to drafts.

Can I add AI editing to a site that has no CMS?

Not with a headless CMS's own tools, because they only reach content stored in that CMS. If the site's code is in a Git repository, a chat-based editor can work on the files directly. For a broader look at the options, see how to edit your website without a developer.

Change your site by asking.

Sign up, connect your site and ask for your first change in plain words.

month to monthrevert any changebigger work stays with your agency

Prefer to see it first? Ask for a walkthrough