MCP MercadoLibre — conectá MercadoLibre con Claude AI

Servidor MCP (Model Context Protocol) de MercadoLibre para Claude. Conectá tu cuenta de MercadoLibre a Claude AI y consultá ventas, facturación, rentabilidad real, stock, publicaciones, preguntas de compradores, reclamos, reputación, Product Ads y precios de la competencia — todo en lenguaje natural, desde el chat.

Es multitienda de fábrica: si tenés varias cuentas de MercadoLibre, el resumen del día y las métricas llegan sumadas, con el aporte de cada tienda al total. No hay que preguntar cuenta por cuenta.

Compatible con Claude Desktop, Claude Code y cualquier cliente MCP. Funciona como conector local (stdio) o como conector remoto con OAuth 2.1. Pensado para vendedores de MercadoLibre Argentina, México, Brasil, Chile y Colombia.

Palabras clave: MCP MercadoLibre · MercadoLibre API · Claude AI MercadoLibre · conector MCP · Model Context Protocol · automatizar MercadoLibre · ERP MercadoLibre · analytics MercadoLibre · rentabilidad MercadoLibre · MercadoLibre Claude Desktop

No es un panel más. Es la capacidad de preguntar lo que quieras sobre tu cuenta y que alguien cruce los datos por vos.

"¿Cómo viene el día?"
"¿Cuánta plata tengo por acreditar esta semana?"
"¿Qué se me está por quedar sin stock antes del finde?"
"El set de mates dejó de vender, ¿por qué?"
"¿Estoy caro contra la competencia en los productos que más facturan?"
"Contestá las preguntas pendientes, pero mostrame los textos antes"
"¿Cuánto gano realmente con cada venta después de comisión, envío e impuestos?"

Contenido

• Qué problema resuelve

• Cómo funciona

• Todo lo que hace: las 33 herramientas

  • Cuenta y sincronización

  • Ventas y plata

  • Publicaciones, precios y stock

  • Preguntas, mensajes y post-venta

  • Inteligencia de mercado y competencia

• Qué NO hace

• Cómo instalar el MCP de MercadoLibre en Claude

• Variables de entorno

• Preguntas frecuentes

• English summary

Related MCP server: Amazon SP-API MCP Server

Qué problema resuelve

MercadoLibre te da paneles sueltos: uno de ventas, uno de publicidad, uno de reputación, uno de stock en Full. Ninguno te contesta las preguntas que importan, porque esas preguntas cruzan dos o tres paneles a la vez.

"¿Por qué cayó la facturación este mes?" no está en ningún reporte. La respuesta puede ser que perdiste la caja de compra en tres publicaciones de catálogo, que un competidor bajó el precio, que se te agotó el stock en Full de tu producto estrella, o que subió el ACOS de la pauta y dejaste de ser rentable. Sacar eso a mano son cuarenta minutos de pestañas.

Este conector le da a Claude las 32 puertas de entrada a esos datos, y Claude arma el cruce solo.

Cómo funciona

Claude ──MCP──> este servidor ──HTTP+JWT──> CRM Algoritmo Digital ──OAuth──> API MercadoLibre
                      │                            │
              formatea en markdown          sincroniza, cachea,
              y acota los resultados        calcula rentabilidad real

El conector no habla directo con la API de MercadoLibre, y eso es a propósito:

• Sin rate limit. MercadoLibre limita fuerte las llamadas. El CRM ya sincroniza y cachea, así que Claude consulta una base local y responde al instante, sin quemar cuota ni arriesgar un 429 en medio de una conversación.

• Datos que la API no te da. La rentabilidad real necesita el costo de tus productos, tu situación fiscal y el histórico de comisiones. Eso vive en el CRM, no en MercadoLibre.

• Multicuenta resuelto. El OAuth, el refresh de tokens y el manejo de varias cuentas ya están hechos del lado del CRM.

• Histórico. Cambios de precio, visitas y reputación acumulados en el tiempo, algo que la API solo devuelve como foto del momento.

Cada herramienta devuelve markdown ya formateado —tablas legibles, pesos argentinos, fechas locales, listas acotadas— en lugar de JSON crudo. Baja mucho el consumo de contexto y hace que Claude razone sobre los números, no sobre la forma del JSON.

Todo lo que hace

Las 33 herramientas MCP que este servidor le expone a Claude, agrupadas por lo que resuelven. Cada una es una consulta que podés hacer en lenguaje natural.

Cuenta y sincronización

Ventas y plata

Publicaciones, precios y stock

Preguntas, mensajes y post-venta

Inteligencia de mercado y competencia

Las tres marcadas con ✍️ escriben de verdad en MercadoLibre. Están anotadas con destructiveHint, así que Claude te muestra qué va a hacer y espera confirmación. Se pueden apagar por completo con ALLOW_WRITE=0, dejando el conector en modo solo lectura.

Qué NO hace

Vale la pena ser explícito:

• No crea publicaciones nuevas ni las elimina.

• No despacha envíos ni imprime etiquetas.

• No emite facturas (lee la configuración de factura electrónica, no factura).

• No mueve plata: no retira, no transfiere, no cancela ventas.

• No cambia la configuración de la cuenta de MercadoLibre.

• No cierra reclamos ni negocia devoluciones.

Lo que escribe se limita a tres acciones acotadas: precio/stock/título/estado de una publicación, la respuesta a una pregunta, y disparar una sincronización.

Instalación

Cómo conectar MercadoLibre con Claude, en dos modos.

Opción A — local (stdio)

Para vos o tu equipo, corriendo en la máquina de cada uno.

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "mercadolibre": {
      "command": "npx",
      "args": ["-y", "@algoritmodigital/mcp-mercadolibre"],
      "env": {
        "CRM_BASE_URL": "https://tu-crm.ejemplo.com",
        "CRM_USERNAME": "tu-usuario",
        "CRM_PASSWORD": "tu-clave"
      }
    }
  }
}

Claude Code:

claude mcp add mercadolibre \
  -e CRM_BASE_URL=https://tu-crm.ejemplo.com \
  -e CRM_USERNAME=tu-usuario -e CRM_PASSWORD=tu-clave \
  -- npx -y @algoritmodigital/mcp-mercadolibre

Si la cuenta tiene 2FA, generá un JWT desde el panel y usá CRM_TOKEN en lugar de usuario y clave. Con ML_CUENTA fijás una cuenta de ML por defecto y te ahorrás pasarla en cada consulta.

Opción B — remoto (conector con OAuth)

Un solo servidor para todos tus clientes: cada uno lo agrega en Claude y se loguea con su propio usuario del panel. Nadie configura nada.

git clone https://github.com/kokesaurio/mercadolibre-algoritmodigital.git
cd mercadolibre-algoritmodigital
npm install
cp .env.example .env    # completar CRM_BASE_URL, PUBLIC_URL y OAUTH_SIGNING_SECRET
npm run start:http

Publicalo detrás de HTTPS (nginx, Caddy, Railway, Fly.io) y en Claude entrá a Configuración → Conectores → Agregar conector personalizado con la URL https://tu-dominio/mcp. Claude descubre solo el servidor de autorización, se registra, y le muestra al usuario la pantalla de login.

Implementa OAuth 2.1 completo: registro dinámico de clientes (RFC 7591), PKCE S256 obligatorio, metadata de servidor de autorización (RFC 8414) y de recurso protegido (RFC 9728), access tokens de 1 hora y refresh tokens de 7 días.

Variables de entorno

Estructura

src/
├── client.js          cliente HTTP del CRM: login, cache de JWT, reintento ante 401
├── format.js          tablas markdown, moneda ARS, fechas AR, truncado
├── server.js          arma el McpServer y registra las herramientas
├── oauth.js           servidor de autorización OAuth 2.1 (PKCE + registro dinámico)
├── stdio.js           bin: transporte stdio
├── http.js            bin: transporte Streamable HTTP + OAuth
└── tools/
    ├── sistema.js       cuentas y sincronización
    ├── ventas.js        panel, métricas, órdenes, caja, rentabilidad, geo, embudo
    ├── publicaciones.js catálogo, precios, stock, salud, rendimiento, costos
    ├── preguntas.js     preguntas, respuestas, mensajes, reclamos, reputación
    └── mercado.js       competidores, competitividad, tendencias, ads, catálogo

Desarrollo

npm install
npm run inspect      # MCP Inspector: probar las herramientas a mano
npm start            # stdio
npm run start:http   # HTTP + OAuth

Seguridad

