Cómo conectar tu cuenta de Mercado Libre a Claude con MCP

Si vendés en Mercado Libre, seguro conocés la rutina: entrar a Mercado Shops o al panel de vendedor, cruzar reportes de ventas con las liquidaciones de Mercado Pago, sumar comisiones, restar impuestos provinciales y recién ahí saber cuánto ganaste de verdad este mes. El Model Context Protocol (MCP) cambia esa rutina: es el estándar abierto que le permite a Claude conectarse directamente con las APIs de Mercado Libre y responder esas preguntas en el momento, con tus datos reales.

En esta guía te mostramos qué es el MCP de Mercado Libre, qué diferencia hay entre el servidor oficial y las integraciones de la comunidad, y el paso a paso para conectar tu cuenta de vendedor a Claude.

¿Qué es el MCP y por qué te sirve como vendedor?

MCP es un protocolo que estandariza cómo un modelo de IA como Claude se conecta a fuentes de datos y herramientas externas. En criollo: es el "enchufe" que le permite a Claude leer (y en algunos casos operar) tu cuenta de Mercado Libre en lugar de que vos copies y pegues reportes a mano.

Hoy conviven dos caminos:

• El servidor MCP oficial de Mercado Libre (mcp.mercadolibre.com), pensado para desarrolladores: por ahora expone herramientas de búsqueda sobre la documentación técnica de la API (search_documentation, get_documentation_page), útil si estás integrando o programando algo vos mismo.

• Servidores MCP de comunidad/terceros para operaciones de vendedor (por ejemplo, proyectos open source como mercadolibre-mcp), que sí exponen herramientas sobre tu cuenta: publicaciones, órdenes, stock, precios, preguntas, reputación y métricas de producto.

Para lo que la mayoría de los vendedores busca —preguntarle a Claude "¿cuánto vendí neto esta semana?" o "¿qué publicaciones tienen riesgo de stock?"— el camino es el segundo: un servidor MCP que use tus credenciales de la API de Mercado Libre para leer (y opcionalmente escribir) datos de tu cuenta.

Qué vas a poder hacer una vez conectado

• Consultar ventas, unidades y ticket promedio sin abrir el panel de vendedor.

• Calcular ganancia neta real, descontando comisión de Mercado Libre, costo de envío y retenciones de Mercado Pago.

• Detectar publicaciones con stock crítico o con caída de visitas/conversión.

• Revisar preguntas sin responder y tu nivel de reputación.

• Comparar precios contra la competencia dentro de tu categoría.

• Según el servidor que uses, incluso actualizar precio o stock desde una instrucción en lenguaje natural (con supervisión tuya antes de confirmar cualquier cambio).

Requisitos previos

1. Cuenta de vendedor activa en Mercado Libre (Argentina u otro país de la región).

2. Acceso al portal de desarrolladores: developers.mercadolibre.com.ar.

3. Claude Desktop instalado (la conexión MCP se configura ahí, no en la versión web).

4. Si vas a usar un servidor MCP de comunidad basado en Node.js, tener Node.js instalado, o alojar el servidor en un hosting simple (algunos ofrecen instalación con npx, sin necesidad de mantener un servidor propio).

5. Diez minutos y paciencia para el primer login OAuth — es la parte que más se traba si se saltea un paso.

Paso a paso: conectar tu cuenta de Mercado Libre a Claude

1. Creá una aplicación en el portal de desarrolladores

Entrá a developers.mercadolibre.com.ar con el usuario de Mercado Libre de tu cuenta de vendedor y creá una nueva aplicación ("Mis aplicaciones" → "Crear aplicación"). Vas a necesitar completar nombre, descripción y una URL de redirect (si no tenés una propia, cualquier URL fija que controles sirve, incluso una de un servicio gratuito de redirección).

Al crearla, Mercado Libre te entrega dos datos clave que vas a usar en todos los pasos siguientes:

• App ID / Client ID

• Client Secret (nunca lo compartas ni lo subas a un repositorio público)

2. Autorizá la aplicación y obtené el código de autorización

Con el Client ID armás la URL de autorización (siguiendo la documentación oficial de OAuth de Mercado Libre) y la abrís en el navegador logueado con tu cuenta de vendedor. Al aceptar los permisos, Mercado Libre te redirige a tu URL de redirect con un parámetro code en la URL: ese es tu código de autorización, válido por pocos minutos.

3. Canjeá el código por el access token y el refresh token

Con ese código, el Client ID y el Client Secret, hacés un llamado a la API de Mercado Libre para obtener:

• Access token: habilita las consultas a la API. Expira en unas horas (Mercado Libre lo renueva cada 6 hs).

