1. Model Context Protocol (MCP)

El Model Context Protocol (MCP) es un protocolo abierto que estandariza la conexión de modelos de inteligencia artificial con diferentes fuentes de datos y herramientas. En este contexto, el MCP Server de Mercado Libre ofrece utilidades para que los desarrolladores puedan interactuar fácilmente con APIs y recursos de Mercado Libre usando lenguaje natural, simplificando tareas e integraciones de productos.

2. Requisitos previos

Antes de comenzar, asegúrate de contar con el siguiente entorno:

3. Instalación y configuración

3.1 Cursor

Para conectarse a nuestro MCP de Mercado Libre, primero es necesario realizar la conexión con el cliente que mejor se ajuste a tu integración. Verifica el paso a paso según el tipo de cliente.

En Cursor, puede hacer clic en el botón a continuación o seguir los pasos manualmente.

Para conectarse al servidor MCP de Mercado Libre desde Cursor de forma manual, seguí estos pasos:

Cursor Settings > Tools & Integrations > New MCP Server

Esto abrirá una pestaña donde podrás visualizar y configurar los servidores MCP disponibles.
En la configuración, asegúrate de incluir el siguiente bloque JSON para conectar con el servidor MC

JSON:

{
  "mcpServers": {
    "mercadolibre-mcp-server": {
      "url": "https://mcp.mercadolibre.com/mcp",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

3.2 Otros IDE's

Abre la configuración del IDE y busca el archivo JSON referente a servidores MCP.
Después, completa los campos de “Authorization” con tu Access Token.

JSON:

{
  "mcpServers": {
    "mercadolibre-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mercadolibre.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer "
      }
    }
  }
}

4. Conexión al MCP Server

1. Establece la conexión remota desde tu cliente preferido (ejemplo: Cursor).
2. Asegúrate de que el servidor MCP esté disponible y correctamente configurado en tu cliente.
3. Si no aparece, revisa la configuración y recarga la lista de servidores MCP.

5. Herramientas disponibles

El MCP Server de Mercado Libre expone herramientas para facilitar la integración y consulta de información relevante.

6. Casos de uso

MCP Server garantiza que actividades comunes de desarrolladores sean optimizadas de manera fácil y rápida. A continuación, conoce algunos casos de uso para implementar en tu integración.

6.1 Buscar en documentación desde tu IDE

La herramienta search_documentation ejecuta búsquedas de términos clave en toda la documentación oficial de Mercado Libre desde tu entorno, devolviendo los endpoints o rutas más relevantes según el contexto.
Ya con las rutas más relevantes accede a la herramienta de get_documentation_page en donde obtiene el contenido de las rutas antes identificadas y obtiene el contenido de la documentación permitiendo así obtener respuestas específicas con casos de uso.

Ejemplo de prompt:

Buscar en la documentación de Mercado Libre cómo recibir notificaciones de productos.

6.2 Generar código de integración

Además de consultar la documentación, las tools del MCP, también te permite generar código para tus proyectos.
Podés pedirle al asistente que revise la documentación del producto que querés integrar y te indique los pasos necesarios para completar la integración. El MCP Server provee el contexto relevante incluyendo código y documentación que permite al IDE sugerir o aplicar directamente las modificaciones requeridas en tu proyecto.

Puedes solicitar recomendaciones para implementar integraciones específicas, por ejemplo:

Usando el MCP Server de Mercado Libre configurado en Cursor, generá un webhook en Node.js que reciba notificaciones de Mercado Libre, consultando la documentación oficial de notificaciones a través del MCP.

7. Errores y soluciones

7.1 Token inválido o ausente

Si al intentar conectarte, la aplicación queda en estado "Loading Tools" indefinidamente o no logra establecer conexión con el servidor, es posible que haya un problema con el token de autenticación.

Posibles causas:

• No se ha proporcionado un token de autenticación en la solicitud.
• El token proporcionado ha expirado o es incorrecto.
• El formato del token es inválido (por ejemplo, caracteres faltantes o mal copiados).
• El token no tiene los permisos necesarios para acceder al recurso solicitado.

Soluciones sugeridas:

• Verifica que el token esté presente en la cabecera de la solicitud (en Authorization: Bearer <AccessToken>).
• Asegúrate de que el token no haya expirado. Si es así, solicita uno nuevo.
• Copia el token completo, sin espacios adicionales ni caracteres faltantes.