• Las credenciales no se guardan: en modo remoto se cambian por un JWT del CRM y solo se persiste ese token, asociado a un ID de sesión aleatorio.

• Los access tokens se firman con HMAC-SHA256 y se comparan en tiempo constante.

• PKCE S256 es obligatorio; sin code_verifier válido no se emite ningún token.

• Los códigos de autorización son de un solo uso y vencen a los 5 minutos.

• Cada request a /mcp construye un servidor y un cliente HTTP nuevos, sin estado compartido entre usuarios.

• El health check no expone la URL del backend.

• Las herramientas de escritura se apagan con ALLOW_WRITE=0.

Preguntas frecuentes

¿Qué es un servidor MCP?

MCP (Model Context Protocol) es el estándar abierto que usa Claude para conectarse a sistemas externos. Un servidor MCP le expone un conjunto de herramientas al modelo; Claude decide cuál usar según lo que le pidas. Es la forma oficial de darle a Claude acceso a datos privados sin subirlos a ningún lado.

¿Cómo conecto MercadoLibre con Claude?

Instalás este conector (local con npx, o remoto agregándolo como conector personalizado), le das la URL de tu backend y tus credenciales, y Claude ya puede consultar tu cuenta. La guía completa está en Instalación.

¿Necesito una app en el DevCenter de MercadoLibre?

No para este conector. El OAuth con MercadoLibre lo resuelve el CRM que está detrás, que es el que mantiene los tokens y sincroniza. Este servidor solo consulta ese CRM.

¿Funciona con Claude Desktop y con Claude Code?

Con los dos, y con cualquier cliente que hable MCP. En modo remoto también funciona desde Claude en el navegador y desde el celular.

¿Puede modificar mis publicaciones sin que yo lo sepa?

No. Las tres herramientas que escriben están marcadas como destructivas, así que Claude te muestra qué va a hacer y espera tu confirmación. Y podés dejarlo en modo solo lectura con ALLOW_WRITE=0.

¿Consume el rate limit de la API de MercadoLibre?

No. Las consultas van contra la base ya sincronizada del CRM, no contra MercadoLibre. Solo ml_sincronizar y las dos herramientas de escritura tocan la API oficial.

¿Sirve para MercadoLibre México, Brasil, Chile o Colombia?

Sí. La API de MercadoLibre es la misma para todos los sitios; lo que cambia es el site_id de la cuenta conectada. El formato de moneda y fecha está en pesos argentinos y se ajusta en src/format.js.

¿Puedo usarlo con varias cuentas de MercadoLibre?

Sí, y es el caso para el que está pensado. ml_panel y ml_metricas devuelven el consolidado de todas tus tiendas más el desglose de cada una, sin que tengas que pedirlas de a una. El resto de las herramientas acepta el parámetro cuenta cuando querés mirar una sola.

¿Cómo agrego una tienda nueva?

Le pedís a Claude que te conecte una tienda y usa ml_conectar, que te devuelve el link de autorización de MercadoLibre. Lo abrís, iniciás sesión con la cuenta manager y listo: la tienda nueva ya suma al consolidado.

¿Soporta WooCommerce o Tiendanube?

Todavía no por MCP. Este conector cubre MercadoLibre. WooCommerce está integrado en el CRM que está detrás pero no expuesto como herramientas; Tiendanube no tiene integración aún.

¿Los datos de mi cuenta pasan por algún servidor de terceros?

No. El conector corre donde vos lo pongas —tu máquina o tu servidor— y habla directo con tu backend. Claude recibe únicamente el resultado de cada consulta.

English summary

MCP server for MercadoLibre. Connect your MercadoLibre seller account to Claude AI and query sales, revenue, real profitability, inventory, listings, buyer questions, claims, seller reputation, Product Ads and competitor pricing in plain language.

33 tools across five areas: account management, sales and cash flow, listings and stock, buyer questions and after-sales, and market intelligence. Ships with two transports — stdio for local use with Claude Desktop and Claude Code, and Streamable HTTP with full OAuth 2.1 (dynamic client registration, PKCE S256) to run it as a hosted remote connector for multiple users.

Built for MercadoLibre sellers in Latin America. Documentation is in Spanish; the codebase and tool schemas are self-describing. MIT licensed.

MIT · Algoritmo Digital