Cómo conectar Trendyol a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Trendyol, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Trendyol + Cursor

Gestiona una cuenta de vendedor de Trendyol desde un agente de IA: productos (listado Product v2, creación, contenido, archivo), stock y precios, buybox, resultados de lotes, paquetes de envío con estado, seguimiento, transportista y enlace de factura, devoluciones, preguntas y respuestas de clientes, categorías, atributos y marcas, direcciones y liquidaciones financieras. Basic auth con la API key y el secret.

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:

TRENDYOL_API_HOST, TRENDYOL_SELLER_ID, TRENDYOL_API_KEY, TRENDYOL_API_SECRET

Paso 1 — Obtener credenciales

1. Inicia sesión en el panel de vendedor de Trendyol (partner.trendyol.com) con el master user (rol de administrador). Solo el master user ve la API key y el secret.
2. Abre el nombre de tu tienda (arriba a la derecha) → Hesap Bilgilerim → Entegrasyon Bilgileri. Copia el Satıcı ID (un número) en TRENDYOL_SELLER_ID, la API Key en TRENDYOL_API_KEY y la API Secret Key en TRENDYOL_API_SECRET.
3. Configura TRENDYOL_API_HOST con https://apigw.trendyol.com para tu tienda en vivo. El host de stage (pruebas) https://stageapigw.trendyol.com necesita credenciales de stage propias y solo responde a direcciones IP que Trendyol haya incluido en su lista blanca (las demás reciben 503), así que sirve para una instalación autoalojada de pruebas, no para tu tienda en vivo.
4. Solo si vendes en un storefront internacional de Trendyol, configura TRENDYOL_STOREFRONT_CODE con su código de país de dos letras. Déjalo vacío para Trendyol Turquía.
5. Instala el conector y ejecuta trendyol_list_stock_and_prices.

Pedidos por el endpoint v2: trendyol_list_orders lee los paquetes de envío a través del endpoint de pedidos v2 de Trendyol (/v2/orders), que Trendyol hizo obligatorio el 15 de octubre de 2026, cuando las listas de pedidos antiguas dejan de funcionar. Llega como máximo al último mes, con una ventana de fechas de 2 semanas como máximo (sin fechas, la última semana) y solo a los primeros 10.000 paquetes de un filtro, así que para ver más la IA acota la ventana o filtra por estado.

Primero confirma: las actualizaciones de precio y stock, los cambios de contenido, el estado de los paquetes, los números de seguimiento, los cambios de transportista, los enlaces de factura, la aprobación de devoluciones, las respuestas a preguntas, el archivado y la creación de productos actúan sobre tu tienda en vivo. La IA te muestra qué va a cambiar (códigos de barras con valores antiguos y nuevos, el paquete y sus líneas, el texto de la respuesta) y espera tu sí. Las escrituras de productos son asíncronas: un resultado correcto solo significa que la solicitud quedó en cola, así que la IA comprueba el resultado con trendyol_get_batch_request (los resultados siguen disponibles durante 4 horas).

Desactivadas al instalar: trendyol_delete_products (no se puede deshacer), trendyol_report_unsupplied (cancela líneas de pedido para el cliente, no se puede deshacer) y trendyol_reject_claim_items (pide a Trendyol que rechace artículos devueltos).

Límites: como máximo 50 solicitudes cada 10 segundos en un endpoint, más límites por minuto por grupo de servicios que dependen del nivel de listing de tu tienda. Una actualización de precios y stock admite hasta 1.000 códigos de barras (como máximo 20.000 unidades por producto, precio de venta no superior al precio de lista), y Trendyol rechaza la misma solicitud repetida en 15 minutos o más de 30 actualizaciones de precio por minuto para un código de barras. Las listas financieras necesitan un tipo de transacción y una ventana de 15 días como máximo.

Errores comunes: 401 con ClientApiAuthenticationException o basic.authorization.failed: credenciales incorrectas (las credenciales de stage y de producción son distintas). 403: revisa TRENDYOL_SELLER_ID, porque Trendyol exige un User-Agent construido a partir de él. 429 too.many.requests: espera un momento y vuelve a intentarlo.

El conector no usa el antiguo host api.trendyol.com/sapigw, ni las listas de pedidos antiguas ni el filtro de productos antiguo.

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Trendyol.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué paquetes de envío de los últimos 3 días siguen en estado Created y qué líneas contiene cada uno?"
• "Revisa la buybox de los códigos de barras 8680001234567 y 8680001234574 y dime si otro vendedor tiene la buybox y a qué precio."
• "Enumera las preguntas de clientes que esperan respuesta y redacta una respuesta para cada una, pero muéstrame las respuestas antes de enviar ninguna."
• "Resume nuestras ventas, devoluciones y comisiones a partir de las liquidaciones del 1 al 15 de octubre."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT