MCP de MercadoLibre para vendedores — conectá tu tienda a Claude sin servidor

Palabras clave: MCP MercadoLibre · MercadoLibre Claude · conectar MercadoLibre a Claude · API MercadoLibre IA · Model Context Protocol MercadoLibre · vendedores MercadoLibre · automatizar MercadoLibre con IA

Conectá tu cuenta de MercadoLibre a Claude y preguntale en lenguaje natural: "¿cómo vienen las ventas?", "¿qué preguntas tengo sin responder?", "¿estoy ganando el catálogo?", "¿qué promociones me está ofreciendo MercadoLibre?".

17 herramientas · multicuenta (varias tiendas, con consolidado) · sin servidor propio · tokens guardados solo en tu computadora · hecho por Algoritmo Digital, consultora especializada en MercadoLibre.

Claude ──MCP──► este conector ──OAuth 2.0 + PKCE──► API oficial de MercadoLibre

Por qué este y no otro

¿Tenés varias tiendas, querés rentabilidad real con tus costos, caja de MercadoPago y vigilancia de competidores gestionada? Eso es nuestro conector premium con CRM — este conector directo es gratis y para cualquier vendedor.

Related MCP server: Mercado Livre MCP Server

Guía de instalación (10 minutos, sin servidor, paso a paso)

No hace falta saber programar. Necesitás: una cuenta de vendedor de MercadoLibre, Claude Desktop y Node.js LTS instalados (ambos gratis, se instalan con "siguiente, siguiente").

Paso 1 — Creá tu aplicación gratis en MercadoLibre

Entrá a developers.mercadolibre.com.ar con tu cuenta de vendedor → Mis aplicaciones → Crear nueva aplicación y completá así:

• URI de redirect (el campo que más errores causa — copiala exacta, sin barra final):

  https://kokesaurio.github.io/mercadolibre-sellers-mcp-algoritmo-Digital/conectar.html

• Scopes: marcá read, write y offline_access — sin este último, la conexión se corta cada 6 horas.

Paso 2 — Anotá el App ID y el Secret Key

Al guardar, MercadoLibre te muestra los dos datos que van en Claude:

⚠️ El Secret Key es como una contraseña: no lo compartas ni lo publiques.

Paso 3 — Agregá el conector a Claude Desktop

Abrí el archivo de configuración:

• Windows: apretá Win + R, pegá %APPDATA%\Claude\claude_desktop_config.json y Enter (se abre con el Bloc de notas).

• Mac: Claude Desktop → Settings → Developer → Edit Config.

Si el archivo está vacío, pegá este bloque completo (reemplazando tus dos datos del paso 2). Si ya tenés otros conectores, agregá solo la parte "mercadolibre":

{
  "mcpServers": {
    "mercadolibre": {
      "command": "npx",
      "args": ["-y", "github:kokesaurio/mercadolibre-sellers-mcp-algoritmo-Digital"],
      "env": {
        "ML_APP_ID": "TU_APP_ID",
        "ML_APP_SECRET": "TU_SECRET_KEY"
      }
    }
  }
}

Guardá y reiniciá Claude Desktop (cerralo del todo y volvé a abrirlo).

¿Usás Claude Code? Un solo comando:

claude mcp add mercadolibre \
  -e ML_APP_ID=TU_APP_ID -e ML_APP_SECRET=TU_SECRET_KEY \
  -- npx -y github:kokesaurio/mercadolibre-sellers-mcp-algoritmo-Digital

Paso 4 — Conectá tu cuenta (una sola vez)

En un chat nuevo decile a Claude: "conectá mi cuenta de MercadoLibre".

1. Claude te da un link → abrilo e iniciá sesión con tu cuenta de vendedor.

2. Tocá Autorizar → la página te muestra un código.

3. Copiá el código y pegáselo a Claude. Listo: la sesión se renueva sola para siempre. ¿Más de una tienda? Repetí este paso con cada cuenta.

Probá: "¿cómo vienen las ventas de la semana?", "¿qué preguntas tengo sin responder?", "¿estoy ganando el catálogo?".

Si algo falla (los 5 errores clásicos)

¿Seguís trabado? Escribinos por WhatsApp y te ayudamos.

Herramientas (17)

✏️ = escribe en tu tienda real. Claude siempre pide confirmación antes, y con ML_SOLO_LECTURA=1 esas herramientas directamente no existen.

Skills incluidas (7)

En skills/ vienen 7 skills fijas para Claude (Configuración → Capacidades → Skills → subir la carpeta) que convierten las herramientas en flujos de trabajo completos:

Varias tiendas

Corré ml_conectar una vez por cada cuenta. Todas las herramientas aceptan cuenta (el user_id) para elegir tienda; sin indicarla se usa la predeterminada (⭐, se cambia con ml_cuentas), y si hay varias sin predeterminada el conector pide elegir en vez de adivinar — nunca opera en la tienda equivocada. "¿Cómo vienen las ventas de todas las tiendas?" usa el consolidado.

Seguridad

• OAuth 2.0 con PKCE; los tokens viven en ~/.meli-sellers-mcp/cuentas.json con permisos 0600, en tu máquina y en ningún otro lado.

• El refresh token de ML es de un solo uso: el conector serializa los refresh (single-flight) para que dos llamadas concurrentes no revoquen tu cuenta.

• La página del código de autorización es estática (GitHub Pages) y no envía nada a ningún servidor.

• Cero telemetría, cero base de datos externa.

Desarrollo en el entorno de Claude

npm install
npm test      # 21 pruebas E2E contra un MercadoLibre simulado
npm run dev   # levanta el simulado en :9990 (conectar con code CODE-OK)

Regla para contribuir (humano o IA): todo cambio deja npm test en verde, y cada funcionalidad nueva suma su caso a dev/entorno.js.

¿Querés más?

Algoritmo Digital hace consultoría, gestión de cuentas y desarrollo a medida sobre MercadoLibre hace más de 15 años. Escribinos: WhatsApp

Licencia

MIT — Algoritmo Digital.