Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade n11 con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
API de integración de vendedores de n11 (Turquía): productos con tareas de creación, actualización, precio y stock y sus resultados, árbol de categorías y atributos, pedidos como paquetes de envío con aprobación, división, recogida y enlace a la factura, solicitudes de devolución y preguntas de clientes. Borrar productos y rechazar devoluciones quedan desactivados al instalar.
Prueba a pedir
Prompts de ejemplo para n11
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → n11, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
n11 + ChatGPT
API de integración de vendedores de n11 (Turquía): productos con tareas de creación, actualización, precio y stock y sus resultados, árbol de categorías y atributos, pedidos como paquetes de envío con aprobación, división, recogida y enlace a la factura, solicitudes de devolución y preguntas de clientes. Borrar productos y rechazar devoluciones quedan desactivados al instalar.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
N11_APP_KEY, N11_APP_SECRET
Paso 1 — Obtener credenciales
La configuración lleva unos 5 minutos. Necesitas una cuenta de vendedor en n11.
- Inicia sesión en el panel de vendedores de n11 (so.n11.com) y abre Hesabım > API Hesapları (cuenta > cuentas API). Crea una cuenta API si no hay ninguna.
- Copia la API anahtarı (clave) en
N11_APP_KEYy la API şifresi (secreto) enN11_APP_SECRET. - Instala el conector y ejecuta
n11_list_products: lista tus productos y confirma el par.
Qué API: la API de integración de vendedores de n11 en https://api.n11.com (documentación en developer.n11.com). Productos, precios y stock, categorías y pedidos usan los servicios REST actuales de n11, que piden la clave y el secreto en las cabeceras appkey y appsecret. Devoluciones, preguntas de clientes y el enlace a la factura solo existen en los servicios SOAP de n11; ahí el conector pone la clave y el secreto dentro de la petición por ti. Desde el 15 de agosto de 2025 los servicios de categorías también necesitan la clave.
Qué lee: tus productos con id de producto de n11, stock code, título, categoría, product main id (grupo), estado, estado de venta, precios, stock, tipo de IVA y de comisión, atributos e imágenes, filtrados por stock code, código de grupo, estado de venta o de aprobación, marca o categoría (productStatus InApproval significa que n11 espera una acción tuya; CatalogRejected viene con rejectInfo); el árbol completo de categorías y los atributos de una categoría hoja con sus valores permitidos; los resultados de las tareas de productos; pedidos como paquetes de envío con número de pedido, estado, comprador, dirección de facturación y de envío, empresa de transporte y seguimiento, fecha de envío acordada y las líneas (orderLineId, producto, stock code, cantidad, precio, descuentos, sellerInvoiceAmount, comisión); solicitudes de devolución con motivo, número de pedido, producto, cantidad, precios, comprador y seguimiento del envío, y los motivos que puedes dar para aplazar o rechazar; preguntas de clientes con comprador, producto y fechas de pregunta y respuesta.
Cada escritura de productos es una tarea: n11_create_products, n11_update_products (el estado Suspended retira un producto de la venta), n11_update_price_and_stock y n11_delete_products admiten hasta 1.000 stock codes por llamada y responden con un id de tarea y estado IN_QUEUE (o REJECT con motivos). La IA llama después a n11_get_task_details hasta que el estado es PROCESSED y lee por cada stock code su status (SUCCESS o FAIL) y reasons. Un 200 en la escritura solo significa que la tarea está en cola. Para crear productos la IA toma una categoría hoja (subCategories null) y envía cada atributo obligatorio: valueId cuando isCustomValue es false y customValue en caso contrario; el mismo productMainId agrupa variantes.
Pedidos: los paquetes nuevos tienen estado Created. n11_approve_order_lines pasa las líneas a Picking; envías con el código de campaña de cargo de n11 en cargoTrackingNumber y después el paquete pasa a Shipped y Delivered. Un paquete en Picking se puede dividir por línea (n11_split_package) o por cantidad (n11_split_package_by_quantity), opcionalmente cancelando cantidades con motivo 61 sin stock, 62 defectuoso, 63 precio erróneo, 64 fuerza mayor, 65 otro. La mercancía voluminosa recibe una recogida con n11_create_collection_request, las líneas de joyería su coste de mano de obra con n11_send_labor_costs, y n11_send_invoice_link guarda el enlace a la factura (con número y fecha de factura en los pedidos de e-export, donde micro es true).
Devoluciones y preguntas: n11_list_claim_returns muestra por defecto las devoluciones REQUESTED (ALL para todos los estados; búsqueda por número de pedido con searchInfoType ORDERID); n11_approve_claim_return reembolsa al comprador y n11_postpone_claim_return aplaza la decisión con un motivo. n11_answer_product_question responde una pregunta una sola vez; la respuesta pasa a ser pública.
Escrituras: primero confirmar. Precios, stock, estado de producto, aprobación de pedidos, divisiones y cancelaciones, devoluciones y respuestas actúan sobre la tienda en vivo. Antes de cada llamada la IA te muestra qué cambia (stock codes con precio o stock antiguo y nuevo, líneas, el texto de la respuesta) y espera tu sí.
Desactivados al instalar: n11_delete_products y n11_deny_claim_return. Un administrador los activa cuando el equipo los necesita.
Formatos de datos: las fechas de pedidos (startDate, endDate, lastModifiedDate, invoiceDateTime) son milisegundos epoch en hora de Turquía (UTC+3), p. ej. 1793318400000; los servicios SOAP usan dd/mm/yyyy. Sin fechas, la lista de paquetes muestra los últimos 15 días, y las ventanas más largas se recortan a 15 días. Los precios van en TL salvo que currencyType indique USD o EUR; se envían con punto y dos decimales, y salePrice no puede superar listPrice. Ids como orderNumber y n11ProductId pueden alargarse con el tiempo, así que trátalos como cadenas. Los datos de pedidos anteriores a noviembre de 2024 no están disponibles.
Paginación: las listas REST empiezan en la página 0 y devuelven totalPages; la IA para cuando content está vacío. Los productos llegan como máximo 250 por página, los paquetes 100 y las devoluciones 20.
Límites: la lista de pedidos permite 1.000 peticiones por minuto, las escrituras de productos 1.000 stock codes por llamada y la lista de preguntas una llamada por minuto.
Errores comunes: 401 (SellerApiUserUnauthorizedException) significa que n11 rechazó la clave y el secreto: vuelve a copiar ambos desde Hesabım > API Hesapları. 403 Authentication failed significa que la clave y el secreto no van juntos o que la cuenta API está inactiva. Una respuesta SOAP con estado failure trae el errorMessage de n11. Una tarea con REJECT o un stock code con FAIL indica los motivos, por ejemplo un atributo obligatorio que falta.
El conector no crea etiquetas de envío y no lee tus pagos ni liquidaciones de n11: no hay herramientas para ello.
Paso 2 — Instalar el 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
Paso 3 — Añadir el conector en ChatGPT
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.
- Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
- Escribe un nombre, por ejemplo Name:
n11. - En Connection, introduce como Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy deja Authentication en OAuth. - Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
- Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.
Herramientas disponibles
| 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) |
Ejemplos de prompts
- "¿Cuáles de nuestros productos en n11 están en InApproval o CatalogRejected y por qué?"
- "Pon el stock del stock code ABC-1 en 40 y su precio de venta en 199,90 TL. Enséñame antes los valores antiguos y nuevos y luego revisa el resultado de la tarea."
- "Lista los paquetes nuevos de n11 (Created) de los últimos tres días con sus líneas."
- "Muéstrame las solicitudes de devolución abiertas en n11 y los motivos que dieron los compradores."
- "Redacta respuestas a las preguntas de clientes abiertas de esta semana y deja que apruebe cada una antes de enviarla."
FAQ
¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?