• Refresh token: se usa para renovar el access token sin volver a loguearte. Es de un solo uso: cada vez que lo usás, te devuelve uno nuevo.

Guardá estos tres valores (Client ID, Client Secret y Refresh token) en un lugar seguro — son los que va a necesitar tu servidor MCP para operar sin que tengas que reautenticarte cada seis horas.

4. Elegí y configurá tu servidor MCP

Acá tenés dos variantes según cuánto control técnico quieras:

Opción simple (token directo): para pruebas rápidas, algunos servidores MCP de comunidad aceptan directamente un access token vigente como variable de entorno. Es la forma más rápida de probar la conexión, aunque vas a tener que actualizarlo cuando expire.

Opción recomendada (auto-renovación): configurás el servidor con Client ID, Client Secret y Refresh token, para que renueve el access token automáticamente sin intervención tuya. Es la opción sostenible si vas a usar la conexión todos los días.

5. Agregá el servidor a la configuración de Claude Desktop

En el archivo de configuración de servidores MCP de Claude Desktop, agregás un bloque como este (los nombres de variables cambian según el servidor MCP que elijas, pero la lógica es la misma):

json

{ "mcpServers": { "mercadolibre": { "command": "npx", "args": ["-y", "<paquete-del-servidor-mcp>"], "env": { "ML_CLIENT_ID": "TU_CLIENT_ID", "ML_CLIENT_SECRET": "TU_CLIENT_SECRET", "ML_REFRESH_TOKEN": "TU_REFRESH_TOKEN", "ML_SITE_ID": "MLA" } } } }

ML_SITE_ID identifica el país de tu cuenta (MLA Argentina, MLB Brasil, MLM México, MCO Colombia, MLC Chile, MLU Uruguay). Guardás el archivo y reiniciás Claude Desktop.

6. Probá la conexión

Si todo quedó bien configurado, Claude va a listar las herramientas de Mercado Libre disponibles al iniciar una conversación nueva. Probá algo simple primero, como pedirle que liste tus publicaciones activas o tus últimas órdenes, antes de pasar a preguntas más complejas de rentabilidad.

Prompts de ejemplo para arrancar

• "Mostrame las ventas de los últimos 7 días y calculá la ganancia neta después de comisión de Mercado Libre y costo de envío."

• "¿Qué publicaciones tienen menos de 5 unidades de stock y más de 10 ventas en el último mes?"

• "Listame las preguntas sin responder de las últimas 24 horas."

• "Compará el precio de mi publicación [ID] contra las tres primeras de la categoría."

Errores comunes (y cómo evitarlos)

• Token expirado: el access token de Mercado Libre vence en horas, no en días. Si no configuraste la renovación automática con el refresh token, vas a tener que regenerarlo manualmente cada vez.

• Client Secret expuesto: nunca lo pegues en un chat, repositorio público o documento compartido. Tratalo como una contraseña.

• Permisos insuficientes: si tu aplicación no pidió los scopes necesarios al momento de autorizar, algunas herramientas (por ejemplo, modificar precio o stock) van a fallar aunque la conexión esté activa.

• Formato de header incorrecto: si armás la conexión a mano, el error más común es un Authorization: Bearer mal formado, con espacios de más o el token incompleto.

Una aclaración importante sobre escritura (precios, stock, respuestas)

Cualquier servidor MCP que te permita modificar precios, stock o responder preguntas automáticamente desde Claude está operando directamente sobre tu cuenta real. Antes de automatizar acciones de escritura, probá siempre en modo lectura primero y revisá los cambios que Claude propone antes de confirmarlos — la ventaja de conversar con tus datos no debería costarte el control sobre tu operación.

¿Vale la pena para tu operación?

Si vendés unas pocas unidades por semana, probablemente te alcance con el panel de Mercado Libre. Pero si manejás varias publicaciones, distintas categorías o estás mirando expandirte a otros países de la región, tener a Claude conectado por MCP te ahorra el tiempo que hoy perdés cruzando reportes a mano — y te deja ver de un vistazo lo que las comisiones y los impuestos esconden en tu rentabilidad real.

En MKT4E trabajamos todos los días con vendedores de Mercado Libre en gestión de Mercado Ads, performance y análisis de rentabilidad, y venimos incorporando IA aplicada a e-commerce en herramientas propias de reporting y diagnóstico. Si querés que te ayudemos a conectar y automatizar esto para tu cuenta —o directamente que te armemos el análisis sin que tengas que tocar una línea de configuración— escribinos y lo vemos juntos.

Certificaciones

Estamos aquí para ayudarte con tus necesidades.

Contacto

Suscribite a nuestras noticias

hola@mkt4e.com.ar

+54 11 2561 7515

© 2026. All rights reserved.

Alianza Estrategica en España con