Work with assistants and coding agents#
At the end of this path, you will have an assistant or a coding agent that prepares content on a Plone site, previews its changes, and cannot touch what you protected.
Choose how your model reaches the site#
Where your model runs decides what to set up.
Your model runs |
Use |
Start with |
|---|---|---|
In a terminal or an editor, such as Claude Code, Codex, or Cursor |
The skill and the command line |
|
In Claude Desktop |
The MCP server, over standard input and output |
|
In another chat application |
The MCP server, over standard input and output |
|
On another computer, or shared by a team |
The MCP server, over HTTP |
|
In your own code |
The Python library |
Skill or MCP server#
Skill and command line |
MCP server |
|
|---|---|---|
What it is |
A file that teaches the agent the commands |
A process that offers tools |
Who runs the commands |
The agent, in its shell |
The server |
What the model sees |
The skill, and each command’s output |
The tool list and the server’s instructions |
What limits it |
The profile, and the agent’s own permissions |
The profile, and the tools you offer with |
Pick it when |
The agent already has a terminal |
There is no terminal, or the agent must not run arbitrary commands |
call_service is offered in every mode, read-only included, because it reaches every service the user can use; none of the tool sets this documentation recommends includes it.
About the MCP server, the command line, and the skill explains the difference at length.
You need#
Follow these steps#
Install plone-client adds the
mcpandmarkdownextras, because the server and its Markdown pages need them.Your first agent session gives an agent a site, first through the command line and then through the MCP server.
Protect a site from an agent decides what your model can see and do, before you point it at a real site.
Connect an assistant through the MCP server or Use plone-client with coding agents connects the tool you use.
Build an editorial assistant builds a complete assistant for two sites.
Going further#
MCP server lists every tool and resource.
Agent skill shows what the skill says.
Content model shows what a model must know to write a page.
If something breaks#
Troubleshoot goes from the symptom to the fix.
Before you connect a real site#
Log in as a dedicated Plone user with only the permissions the model needs, not
admin.Add the site first as a read-only profile, with
--read-only.Start the server with
--dry-runfor the first session that writes, and read the planned requests; see Preview changes and protect a site.Keep the password in the keyring, or use
--secret envor--secret commandwhere there is none; see Use the command line in scripts and CI.Offer only the tools the job needs with
--tool, and read Protect a site from an agent before you give a model write access.