Mercado Pago Commerce Agents Checkout es una biblioteca open source en Python, disponible en beta, que implementa un checkout_handoff seguro en tu integración. Con ella, puedes activar Checkout Pro directamente en el flujo del agente sin transferir al modelo el control sobre los precios, las credenciales ni la creación del pago.

Si ya exploras agentes de compra con el stack open source commerce-agents, de Anthropic, la biblioteca incorpora el checkout de Mercado Pago al flujo existente. También puede integrarse en otros backends de agentes desarrollados en Python mediante adaptadores para el carrito, el catálogo y la persistencia de intentos de checkout.

La biblioteca usa el SDK oficial de Mercado Pago y la API de Orders para preparar el checkout en el backend de tu integración. Antes de crear una order, consulta el catálogo confiable de la aplicación y valida los datos necesarios para el pago.

1. Valida el carrito con tu catálogo: antes de crear una order, verifica ítems, precios, disponibilidad y moneda utilizando la información confiable de tu aplicación.
2. Crea una order para Checkout Pro: después de la validación, crea la order que prepara el pago en el checkout hospedado de Mercado Pago.
3. Devuelve una URL de pago validada: envía al host la URL de Checkout Pro solamente después de verificar que pertenece a los dominios permitidos de Mercado Pago.
4. Mantiene las credenciales y los valores en el backend: el Access Token, los precios y la URL de pago no pasan por el contexto del modelo.

Activar checkout_handoff no confirma el pago. Sigues siendo responsable de persistir idempotency_key y external_reference, tratar estados indeterminados, procesar webhooks y reconciliar las Orders antes de liberar la compra.

La versión beta 0.1.0 está disponible en PyPI y requiere Python 3.11 o superior, además del SDK mercadopago 3.5.0 o superior.

Si prefieres realizar la integración manualmente, instala el paquete:

bash
Copiar
pip install mercadopago-commerce-agents-checkout==0.1.0

Consulta el repositorio oficial de Commerce Agents Checkout para conocer sus requisitos, revisar ejemplos de implementación y enviar feedback.

El plugin mercadopago-commerce analiza tu proyecto y te guía para incorporar Commerce Agents Checkout en el lugar adecuado. No depende de un framework, una estructura de repositorio ni un vertical comercial específico.

El análisis comienza en modo de solo lectura y presenta un plan antes de modificar el proyecto.

1. Descubre los límites reales de la integración: identifica el carrito, el catálogo confiable, el punto de inicio del checkout y el canal utilizado para entregar la URL fuera del contexto del modelo.
2. Detecta cómo administra dependencias el proyecto: reconoce configuraciones basadas en uv, Poetry, Pipenv, pyproject.toml o requirements.txt.
3. Usa una versión validada de la biblioteca: agrega la versión exacta compatible y genera un adaptador pequeño sobre la arquitectura existente.
4. Detecta requisitos pendientes: si no encuentra persistencia durable, webhooks, reconciliación o un límite seguro para entregar la URL, los reporta como bloqueos en lugar de inventar una implementación.

La integración automática está disponible para backends de agentes desarrollados en Python 3.11 o superior. Si el proyecto usa otra tecnología, el plugin no modifica el código: presenta el contrato oficial de la API de Orders y las consideraciones de seguridad necesarias para realizar una integración manual.

Para instalar el plugin público con Claude Code:

bash
Copiar
claude plugin marketplace add \
  https://github.com/mercadopago/mercadopago-claude-marketplace.git \
  --scope project


claude plugin install \
  mercadopago-commerce@mercadopago-claude-marketplace \
  --scope project

Desde la raíz del proyecto que quieres analizar, ejecuta:

text
Copiar
/mercadopago-commerce:mp-commerce analyze

El plugin mostrará el diagnóstico y el plan de integración. No realizará cambios hasta que confirmes explícitamente el plan propuesto.

También puedes explorar el plugin mercadopago-commerce para Claude Code y el proyecto open source commerce-agents de Anthropic.