1. MCP Server de Mercado Libre

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 AccessToken"
      }
    }
  }
}

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 AccessToken"
      }
    }
  }
}

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.

search_documentation

Habilita a busca de termos específicos ou conceitos-chave em toda a documentação técnica para desenvolvedores do Mercado Livre.

• query: Palavras-chave que se deseja buscar na documentação (Obrigatório)
• language: Idioma da documentação a ser consultada (ex: en_us, es_ar, pt_br) (Obrigatório)
• siteId: ID do país para filtrar resultados (ex: MLA, MLB, MLM, etc) (Opcional)
• limit: Máximo de resultados a retornar (Opcional)
• offset: Número de resultados a omitir (Opcional)

get_documentation_page

Obtém o conteúdo completo de uma página específica da documentação, útil para acessar especificações ou casos de uso detalhados.

• path: Caminho da página a ser obtida (Obrigatório)
• language: Idioma da documentação a ser consultada (ex: en_us, es_ar, pt_br) (Obrigatório)
• siteId: ID do país para filtrar resultados (ex: MLA, MLB, MLM, etc) (Opcional)

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

Las herramientas (tools) no son utilizadas directamente por el usuario o desarrollador, sino por el IDE Agéntico. Por ejemplo:

La herramienta search_documentation permite al IDE Agéntico buscar términos clave dentro de toda la documentación oficial de Mercado Libre y recuperar los endpoints o rutas más relevantes para el contexto consultado.

Luego, con la herramienta get_documentation_page, el IDE Agéntico accede al contenido completo de las rutas identificadas en el paso anterior, permitiendo así obtener información específica y casos de uso concretos directamente desde la documentación.

De esta manera, el IDE automatiza la consulta y navegación por la documentación, facilitando que el desarrollador recibe respuestas contextualizadas y precisas sin tener que buscar manualmente.

6.2 Generar código de integración

Además de consultar la documentación, las tools del MCP son utilizadas por el IDE Agéntico para generar código y asistir en la integración de productos en tus proyectos.

Por ejemplo, podés solicitar al asistente que revise la documentación del producto que desees integrar y que identifique los pasos necesarios para completar la integración. El MCP Server provee el contexto relevante (incluyendo ejemplos de código y documentación técnica), que el IDE Agéntico usa para sugerir o incluso aplicar directamente las modificaciones requeridas en tu proyecto.

De esta forma, el IDE automatiza la consulta, el análisis y la implementación de integraciones, facilitando el trabajo del desarrollador y acelerando el proceso de desarrollo.

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

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.