Cómo conectar n11 a Gemini vía MCP

💡 ¿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 + Gemini

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.

1. 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.
2. Copia la API anahtarı (clave) en N11_APP_KEY y la API şifresi (secreto) en N11_APP_SECRET.
3. 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 Gemini

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

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

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

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de n11.

Herramientas disponibles

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

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot