Skip to main content

​
The connector will not connect

“Missing connection token” or 401. The URL was pasted without its ?token=… part, or the connection was revoked. Create a new one; the URL is shown once. Local site. claude.ai, the Claude desktop connector and ChatGPT fetch from their cloud and cannot reach .local, localhost or a private IP. Use Claude Code or an IDE client, or put the site on a public https address. The screen says when it detects a local site. A caching plugin in front of the REST API. The endpoint is a POST; make sure your cache does not serve stale responses for wp-json/bevel-mcp/.

​
The assistant says it must read the rules first

That is by design: create_page and create_template refuse until the conversation has read get_build_guide "rules". It reads them and continues. If it happens mid-conversation, the client is not echoing the session id and the connection-level gate expired; the read costs one call.

​
The header shows the wrong menu

Make sure Bevel Kit is up to date. The Kit registers the primary_menu location on every theme and the MCP assigns the header’s menu to it; an older Kit left the location unregistered on some themes and the widget fell back to the first menu it found. The connection that minted it was revoked, or the Media (or Design System, for fonts) capability was switched off. Mint a new link from a live connection.

​
”Inline base64 is limited to 100 KB”

The assistant tried to type a file into the conversation. That is refused on purpose; the message tells it to mint an upload link. See Uploads.

​
A page was saved as draft though I asked to publish

Image slots still showed the grey placeholder image. The response lists them. Put real photos in, or pass allow_placeholders:true.

​
Changes do not show on the site

Every content change purges the caches automatically. If a change still does not show, the Elementor CSS may be cached by a plugin the purge does not know; the clear_cache tool hard-clears everything, and so does the Clear Cache button in the admin bar.

​
A font family I named was ignored

update_design_system accepts Google Fonts families and the site’s own Custom Fonts. Anything else is ignored and reported, because Elementor would write it into the CSS and the browser would silently fall back. Install the family with upload_font first, or drop the files into Brand assets.

​
Where to look

Bevel → MCP Connectors → Activity lists the last calls with their result, and the Session timeline shows where the minutes and bytes of a build went: the assistant’s thinking time, the server’s time, what it typed and what it read. Copy a session as JSON and paste it into a chat to analyse a slow build.