Cómo conectar Mercado Pago a Microsoft Copilot vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Mercado Pago, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Mercado Pago + Microsoft Copilot

Cuenta de vendedor de Mercado Pago (Argentina, Brasil, México, Chile, Colombia, Perú, Uruguay): pagos con comisiones, montos netos y fechas de liberación, órdenes de compra (merchant orders), suscripciones, medios de pago y los reportes de dinero liberado y dinero en cuenta para conciliar (generar, listar, descargar). No mueve dinero.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

MERCADO_PAGO_ACCESS_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas la cuenta de Mercado Pago cuyos datos quieres y una aplicación en el panel de desarrolladores de Mercado Pago (el nombre da igual).

1. Inicia sesión en https://www.mercadopago.com/developers/panel/app con esa cuenta, abre Your integrations y crea una aplicación si no tienes ninguna. Sirve cualquier nombre, y como producto Checkout Pro o Payments.
2. En la aplicación, abre Production credentials y actívalas (acepta los términos).
3. Copia el Access Token (empieza por APP_USR-) en MERCADO_PAGO_ACCESS_TOKEN, solo, sin la palabra Bearer, espacios ni comillas. La Public Key, el Client ID y el Client Secret no hacen falta.
4. Instala el conector y ejecuta mercado_pago_get_account: muestra la cuenta detrás del token y su sitio de país (MLA Argentina, MLB Brasil, MLM México, MLC Chile, MCO Colombia, MPE Perú, MLU Uruguay).

El token abre toda la cuenta: guárdalo en secreto y, si se filtra, renuévalo en el mismo panel y pega el nuevo. Las credenciales de prueba solo ven datos de prueba, y los reportes de cuentas de prueba están vacíos.

Qué lee: la cuenta; los pagos de los últimos 12 meses con estado, monto bruto, neto recibido después de comisiones, detalle de comisiones, medio de pago y marca de tarjeta, cuotas, pagador, referencia externa y fecha de liberación del dinero; todo el detalle de un pago, incluidos reembolsos, ítems y envío; las merchant orders de los últimos 90 días (la orden detrás de una venta con Checkout Pro o QR, con sus pagos y envíos); las suscripciones con estado, monto, frecuencia y próxima fecha de cobro; y los medios de pago del país de la cuenta con monto mínimo y máximo y tiempo de acreditación.

Buscar pagos: la IA filtra por estado, por un rango de fechas sobre creación, aprobación, última actualización o liberación del dinero, y por tu referencia externa. Recibe de 1 a 100 pagos por página, ve cuántos coinciden en total y recorre el resto. Para un mes entero de contabilidad, los reportes son la mejor herramienta.

Reportes para conciliar: el reporte de Dinero liberado (Dinheiro liberado en Brasil: el dinero que quedó disponible, con cada pago, comisión, reembolso y retiro) y el reporte de Dinero en cuenta (antes all transactions: cada movimiento del saldo). La IA primero lista los reportes que ya existen, incluidos los programados en el panel de Mercado Pago. Si ninguno sirve, genera uno para tu período, espera a que su estado sea processed (un minuto o más) y lo descarga. Los reportes CSV llegan como texto separado por punto y coma, con una fila de encabezado y las columnas configuradas en el panel; los XLSX llegan como archivo.

Montos y fechas: los montos son decimales en la moneda de la cuenta (ARS, BRL, MXN, CLP, COP, PEN o UYU). Las fechas de los pagos llevan el huso horario de la cuenta, las de los reportes están en UTC: la medianoche en Buenos Aires son las 03:00 UTC.

Pregunta antes de cada cambio: mercado_pago_create_release_report y mercado_pago_create_settlement_report son las únicas herramientas que escriben. Crean un archivo de reporte en la cuenta y no mueven dinero. La IA te muestra el tipo de reporte y el período y espera tu sí. Todo lo demás solo lee.

Límites: la búsqueda de pagos llega a 12 meses atrás, las merchant orders a 90 días. Mercado Pago rechaza una fecha de fin de reporte en el futuro o más allá de su propio corte e indica la última fecha permitida. El texto de un reporte de más de 200 KB se corta, así que la IA usa períodos más cortos. Tras un 429 (local_rate_limited o too_many_requests) espera un minuto antes de reintentar.

Errores comunes: 401 indica un token incorrecto, renovado o de prueba. 403 indica que la aplicación del token no tiene acceso a ese recurso. 404 en un pago significa que pertenece a otra cuenta.

El conector no mueve dinero: no reembolsa, no retira ni cobra, y no crea preferencias de pago ni links de pago.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Mercado Pago.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuánto cobramos por Mercado Pago la semana pasada y cuánto nos quedó después de las comisiones?"
• "Busca el pago con referencia externa ORDER-1042 y dime si fue reembolsado."
• "¿Qué pagos se liberan en mi cuenta en los próximos 7 días y cuántos pesos suman en total?"
• "Genera el reporte de Dinero liberado de septiembre y suma las comisiones y los reembolsos. Pregúntame antes de crearlo."
• "¿Qué suscripciones están pausadas o canceladas y cuánto pagaba cada una por mes?"

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse