Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge n11 mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
n11 Seller-Integrations-API (Türkei): Produkte mit Tasks zum Anlegen, Ändern, für Preis und Bestand und ihren Ergebnissen, Kategoriebaum und Attribute, Bestellungen als Versandpakete mit Freigabe, Aufteilen, Abholung und Rechnungslink, Retourenanfragen und Kundenfragen. Produkte löschen und Retouren ablehnen sind bei der Installation aus.
Frag einfach
Beispiel-Prompts für n11
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → n11 klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
n11 + ChatGPT
n11 Seller-Integrations-API (Türkei): Produkte mit Tasks zum Anlegen, Ändern, für Preis und Bestand und ihren Ergebnissen, Kategoriebaum und Attribute, Bestellungen als Versandpakete mit Freigabe, Aufteilen, Abholung und Rechnungslink, Retourenanfragen und Kundenfragen. Produkte löschen und Retouren ablehnen sind bei der Installation aus.
Voraussetzungen
Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:
N11_APP_KEY, N11_APP_SECRET
Schritt 1 — Zugangsdaten holen
Die Einrichtung dauert etwa 5 Minuten. Du brauchst ein n11-Verkäuferkonto.
- Melde dich im n11-Verkäuferpanel (so.n11.com) an und öffne Hesabım > API Hesapları (Konto > API-Konten). Leg ein API-Konto an, falls es keins gibt.
- Kopiere den API anahtarı (Key) in
N11_APP_KEYund das API şifresi (Secret) inN11_APP_SECRET. - Installiere den Connector und rufe
n11_list_productsauf: Es listet deine Produkte und bestätigt das Paar.
Welche API: die n11-Seller-Integrations-API auf https://api.n11.com (Dokumentation unter developer.n11.com). Produkte, Preise und Bestand, Kategorien und Bestellungen laufen über die aktuellen REST-Dienste von n11, die Key und Secret in den Headern appkey und appsecret erwarten. Retouren, Kundenfragen und der Rechnungslink gibt es nur über die SOAP-Dienste von n11; dort setzt der Connector Key und Secret für dich in die Anfrage. Seit dem 15. August 2025 brauchen auch die Kategoriedienste den Key.
Was er liest: deine Produkte mit n11-Produkt-ID, Stock Code, Titel, Kategorie, Product Main ID (Gruppe), Status, Verkaufsstatus, Preisen, Bestand, Mehrwertsteuer- und Provisionssatz, Attributen und Bildern, gefiltert nach Stock Code, Gruppencode, Verkaufs- oder Freigabestatus, Marke oder Kategorie (productStatus InApproval heißt, n11 wartet auf eine Aktion von dir, CatalogRejected kommt mit rejectInfo); den ganzen Kategoriebaum und die Attribute einer Blattkategorie mit ihren erlaubten Werten; die Ergebnisse von Produkt-Tasks; Bestellungen als Versandpakete mit Bestellnummer, Status, Käufer, Rechnungs- und Lieferadresse, Versanddienstleister und Tracking, vereinbartem Versanddatum und den Positionen (orderLineId, Produkt, Stock Code, Menge, Preis, Rabatte, sellerInvoiceAmount, Provision); Retourenanfragen mit Grund, Bestellnummer, Produkt, Menge, Preisen, Käufer und Sendungsverfolgung sowie die Gründe, die du zum Aufschieben oder Ablehnen angeben darfst; Kundenfragen mit Käufer, Produkt, Frage- und Antwortdatum.
Jeder Produkt-Schreibzugriff ist ein Task: n11_create_products, n11_update_products (Status Suspended nimmt ein Produkt aus dem Verkauf), n11_update_price_and_stock und n11_delete_products nehmen bis zu 1.000 Stock Codes pro Aufruf und antworten mit einer Task-id und dem Status IN_QUEUE (oder REJECT mit Gründen). Die KI ruft dann n11_get_task_details auf, bis der Status PROCESSED ist, und liest für jeden Stock Code status (SUCCESS oder FAIL) und reasons. Eine 200 auf den Schreibzugriff heißt nur, dass der Task eingereiht ist. Zum Anlegen nimmt die KI eine Blattkategorie (subCategories null) und schickt jedes Pflichtattribut: valueId, wenn isCustomValue false ist, sonst customValue; dieselbe productMainId gruppiert Varianten.
Bestellungen: Neue Pakete haben den Status Created. n11_approve_order_lines setzt Positionen auf Picking; du versendest mit dem n11-Cargo-Kampagnencode in cargoTrackingNumber, danach geht das Paket auf Shipped und Delivered. Ein Picking-Paket lässt sich nach Position (n11_split_package) oder nach Menge (n11_split_package_by_quantity) aufteilen, wahlweise mit Stornierung von Mengen mit Grund 61 nicht vorrätig, 62 defekt, 63 falscher Preis, 64 höhere Gewalt, 65 Sonstiges. Sperrige Ware bekommt eine Abholung mit n11_create_collection_request, Schmuckpositionen ihre Arbeitskosten mit n11_send_labor_costs, und n11_send_invoice_link speichert den Rechnungslink (bei E-Export-Bestellungen, wo micro true ist, mit Rechnungsnummer und -datum).
Retouren und Fragen: n11_list_claim_returns zeigt standardmäßig REQUESTED-Retouren (ALL für alle Status; Suche nach Bestellnummer mit searchInfoType ORDERID); n11_approve_claim_return erstattet dem Käufer, n11_postpone_claim_return schiebt die Entscheidung mit Grund auf. n11_answer_product_question beantwortet eine Frage genau einmal; die Antwort ist danach öffentlich.
Schreibzugriffe: erst bestätigen. Preise, Bestand, Produktstatus, Bestellfreigabe, Aufteilungen und Stornierungen, Retouren und Antworten wirken auf den Live-Shop. Vor jedem Aufruf zeigt dir die KI, was sich ändert (Stock Codes mit altem und neuem Preis oder Bestand, Positionen, den Antworttext), und wartet auf dein Ja.
Bei der Installation deaktiviert: n11_delete_products und n11_deny_claim_return. Ein Administrator schaltet sie ein, wenn das Team sie braucht.
Datenformate: Bestelldaten (startDate, endDate, lastModifiedDate, invoiceDateTime) sind Epoch-Millisekunden in türkischer Zeit (UTC+3), z. B. 1793318400000; die SOAP-Dienste nutzen dd/mm/yyyy. Ohne Datum zeigt die Paketliste die letzten 15 Tage, längere Zeiträume werden auf 15 Tage gekürzt. Preise sind in TL, außer currencyType sagt USD oder EUR; Preise gehen mit Punkt und zwei Nachkommastellen, und salePrice darf listPrice nicht übersteigen. IDs wie orderNumber und n11ProductId können mit der Zeit länger werden, behandle sie also als Strings. Bestelldaten vor November 2024 sind nicht verfügbar.
Paging: Die REST-Listen beginnen bei Seite 0 und liefern totalPages; die KI hört auf, wenn content leer ist. Produkte kommen mit höchstens 250 pro Seite, Pakete mit 100, Retouren mit 20.
Limits: Die Bestellliste erlaubt 1.000 Anfragen pro Minute, Produkt-Schreibzugriffe 1.000 Stock Codes pro Aufruf und die Fragenliste einen Aufruf pro Minute.
Häufige Fehler: 401 (SellerApiUserUnauthorizedException) heißt, n11 hat Key und Secret abgelehnt: Kopiere beide erneut aus Hesabım > API Hesapları. 403 Authentication failed heißt, Key und Secret gehören nicht zusammen oder das API-Konto ist inaktiv. Eine SOAP-Antwort mit Status failure enthält n11s errorMessage. Ein Task mit REJECT oder ein Stock Code mit FAIL nennt die Gründe, etwa ein fehlendes Pflichtattribut.
Der Connector erstellt keine Versandlabels und liest weder deine n11-Zahlungen noch Abrechnungen: Dafür gibt es keine Tools.
Schritt 2 — Adapter installieren
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
Schritt 3 — Connector in ChatGPT hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.
- Geh zu chatgpt.com/plugins, klicke auf Add und dann auf Add custom MCP server.
- Gib einen Namen ein, z. B. Name:
n11. - Trag unter Connection als Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDein und lass Authentication auf OAuth. - Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
- Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.
Verfügbare 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) |
Beispiel-Prompts
- „Welche unserer n11-Produkte stehen auf InApproval oder CatalogRejected, und warum?“
- „Setz den Bestand von Stock Code ABC-1 auf 40 und den Verkaufspreis auf 199,90 TL. Zeig mir vorher alte und neue Werte und prüf danach das Task-Ergebnis.“
- „Liste die neuen n11-Pakete (Created) der letzten drei Tage mit ihren Positionen.“
- „Zeig die offenen Retourenanfragen auf n11 und die Gründe, die die Käufer angegeben haben.“
- „Entwirf Antworten auf die offenen Kundenfragen dieser Woche und lass mich jede freigeben, bevor du sie sendest.“
FAQ
Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.
Nächste Schritte
- Connector-Startseite
- Mit Claude verbinden
- Mit Cursor verbinden
- Mit Gemini verbinden
- Mit Meta Muse verbinden
- Mit Microsoft Copilot verbinden
War dieser Guide hilfreich?