Skip to content
CMS Max Documentation

User

AI Connect (MCP)

Connect AI agents like Claude — and soon GPT and Gemini — directly to your site. Once connected, an agent can create pages, edit theme sections, manage navigation menus, and update your theme configuration — all scoped to your site only, using the industry-standard Model Context Protocol (MCP).

What a connected agent can do

  • Pages, sections, layouts and menus: read, create and edit your site content and navigation.
  • Images: upload photos and logos into your media library and look at them before using them.
  • Products and categories (when the eCommerce plugin is installed): read a product or category, rewrite the product description or the category page content, edit the SEO fields (browser title and meta description), and upload and attach product photos — as the featured image or gallery images. Prices, stock, variants, options and shipping stay in eCommerce → Products in your admin panel; an agent cannot change them.
  • Theme: read and update brand colors, fonts and button styles.

Ask in plain language — for example "rewrite the description of the Crystal Tumbler and give it a better meta description" or "attach these three photos to the Wine Decanter, the first as the main image". The agent reads the item first and changes only what you asked for.

Installing the plugin

  1. In your admin panel, go to Settings → Plugins.
  2. Search for AI (or MCP, Claude, and similar) and find AI Connect (MCP).
  3. Click Install.

The AI Connect (MCP) plugin page before installation

Installing automatically creates a secure connection token for you — there is nothing to configure.

Plugins listing found by searching "claude"

Connecting Claude

The AI Connect (MCP) settings page

The Set up your AI Agent section on the plugin settings page walks you through it (Claude tab):

  1. Copy the Server URL shown under Connection details — that's all Claude needs.
  2. Click Open Claude (or open claude.ai → Settings → Customize → Connectors).
  3. In Claude, choose Add custom connector, give it a name (e.g. CMS Max), paste the server URL, and click Add — no headers or advanced settings needed.
  4. Click Connect. Your browser opens this site's admin login — sign in and click Approve to grant Claude access. Only Admin users can approve a connection; Editor and Viewer users who sign in see a "Forbidden" page and no connection is created.
  5. In any chat, open the + menu and enable the connector. You can now ask Claude to build and edit your site.

No token to paste — that's intentional. Clicking Connect signs you in through this site's admin and asks for your approval, so access is granted securely without copying secrets. The Authorization header shown under Connection details is still there for any other MCP-capable client.

Connecting other agents

Open the plugin settings page and pick your agent under Set up your AI Agent. Guides for GPT and Gemini are coming soon. Every other MCP-capable client (Claude Code, Codex, Gemini CLI, VS Code, and more) connects through the Any MCP client tab, which shows the server URL, the Authorization header, and a ready-to-paste mcp.json example.

Managing connected apps

Open Settings → Plugins → AI Connect (MCP) and find Connected apps. Each entry shows the app, the admin who approved it, and whether bulk destructive actions are Blocked or Allowed. You can manage your own connections; super admins can manage all connections for the site. A connection works only while the admin who approved it has the Admin role.

  1. Find the app and approving admin you want to change.
  2. Click Manage Permissions.
  3. Set Allow Bulk Destructive Actions and confirm the change.

Bulk actions are blocked by default. Enabling permits archiving page subtrees and deleting multiple images, entire menu locations or menu subtrees, and multiple event occurrences in one request. Only enable this for an app you trust with those operations. Archiving a page while preserving its children, single-item actions, and ordinary editing remain available when blocked.

Changes apply on the app's next request without reconnecting. The setting stays in effect when its connection credentials renew. Each app and approving admin has its own permission.

Click Disconnect and confirm to revoke that entry’s access. Other entries stay connected. Reconnecting requires approval and starts with bulk actions blocked.

Managing your token

The Regenerate dialog includes Allow Bulk Destructive Actions, defaulting to off each time. Choose it explicitly for the new token; permission granted through Settings → API is not inherited. This applies to the shared API token, separately from each OAuth connection’s permissions.

  • The token behaves like a password: anyone holding it can manage your site content. Keep it private.
  • Regenerate it anytime from the plugin settings page. The old token stops working immediately, and every connected agent needs the new value. Only Admin users see the token and the Regenerate button. Everyone else sees a note that only admins can view the token, and the setup guides show a YOUR_MCP_TOKEN placeholder.
  • Every agent request is rate-limited, so a runaway agent can't overwhelm your site.
  • The token is managed by the plugin, so it can't be accidentally revoked or deleted from the Settings → API page while the plugin is installed.

The sparkle button

The sparkle icon in the top-left of your admin panel previews the upcoming built-in AI Chat. Until it arrives, the dialog links you straight to this plugin so you can already work on your site with AI through Claude.

The AI Chat coming soon dialog

Deactivating and uninstalling

Deactivating the plugin pauses every agent connected through Connect (the approve-in-browser flow) — reactivating lets them resume without reconnecting. Agents connected with the token keep working while the plugin is deactivated; regenerate the token or uninstall to cut them off. Only Admin users see Deactivate and Activate on this page.

Uninstalling the plugin revokes the connection token and every Connect approval immediately and disconnects all agents. Only Admin users see the Uninstall button on this page. Reinstalling later requires each agent to connect again. Your site content is not affected either way.