Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте n11 одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
API интеграции продавцов n11 (Турция): товары с задачами создания, изменения, цены и остатков и их результатами, дерево категорий и атрибуты, заказы как отправления с подтверждением, разделением, забором и ссылкой на счёт, заявки на возврат и вопросы покупателей. Удаление товаров и отказ в возврате при установке выключены.
Попробуй спросить
Примеры промптов для n11
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → n11, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
n11 + Microsoft Copilot
API интеграции продавцов n11 (Турция): товары с задачами создания, изменения, цены и остатков и их результатами, дерево категорий и атрибуты, заказы как отправления с подтверждением, разделением, забором и ссылкой на счёт, заявки на возврат и вопросы покупателей. Удаление товаров и отказ в возврате при установке выключены.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
N11_APP_KEY, N11_APP_SECRET
Шаг 1 — Получите учётные данные
Настройка занимает около 5 минут. Нужен аккаунт продавца n11.
- Войдите в панель продавца n11 (so.n11.com) и откройте Hesabım > API Hesapları (аккаунт > API-аккаунты). Если API-аккаунта нет, создайте его.
- Скопируйте API anahtarı (ключ) в
N11_APP_KEY, а API şifresi (секрет) вN11_APP_SECRET. - Установите коннектор и запустите
n11_list_products: он вернёт ваши товары и подтвердит пару ключей.
Какой API: API интеграции продавцов n11 на https://api.n11.com (документация на developer.n11.com). Товары, цены и остатки, категории и заказы идут через текущие REST-сервисы n11, которые принимают ключ и секрет в заголовках appkey и appsecret. Возвраты, вопросы покупателей и ссылка на счёт есть только в SOAP-сервисах n11; там коннектор сам вставляет ключ и секрет в запрос. С 15 августа 2025 года ключ нужен и сервисам категорий.
Что он читает: ваши товары с id товара n11, stock code, названием, категорией, product main id (группа), статусом, статусом продажи, ценами, остатком, ставками НДС и комиссии, атрибутами и изображениями, с фильтрами по stock code, коду группы, статусу продажи или модерации, бренду или категории (productStatus InApproval означает, что n11 ждёт от вас действия, CatalogRejected приходит с rejectInfo); всё дерево категорий и атрибуты конечной категории с допустимыми значениями; результаты задач по товарам; заказы как отправления с номером заказа, статусом, покупателем, адресами для счёта и доставки, службой доставки и трекингом, согласованной датой отгрузки и позициями (orderLineId, товар, stock code, количество, цена, скидки, sellerInvoiceAmount, комиссия); заявки на возврат с причиной, номером заказа, товаром, количеством, ценами, покупателем и трекингом, а также причины, которые можно указать при отсрочке или отказе; вопросы покупателей с покупателем, товаром, датами вопроса и ответа.
Каждая запись по товарам это задача: n11_create_products, n11_update_products (статус Suspended снимает товар с продажи), n11_update_price_and_stock и n11_delete_products принимают до 1000 stock code за вызов и отвечают id задачи со статусом IN_QUEUE (или REJECT с причинами). Затем ИИ вызывает n11_get_task_details, пока статус не станет PROCESSED, и читает для каждого stock code status (SUCCESS или FAIL) и reasons. Ответ 200 на запись означает лишь, что задача поставлена в очередь. Для создания товаров ИИ берёт конечную категорию (subCategories равно null) и передаёт все обязательные атрибуты: valueId, если isCustomValue равно false, иначе customValue; общий productMainId объединяет варианты.
Заказы: новые отправления имеют статус Created. n11_approve_order_lines переводит позиции в Picking; вы отгружаете с кодом кампании доставки n11 в cargoTrackingNumber, после чего отправление переходит в Shipped и Delivered. Отправление в Picking можно разделить по позициям (n11_split_package) или по количеству (n11_split_package_by_quantity), при необходимости отменив часть количества с причиной 61 нет в наличии, 62 брак, 63 неверная цена, 64 форс-мажор, 65 другое. Для крупногабаритных товаров n11_create_collection_request заказывает забор, для ювелирных позиций n11_send_labor_costs передаёт стоимость работы, а n11_send_invoice_link сохраняет ссылку на счёт (для заказов e-export, где micro равно true, с номером и датой счёта).
Возвраты и вопросы: n11_list_claim_returns по умолчанию показывает возвраты REQUESTED (ALL для всех статусов; поиск по номеру заказа через searchInfoType ORDERID); n11_approve_claim_return возвращает деньги покупателю, n11_postpone_claim_return откладывает решение с указанием причины. n11_answer_product_question отвечает на вопрос только один раз; после этого ответ публичен.
Запись: сначала подтверждение. Цены, остатки, статус товара, подтверждение заказов, разделение и отмены, возвраты и ответы действуют на живой магазин. Перед каждым вызовом ИИ показывает, что изменится (stock code со старой и новой ценой или остатком, позиции, текст ответа), и ждёт вашего «да».
Выключено при установке: n11_delete_products и n11_deny_claim_return. Администратор включает их, когда это нужно команде.
Форматы данных: даты заказов (startDate, endDate, lastModifiedDate, invoiceDateTime) это миллисекунды epoch по времени Турции (UTC+3), например 1793318400000; SOAP-сервисы используют dd/mm/yyyy. Без дат список отправлений показывает последние 15 дней, а более длинные интервалы обрезаются до 15 дней. Цены в TL, если currencyType не указывает USD или EUR; цены передаются с точкой и двумя знаками после неё, и salePrice не может превышать listPrice. Id вроде orderNumber и n11ProductId со временем могут удлиняться, поэтому храните их как строки. Данные заказов до ноября 2024 года недоступны.
Постраничная выдача: REST-списки начинаются со страницы 0 и возвращают totalPages; ИИ останавливается, когда content пуст. Товары приходят не больше 250 на страницу, отправления 100, возвраты 20.
Лимиты: список заказов допускает 1000 запросов в минуту, запись по товарам 1000 stock code за вызов, список вопросов один вызов в минуту.
Частые ошибки: 401 (SellerApiUserUnauthorizedException) означает, что n11 отклонил ключ и секрет: скопируйте оба заново из Hesabım > API Hesapları. 403 Authentication failed означает, что ключ и секрет не подходят друг к другу или API-аккаунт неактивен. SOAP-ответ со статусом failure содержит errorMessage от n11. Задача с REJECT или stock code с FAIL перечисляют причины, например отсутствующий обязательный атрибут.
Коннектор не создаёт транспортные этикетки и не читает ваши выплаты и взаиморасчёты n11: для этого нет инструментов.
Шаг 2 — Установите адаптер
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
Шаг 3 — Добавьте коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
n11. - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.
Доступные инструменты
| 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) |
Примеры запросов
- «Какие наши товары на n11 в статусе InApproval или CatalogRejected и почему?»
- «Поставь остаток stock code ABC-1 на 40, а цену продажи 199,90 TL. Сначала покажи старые и новые значения, потом проверь результат задачи.»
- «Покажи новые отправления n11 (Created) за последние три дня с позициями.»
- «Покажи открытые заявки на возврат на n11 и причины, которые указали покупатели.»
- «Подготовь ответы на открытые вопросы покупателей за эту неделю и дай мне одобрить каждый, прежде чем отправлять.»
FAQ
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
Это руководство помогло?