Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the PlentyONE in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
PlentyONE (plentymarkets) e-commerce ERP: orders with items and addresses, order statuses and sales channels, items and variations with prices, barcodes and texts, stock per warehouse, categories, manufacturers, sales prices and contacts. Creating items and changing variations are included, installed switched off.
Try asking
Example prompts for PlentyONE
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → PlentyONE, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
PlentyONE + ChatGPT
PlentyONE (plentymarkets) e-commerce ERP: orders with items and addresses, order statuses and sales channels, items and variations with prices, barcodes and texts, stock per warehouse, categories, manufacturers, sales prices and contacts. Creating items and changing variations are included, installed switched off.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
PLENTYONE_URL, PLENTYONE_USERNAME, PLENTYONE_PASSWORD
Step 1 — Get credentials
Setting up takes about 5 minutes. You need a PlentyONE system (formerly plentymarkets) on a plan above Lite, because Lite has no REST access, and a dedicated API user with its own role.
- In PlentyONE open Setup → Account management → Roles, create a role for the AI, switch to Advanced and tick the REST API rights it needs, for example Items (show), Stock management (show), Categories (show), Orders and Order statuses (show) and CRM contacts (show). No REST right is active by default.
- Under Setup → Account management → Accounts create a user with access Only API user, give it that role and a password.
- Put the address of your system into
PLENTYONE_URL, without/rest, for examplehttps://p12345.my.plentysystems.com. PlentyONE shows it under Setup → Client → Settings, or use the address you sign in at. - Put the API user's username into
PLENTYONE_USERNAMEand its password intoPLENTYONE_PASSWORD. - Install the connector and run
plentyone_list_webstores: it lists the clients (webstores) of your system and shows that the sign-in works.
Sign-in renews itself: the connector signs in with the API user and keeps the access token, which is valid for 24 hours, then signs in again on its own. PlentyONE allows only a few signed-in sessions per user at the same time (3 by default, shared with the back end), so use a dedicated API user rather than a person's account.
What it reads: orders with addresses, order items, amounts, payments, documents and shipping packages; order statuses and sales channels (referrers such as webshop, Amazon, eBay or Otto); items and their variations, the sellable SKUs, with sales prices, barcodes, attribute values, images and suppliers; item names and descriptions per language; stock per warehouse; categories, manufacturers, units, sales price definitions and contacts (customers, suppliers, partners); and the clients (webstores) of the system.
Stock and orders: for each variation and warehouse the AI sees net stock (what can be sold), physical stock (what is on the shelf) and reserved stock (what open orders hold). It finds a variation by its number, part of the number, barcode (EAN), item name or category, and filters orders by status, sales channel and date. Long lists arrive page by page, so the AI keeps asking for the next page until it has them all.
Every right counts: the API user only sees the areas its role allows. If orders or contacts come back with 403, the answer names the missing right and you add it to the role.
Read-only as installed: with the default setup the connector only reads. Nothing in your orders, items, stock, prices or contacts changes.
Switched off at install: plentyone_create_item creates an item with one inactive variation, and plentyone_update_variation changes a variation's name, number, model, active flag, weight or dimensions. Both change the live catalogue that feeds your shop and marketplaces, so an administrator turns them on deliberately, and even then the AI shows you the change and waits for your yes.
Limits: on the Expand and Scale plans PlentyONE allows about 200 reads and 80 writes per user and minute, and answers 429 above that. The AI then waits a minute before trying again.
Common errors: 401 means a wrong username or password, or a user without API access. 403 lists the missing right in missing_permissions, for example order.show: add it to the user's role. A 404 on every call means PLENTYONE_URL is wrong.
The connector does not create, change or cancel orders, book stock, change prices or contacts, or delete anything.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in ChatGPT
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.
- Go to chatgpt.com/plugins, click +, then Add custom MCP server.
- Enter a name, e.g. Name:
PlentyONE. - Under Connection, enter the Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDand keep Authentication on OAuth. - Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
- Install the new plugin from your personal plugins, then type @ in a chat and pick it.
Available tools
| Tool | What it does |
|---|---|
plentyone_list_webstores | List the clients (webstores) of the plentyONE system: id, plentyId (storeIdentifier, used as plentyId in other filters), name, type and… |
plentyone_search_orders | Search orders: id, type, status id, referrer (sales channel), plentyId, dates, amounts and, with with, addresses and order items |
plentyone_get_order | Get one order by id with its relations: addresses, order items (variation, quantity, prices, VAT), amounts, dates, properties, payments… |
plentyone_list_order_statuses | List the order statuses of the system (e.g. 3 waiting for payment, 5 cleared for shipping, 7 outgoing items booked) with their names per… |
plentyone_list_referrers | List the order referrers (sales channels: webshop, Amazon, eBay, Otto, manual entry...) with id, name and backend name |
plentyone_search_items | Search items (the article; sellable versions are its variations): id, manufacturer, condition, customs tariff number, producing country… |
plentyone_get_item | Get one item by id: manufacturer, condition, customs tariff number, producing country, age restriction, stock type, flags and free fields |
plentyone_search_variations | Search variations (the sellable SKUs): id, item id, variation number, model, external id, active flag, availability, purchase price, weight… |
plentyone_get_variation | Get one variation with optional relations: sales prices, barcodes, stock, categories, attribute values, images, unit, suppliers, warehouses |
plentyone_get_item_texts | Get the texts of an item per language: name (name, name2, name3), preview and full description, technical data, meta title, description and… |
plentyone_list_warehouses | List the warehouses with id, name, type (0 sales, 1 repair, 2 corrections, 3 transit, 4 distribution, 5 other), logistics type and notes |
plentyone_get_stock | Get stock per variation and warehouse: physical stock, reserved stock, net (sellable) stock, reorder delta, average purchase price and… |
plentyone_get_warehouse_stock | Get the stock of one warehouse per variation: physical, reserved and net stock, reorder delta and average purchase price |
plentyone_list_categories | List categories with id, parent, level, type and, with with=details, their names and paths per language |
plentyone_list_manufacturers | List manufacturers (brands) with id, name, legal name, URL and address |
plentyone_list_units | List the units of measurement (piece, kg, litre...) with id and ISO unit code. unitId in an item's variation refers to them |
plentyone_list_sales_prices | List the sales price definitions (default price, RRP, special prices per channel or customer class) with id, type, position, names, minimum… |
plentyone_search_contacts | Search contacts (customers, suppliers, partners): id, number, name, e-mail, type, class and, with with, addresses and order summary |
plentyone_create_item | Create a new item with its first variation. plentyONE creates the variation inactive; set texts, prices and stock afterwards in plentyONE… |
plentyone_update_variation | Change fields of one variation: name, model, variation number, active flag, weight and dimensions |
Example prompts
- "Which Amazon orders from yesterday are still waiting for payment?"
- "How much of SKU 10045-BL can we still sell across all warehouses, and how much is held by open orders?"
- "Find the product with EAN 4012345678901 and show me its sales prices and stock."
- "Show me order 58213 with the delivery address and every item in it."
- "Look up the customer Smith Trading Ltd and show me their addresses and order summary."
FAQ
Does the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.
Next steps
Was this guide helpful?
