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

Use plone-client with coding agents

In Claude Desktop

The MCP server, over standard input and output

Connect Claude Desktop to a Plone site

In another chat application

The MCP server, over standard input and output

Connect an assistant through the MCP server

On another computer, or shared by a team

The MCP server, over HTTP

Connect an assistant through the MCP server

In your own code

The Python library

Build a custom agent

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 --tool

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#

  • Python 3.12 or later, for the markdown extra that turns Markdown into pages.

  • uv.

  • Docker, for the local site that the tutorials change.

  • An assistant or a coding agent.

Follow these steps#

  1. Install plone-client adds the mcp and markdown extras, because the server and its Markdown pages need them.

  2. Your first agent session gives an agent a site, first through the command line and then through the MCP server.

  3. Protect a site from an agent decides what your model can see and do, before you point it at a real site.

  4. Connect an assistant through the MCP server or Use plone-client with coding agents connects the tool you use.

  5. Build an editorial assistant builds a complete assistant for two sites.

Going further#

If something breaks#

Troubleshoot goes from the symptom to the fix.

Before you connect a real site#