# Plone MCP for AI Agents AI Agent Connect

> Plone lets you manage your enterprise CMS content, user permissions, and publication workflows through your AI agent. You can search for specific resources, create new pages, update metadata, and move content through various lifecycle stages without ever opening a web browser. It turns your AI into a dedicated content editor and site administrator for your Plone instance.

## Overview
- **Category:** document-management
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_g6iXcoVFJw211BEVIrauCIn8dk9jo3oKnobRjnbL/ai-agent-connect
- **Tags:** cms, plone, enterprise-content, workflow-automation, user-management

## Description

Managing a massive enterprise CMS usually means getting lost in nested folders and complex permission menus. You spend more time clicking through the interface than actually creating content. This Connector changes that by letting your agent do the heavy lifting. Instead of hunting for a specific page to update a typo or checking which users have access to a folder, you just tell your AI client what needs to happen. It handles the navigation, finds the right resources, and makes the changes for you. Because it's hosted on Vinkius, you get a reliable way to connect your existing CMS to your favorite tools like Cursor or Claude. It basically turns your content management into a conversation. You can audit your current publication states, handle bulk updates, or set up new user groups in seconds. It's about getting the work done without the friction of a legacy web UI.

## Tools

### update_content
Perform partial updates on existing content objects. This lets you change a few fields without re-saving the whole page.

### create_group
Create a new group to organize your users and permissions. It helps manage access across different sections.

### create_user
Create a new user account within the CMS. Use this to onboard new team members to your platform.

### delete_content
Remove a content object from your site structure. This is useful for cleaning up old pages or folders.

### delete_group
Delete a group from your CMS. Use this to remove permissions for outdated departments or projects.

### delete_user
Remove a user from your Plone instance permanently. Use this for offboarding or cleaning up old accounts.

### get_content
Fetch a specific content object using its path. This allows you to quickly see the data for any page.

### get_group
Retrieve details for a specific group in the CMS. Check membership and settings with a single command.

### get_user
Get the profile details for a specific user. Use this to verify permissions or check user status.

### get_workflow
Check the current status and history of a content object's workflow. See exactly where a page is in the pipeline.

### list_groups
See a list of all groups currently in your Plone instance. This provides a quick overview of your site permissions.

### list_users
View a list of all users (requires Manager role). Use this to audit your active user base in one go.

### search_content
Search for content using full-text or type filters. Find specific pages or news items without knowing their path.

### transition_workflow
Trigger a move to the next step in a content's workflow. Push content from draft to published instantly.

### update_group
Modify the settings or members of an existing group. Quickly adjust permissions for your team members.

### update_user
Update specific details for an existing user profile. This helps keep user information current without manual entry.

### create_content
Create a new content object at a specific path. This lets you build out your site structure quickly.

## Prompt Examples

**Prompt:** 
```
Find all documents in the news folder that mention 'roadmap' and tell me their status.
```

**Response:** 
```
I've searched the /news path for documents containing 'roadmap'. Here is what I found:

| Document Title | Current Status | Workflow History |
| :--- | :--- | :--- |
| **Product Roadmap 2024** | Published | Draft -> Review -> Published |
| **Q3 Engineering Roadmap** | Private | Draft -> Review |

Would you like me to transition the Q3 Roadmap to 'Published'?
```

**Prompt:** 
```
Create a new folder called 'Marketing 2025' in the root directory.
```

**Response:** 
```
Successfully created the folder **Marketing 2025** at path `/marketing-2025`. You can now start adding content to this directory.
```

**Prompt:** 
```
Show me the current status of the page at /about-us.
```

**Response:** 
```
I've retrieved the page at `/about-us`.

*   **Title:** About Our Company
*   **Current Status:** Private
*   **Next Step:** Review

Would you like to see the full workflow history for this page?
```

## Capabilities

### Create new content objects
Generate new pages or folders in your CMS instantly.

### Update existing content
Modify specific parts of your pages without overwriting everything.

### Search for specific resources
Find content using full-text queries or path filtering.

### Manage user permissions
Create, delete, or update user profiles and group memberships.

### Trigger workflow transitions
Move content from draft to published status automatically.

### Audit workflow history
Check the current state and history of any content object.

## Use Cases

### Finding and checking content status
A content manager asks to find all documents in the news folder that mention 'roadmap' and check their status. The agent uses search_content and get_workflow to list them in a table.

### Setting up new marketing directories
A user asks the agent to create a new folder called 'Marketing 2025' in the root directory. The agent uses create_content to set up the structure immediately.

### Pushing content live
A site admin tells the agent to move a new press release from draft to published. The agent uses transition_workflow to push the content live.

### Onboarding new team members
An admin asks to add a new editor to the content group. The agent uses create_user and update_group to handle the onboarding in one go.

## Benefits

- Skip the UI: Use search_content to find exactly what you need in seconds instead of clicking through nested folders.
- Faster updates: Use update_content to modify specific parts of a page without having to re-save the entire object.
- Easier user management: Use create_user and create_group to handle permissions at scale through simple commands.
- Automated workflows: Use transition_workflow to move content through its lifecycle without manual intervention.
- Instant audits: Use get_workflow to see the full history of a content object and see exactly where it sits in the pipeline.
- Bulk actions: Use list_users and list_groups to see your site structure and user base in one quick overview.

## How It Works

The bottom line is you stop navigating menus and start giving direct commands to manage your CMS content.

1. Subscribe to the Plone MCP on Vinkius.
2. Provide your Plone Instance URL and Personal Access Token.
3. Ask your AI client to find, create, or update content.

## Frequently Asked Questions

**Can I use Plone MCP to update my website content?**
Yes. You can ask your AI client to find specific pages and update their content, titles, or metadata using natural language commands.

**How does Plone MCP help with user management?**
It allows you to create new users, manage group memberships, and update user profiles without having to navigate the CMS admin dashboard.

**Can I move content through its lifecycle with Plone MCP?**
Yes. Your agent can trigger workflow transitions to move content from draft to review or from review to published status automatically.

**Does Plone MCP work with Cursor or Claude?**
It works with any MCP-compatible client, including Claude, Cursor, and Windsurf, allowing you to manage your CMS from your favorite tools.

**Can I search for content in Plone using natural language?**
Yes. You can use full-text search to find any content object by its name or keywords, rather than needing to know the exact folder path.

**Can I search for specific content types like Folders or Documents?**
Yes! Use the `search_content` tool and provide the `portal_type` parameter (e.g., 'Folder' or 'Document') to filter your results.

**How do I update the title or description of an existing page?**
Use the `update_content` tool. Provide the `path` to the content and a `json_body` containing the fields you want to change, such as `{"title": "New Title"}`.

**Is it possible to manage user accounts through this server?**
Yes, if your credentials have sufficient permissions, you can use `list_users`, `get_user`, and `create_user` to manage the site's membership.