Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the n11 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
n11 seller integration API (Turkey): products with create, update, price and stock tasks and their results, category tree and attributes, orders as shipment packages with approval, splitting, pickup and invoice link, return requests and customer questions. Deleting products and refusing returns install switched off.
Try asking
Example prompts for n11
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 → n11, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
n11 + Meta Muse
n11 seller integration API (Turkey): products with create, update, price and stock tasks and their results, category tree and attributes, orders as shipment packages with approval, splitting, pickup and invoice link, return requests and customer questions. Deleting products and refusing returns install 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:
N11_APP_KEY, N11_APP_SECRET
Step 1 — Get credentials
Setting up takes about 5 minutes. You need an n11 seller account.
- Sign in to the n11 seller panel (so.n11.com) and open Hesabım > API Hesapları (account > API accounts). Create an API account if there is none.
- Copy the API anahtarı (key) into
N11_APP_KEYand the API şifresi (secret) intoN11_APP_SECRET. - Install the connector and run
n11_list_products: it lists your products and confirms the pair.
Which API: the n11 seller integration API on https://api.n11.com (documentation at developer.n11.com). Products, prices and stock, categories and orders use n11's current REST services, which take the key and secret in the appkey and appsecret headers. Returns, customer questions and the invoice link exist only on n11's SOAP services; there the connector puts the key and secret inside the request for you. Since 15 August 2025 the category services need the key as well.
What it reads: your products with n11 product id, stock code, title, category, product main id (group), status, sale status, prices, stock, VAT and commission rate, attributes and images, filtered by stock code, group code, sale or approval status, brand or category (productStatus InApproval means n11 waits for an action from you, CatalogRejected comes with rejectInfo); the whole category tree and the attributes of a leaf category with their allowed values; the results of product tasks; orders as shipment packages with order number, status, buyer, billing and shipping address, cargo company and tracking, agreed shipping date and the lines (orderLineId, product, stock code, quantity, price, discounts, sellerInvoiceAmount, commission); return requests with reason, order number, product, quantity, prices, buyer and cargo tracking, and the reasons you may give to postpone or refuse; customer questions with buyer, product, question and answer dates.
Every product write is a task: n11_create_products, n11_update_products (status Suspended takes a product off sale), n11_update_price_and_stock and n11_delete_products take up to 1,000 stock codes per call and answer with a task id and status IN_QUEUE (or REJECT with reasons). The AI then calls n11_get_task_details until the status is PROCESSED and reads each stock code's status (SUCCESS or FAIL) and reasons. A 200 on the write only means the task was queued. To create products the AI takes a leaf category (subCategories null) and sends every mandatory attribute: valueId when isCustomValue is false, customValue otherwise; the same productMainId groups variants.
Orders: new packages have status Created. n11_approve_order_lines moves lines to Picking; you ship with the n11 cargo campaign code in cargoTrackingNumber, then the package goes to Shipped and Delivered. A Picking package can be split by line (n11_split_package) or by quantity (n11_split_package_by_quantity, optionally cancelling quantities with reason 61 out of stock, 62 defective, 63 wrong price, 64 force majeure, 65 other). Bulky goods get a pickup with n11_create_collection_request, jewellery lines their labour cost with n11_send_labor_costs, and n11_send_invoice_link saves the invoice link (with invoice number and date for e-export orders, where micro is true).
Returns and questions: n11_list_claim_returns shows REQUESTED returns by default (ALL for every status; search by order number with searchInfoType ORDERID); n11_approve_claim_return refunds the buyer, n11_postpone_claim_return postpones the decision with a reason. n11_answer_product_question answers a question once; the answer is then public.
Writes: confirm first. Prices, stock, product status, order approval, splits and cancellations, returns and answers act on the live store. Before each call the AI shows you what changes (stock codes with old and new price or stock, lines, the answer text) and waits for your yes.
Switched off at install: n11_delete_products and n11_deny_claim_return. An administrator switches them on when the team needs them.
Data formats: order dates (startDate, endDate, lastModifiedDate, invoiceDateTime) are epoch milliseconds in Turkey time (UTC+3), e.g. 1793318400000; the SOAP services use dd/mm/yyyy. Without dates the package list shows the last 15 days, and longer windows are cut to 15 days. Prices are in TL unless currencyType says USD or EUR; prices go with a dot and two decimals, and salePrice may not exceed listPrice. Ids such as orderNumber and n11ProductId can grow longer over time, so treat them as strings. Order data before November 2024 is not available.
Paging: the REST lists start at page 0 and return totalPages; the AI stops when content is empty. Products come at most 250 per page, packages 100, returns 20.
Limits: the order list allows 1,000 requests a minute, product writes 1,000 stock codes per call, and the question list one call a minute.
Common errors: 401 (SellerApiUserUnauthorizedException) means n11 refused the key and secret: copy both again from Hesabım > API Hesapları. 403 Authentication failed means key and secret do not belong together or the API account is inactive. A SOAP answer with status failure carries n11's errorMessage. A task with REJECT or a stock code with FAIL lists the reasons, for example a missing mandatory attribute.
The connector does not create shipping labels and does not read your n11 payments and settlements: there are no tools for that.
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 Muse
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.
Muse adds remote MCP servers as custom connectors and signs in to them with OAuth.
- In Muse, open Settings → Connectors and choose Add custom connector.
- Paste the MCP server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse opens the AnythingMCP sign-in page: sign in and approve access.
- In a chat, ask Muse for something that needs the
n11tools.
You can also set it up from a chat, on the web, in the iOS and Android apps or in WhatsApp. Send Muse this message:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Muse connects from Meta's cloud, so localhost does not work.
Available tools
| Tool | What it does |
|---|---|
n11_list_products | List your n11 products: n11 product id, stock code, title, category, product main id (group), status, sale status, prices, stock, VAT and… |
n11_list_categories | Get the whole n11 category tree in one call (id, parentId, name, subCategories) |
n11_get_category_attributes | Get the attributes of a leaf category with their allowed values: attributeId, name, isMandatory, isVariant (same productMainId groups… |
n11_get_task_details | Read the result of a product task (create, update, price and stock, delete): task status PROCESSED, IN_QUEUE or REJECT and per stock code… |
n11_list_shipment_packages | List orders as shipment packages: order number, package id, status, buyer, billing and shipping address, cargo company and tracking, agreed… |
n11_list_claim_returns | List return requests (claims) with id, status, reason, order number, product, quantity, prices, buyer and cargo tracking; 20 per page… |
n11_list_return_deny_reasons | List the reasons (id and text) you may give when refusing a return with n11_deny_claim_return |
n11_list_return_pending_reasons | List the reasons (id and text) you may give when postponing the decision on a return with n11_postpone_claim_return |
n11_list_product_questions | List customer questions about your products (id, product, subject, question, answer). startDate, endDate, currentPage and pageSize are… |
n11_get_product_question | Get one customer question with buyer name and email, product, question and answer dates, visibility and status |
n11_update_price_and_stock | Update price and/or stock of products by stock code (up to 1,000 per call). listPrice and salePrice go together, with a dot and two… |
n11_create_products | Create products (up to 1,000 per call) in leaf categories with title, description, categoryId, productMainId, stockCode, barcode, images… |
n11_update_products | Update product data by stock code (up to 1,000 per call): status (Active or Suspended to take it off sale), preparingDay, shipmentTemplate… |
n11_delete_products | Delete products by stock code (up to 1,000 per call) |
n11_approve_order_lines | Approve (accept) new order lines: moves Created lines to Picking |
n11_split_package | Split a Picking package into several packages by order line (each group becomes its own package with its own tracking code; lines not… |
n11_split_package_by_quantity | Split a Picking package by quantity, optionally cancelling part of a line (cancelReasonId 61 out of stock, 62 defective, 63 wrong price, 64… |
n11_create_collection_request | Create a collection (pickup) request with a logistics company for Picking packages of bulky goods: every line of the package with box… |
n11_send_labor_costs | Send the labour cost (excluding VAT, with its VAT rate 0, 1, 10 or 20, default 20) of order lines, for gold, jewellery and similar… |
n11_send_invoice_link | Save the invoice link (https, pdf, png or jpeg) of an order; a new link replaces the previous one |
n11_approve_claim_return | Approve a return request: the buyer gets the refund |
n11_postpone_claim_return | Postpone the decision on a return request by some days, with a reason from n11_list_return_pending_reasons and a note |
n11_deny_claim_return | Refuse a return request with a reason from n11_list_return_deny_reasons and a note; for most reasons say how the product goes back… |
n11_answer_product_question | Answer a customer question (1 to 2,048 characters) |
Example prompts
- "Which of our n11 products are in InApproval or CatalogRejected, and why?"
- "Set the stock of stock code ABC-1 to 40 and its sale price to 199.90 TL. Show me old and new values first, then check the task result."
- "List the new (Created) n11 packages of the last three days with their lines."
- "Show the open return requests on n11 and the reasons the buyers gave."
- "Draft answers to this week's open customer questions and let me approve each one before you send it."
FAQ
Where is Muse available? Meta currently offers Muse in the US and Canada, on the web, in the iOS and Android apps and in WhatsApp.
Does Meta review this connector? No. Meta doesn't review custom connectors. Muse sees only the tools you switched on for this MCP server in AnythingMCP, and you can disconnect it anytime under Settings → Connectors.
Next steps
- Connector landing page
- Connect to Claude
- Connect to ChatGPT
- Connect to Cursor
- Connect to Gemini
- Connect to Microsoft Copilot
Was this guide helpful?