How to Connect Shoptet to Cursor via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Shoptet, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Shoptet + Cursor

Shoptet e-shop (Czech Republic, Slovakia, Hungary), read-only: orders with history and notes, products and variants with prices and stock, categories, brands, stock levels and movements, customers, invoices, proforma invoices, credit notes, payment and shipping methods.

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:

SHOPTET_API_TOKEN

Step 1 — Get credentials

Setting up takes about 3 minutes. You need a Shoptet Premium e-shop, because the private API is only available on Premium, and access to its administration.

1. In the Shoptet administration, open Connections (Propojení), Private API and create a token.
2. Give the token read access to the areas you want the AI to see: orders, products, stock, customers and documents. An area the token cannot read answers 403.
3. Paste the token into SHOPTET_API_TOKEN: only the token, without spaces or quotes.
4. Install the connector and run shoptet_get_eshop: it shows the shop's name, URL, currencies, languages and time zone, which proves the token works.

One token, one e-shop: a token belongs to exactly one e-shop. If you run a .cz and a .sk shop, install the connector a second time with the token of the other shop.

What it reads: the shop's own settings; orders with billing and delivery address, items, prices with and without VAT, status, paid flag, payment and shipping method, sales channel, notes and tracking number; the full history of an order (status changes, e-mails sent, remarks); products and their variants with code, EAN, price, VAT rate, availability and stock, per stock if you ask; categories and brands; stock levels with the amounts reserved by orders, and stock movements; registered customers with addresses, company and VAT id and customer group; invoices with variable symbol, due date and VAT breakdown; proforma invoices; credit notes (opravné daňové doklady) with their reason; and payment and shipping methods.

Shop settings come first: order statuses, order sources, stocks, categories and brands are different in every shop, so the AI first reads their ids from your shop (for example with shoptet_list_order_statuses or shoptet_list_stocks) and then filters with them. A product is found by its code, the SKU you see in the admin and on orders, with shoptet_get_product_by_code.

Pages, times and prices: orders come newest first, at most 50 per page; products 1 to 100 per page; credit notes at most 20 per page. Each list says how many pages there are, and the AI asks for the next one only when it needs it. Times carry an offset such as 2026-10-20T00:00:00+0200: Czech and Slovak shops run on Europe/Prague time. Prices come with the shop currency, for example CZK or EUR.

Read-only: the connector has no tool that changes anything. It cannot change an order or its status, a product, a price, stock or a customer, so there is nothing for the AI to confirm with you.

Limits: Shoptet allows 3 simultaneous requests per token and slows down bursts with a 429. The AI waits a few seconds before trying again, and asks for what it needs instead of paging through the whole shop.

Common errors: 401 expired-token or invalid-token means the token was deleted or has expired: create a new one. 403 invalid-token-no-rights means the token has no access to that area: edit its rights under Private API. 404 means there is no order, product or document with that code.

The connector does not create or change orders, products, prices, stock or customers, does not issue invoices or credit notes, and does not send e-mails to your customers.

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 Cursor

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 shows YOUR_SERVER_ID.

Cursor reads MCP servers from ~/.cursor/mcp.json. Add this entry:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart Cursor.
3. Open Cursor → Settings → MCP and check that anythingmcp is listed and connected.
4. Start chatting: the agent can now call the Shoptet tools.

Available tools

Example prompts

• "Which orders from yesterday are still unpaid, and what is the total of each in CZK?"
• "Show me the history of order 2026000123: when did the status change, which e-mails went to the customer, and what is the tracking number?"
• "Which products are running low in our main warehouse, and how much of each is already reserved by orders?"
• "Find all orders from [email protected] this year and tell me which of her invoices are still unpaid."
• "List the credit notes we issued this month with the reason and the amount, and the invoice each one belongs to."

FAQ

Does Cursor support custom MCP servers on the free tier? Yes, MCP is available on Hobby, Pro and Business plans.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT