Overview: what an assistant can do
Let Claude, Claude Code, Cursor, VS Code or any MCP tool read your site, draft changes, build pages and leave publishing to you.
On this page
An AI assistant (Claude, Claude Code, Cursor, VS Code and others) can work on your Clear site the way a careful colleague would: look at what is there, draft changes, build pages from your site's blocks, tidy the look, and leave publishing to you. It does this through Clear's built-in MCP server. MCP (Model Context Protocol) is the standard way an assistant uses outside tools; Clear speaks it, so no plug-in is needed.
This section is for people who want to connect an assistant, and for the assistant itself: every page here is also served as plain text at /llms.txt and /llms-full.txt, which an assistant can read in one go.
What an assistant can do
Once connected, an assistant can:
- Answer questions about your content: "What events are coming up?", "Which pages mention parking?".
- Draft changes: fix a typo on every page, write a news post, update opening hours in three places at once.
- Build pages on a Clear Blocks site: add a block, change its words or style, move it, take it off.
- Change the look: the theme's colours, font pair, corners and spacing, within the choices the site allows.
- Manage content: make a collection from a ready shape, find records with filters, add photos from the web, rename pages (with a redirect).
- Check its work: make a preview link so you can see the drafts before anything goes live.
- Publish, only when its connection allows it and you clearly ask.
Everything it writes is a draft, exactly like a change you make in the admin. Visitors see nothing until someone publishes. See Safety.
What it cannot do
- Go past its connection. A site key does only what its switches allow; a sign-in connection never does more than your own role on each site.
- Change your team, billing, domains or keys.
- Read form answers unless the key's Form answers switch is on. The keys made by Connect never have it.
- Change a site drawn by its own code beyond what that code reads from records.
Two ways to connect
| One site | All your sites | |
|---|---|---|
| Where | The site admin: Settings → AI assistants | The Console: Account → AI assistants |
| Address | https://<site>.clearcms.app/admin-clear/api/mcp |
https://console.clearcms.app/api/mcp |
| How the assistant gets in | A site key, made for you by Connect | You sign in and press Allow |
| Works today | Yes, in every assistant below | Sign-in is new; from Claude.ai it waits for a fix |
Most people start with one site: press Connect on the assistant's card and follow the one step it shows. The steps for each assistant are in Connect your assistant.
Which assistants work today
| Assistant | With a site key | With sign-in (no key) |
|---|---|---|
| Claude (Claude.ai and the desktop app) | Yes: a custom connector with a request header | Not yet: a fix is in progress |
| Claude Code (terminal) | Yes: one command | Asks you to sign in on the first call |
| Cursor | Yes: one click, Add to Cursor | Asks you to sign in |
| VS Code | Yes: one click, Add to VS Code | Asks you to sign in |
| Any program that speaks MCP or HTTP | Yes: the address and the key | If it supports MCP sign-in (OAuth) |
| ChatGPT | No: its connectors take no key | Not yet |
Until sign-in works from Claude.ai, use a site key there: the Claude card on Settings → AI assistants gives you the address and the header to paste. Nothing you set up now is lost later: the server and the tools stay the same.
How it fits together
- In the site admin, open Settings → AI assistants and press Connect on your assistant's card. Clear makes a key for it and shows the setup once: Connect your assistant.
- The assistant reads the site's guide, looks around, then works in small steps: What the tools do.
- You check the drafts in the admin or through a preview link, then press Publish.
- To stop it, press Revoke next to it under Connected: API keys for assistants.
Next
- Connect your assistant: the exact steps.
- Examples: three realistic jobs, start to finish.