El Model Context Protocol (MCP) es un protocolo abierto que estandariza la conexión de modelos de inteligencia artificial (IA) con diferentes fuentes de datos y herramientas. En este contexto, el MCP Server de Mercado Pago ofrece herramientas para que los desarrolladores puedan interactuar fácilmente con nuestra API utilizando lenguaje natural, lo que simplifica las tareas y la integración de productos.

Antes de empezar a utilizar el servidor, confirma que tienes todo el entorno listo:

Para conectarse al MCP Server de Mercado Pago, primero es necesario realizar la conexión de forma remota con el cliente que mejor se ajuste a tu integración. Consulta a continuación el paso a paso según el tipo de cliente.

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

        

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

        

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

        

Para probar la integración, es necesario realizar una consulta con el asistente utilizando alguna de las tools disponibles.

Por ejemplo, si deseas probar la tool search_documentation, solo necesitas ejecutar el prompt indicando qué información deseas buscar:

          
Busca en la documentación de Mercado Pago cómo integrar Checkout Pro

        

Mercado Pago ofrece la siguiente lista de tools.

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

La tool search_documentation permite buscar información directamente en la documentación oficial de Mercado Pago.

Al usar el asistente y hacer una solicitud en lenguaje natural, es posible buscar información en la documentación y acceder a ella según cada etapa del desarrollo. Por ejemplo, consultar qué medios de pago están disponibles en un determinado país.

Además de consultar la documentación, la tool search_documentation también te permite generar código para tu proyecto.

Puedes solicitar esta recomendación al asistente pidiéndole que revise la documentación del producto que deseas integrar e indique los pasos necesarios para realizar esta integración. El MCP Server proporciona el contexto necesario, a través de código y documentación, para que el IDE realice las modificaciones necesarias en tu proyecto.

Para este caso de uso, consideremos una tienda que ya esté configurada y que solo necesite integrar un checkout para empezar a procesar pagos. En este sentido, un prompt de orientación para integrar con Checkout Pro podría ser:

plain
Copiar
Implementa la integración de Checkout Pro. 
Consulta la documentación del MCP server de Mercado Pago para cualquier detalle de implementación o incertidumbre.

Después de revisar el código de la aplicación existente, genera código productivo de la siguiente manera:

Frontend:
1- Reemplazar el botón de pago con la interfaz de checkout de Mercado Pago;
2- Integrar el formulario de pago;
3- Implementar flujos de éxito/fallo del lado del cliente.

Backend:
1- Configurar credenciales e integración de SDK en la versión más reciente;
2- Crear servicios de procesamiento de pagos;
3- Implementar el manejo de webhooks con validaciones.

Requisitos:
- Utilizar las mejores prácticas y validación de seguridad de Mercado Pago;
- Manejo de errores con códigos de estado;
- Casos de prueba para flujos críticos;
- Agregar documentación en el código;
- Verificar todos los pasos contra la documentación del MCP server de Mercado Pago.

El resultado puede variar según la configuración de tu proyecto, pero como regla general, el MCP Server de Mercado Pago sugerirá modificaciones de código en el frontend y backend de tu integración para crear el checkout.

Si quieres ver más detalles de este ejemplo práctico, accede a nuestro artículo en Medium sobre el caso de éxito para integrar Checkout Pro en 30 minutos.