Mercado Pago su MCP: pagamenti, commissioni e report di riconciliazione in qualsiasi agente AI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Mercado Pago, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Mercado Pago

Account venditore Mercado Pago (Argentina, Brasile, Messico, Cile, Colombia, Perù, Uruguay): pagamenti con commissioni, importi netti e date di accredito, merchant order, abbonamenti, metodi di pagamento e i report del denaro liberato e del saldo del conto per la riconciliazione (genera, elenca, scarica). Non muove denaro.

Setup

La configurazione richiede circa 3 minuti. Ti servono l'account Mercado Pago di cui vuoi i dati e un'applicazione nel pannello sviluppatori di Mercado Pago (il nome non conta).

1. Accedi a https://www.mercadopago.com/developers/panel/app con quell'account, apri Your integrations e crea un'applicazione se non ne hai una. Va bene qualsiasi nome, e come prodotto Checkout Pro o Payments.
2. Nell'applicazione apri Production credentials e attivale (accetta i termini).
3. Copia l'Access Token (inizia con APP_USR-) in MERCADO_PAGO_ACCESS_TOKEN, da solo, senza la parola Bearer, spazi o virgolette. Public Key, Client ID e Client Secret non servono.
4. Installa il connettore ed esegui mercado_pago_get_account: mostra l'account dietro il token e il suo sito nazionale (MLA Argentina, MLB Brasile, MLM Messico, MLC Cile, MCO Colombia, MPE Perù, MLU Uruguay).

Il token apre tutto l'account: tienilo segreto e, se finisce in mani sbagliate, reimpostalo nello stesso pannello e incolla quello nuovo. Le credenziali di test vedono solo dati di test, e i report degli account di test sono vuoti.

Cosa legge: l'account; i pagamenti degli ultimi 12 mesi con stato, importo lordo, netto incassato dopo le commissioni, dettaglio delle commissioni, metodo di pagamento e circuito della carta, rate, pagatore, riferimento esterno e data di accredito; ogni dettaglio di un pagamento, compresi rimborsi, articoli e spedizione; i merchant order degli ultimi 90 giorni (l'ordine dietro una vendita Checkout Pro o QR, con pagamenti e spedizioni); gli abbonamenti con stato, importo, frequenza e prossima data di pagamento; e i metodi di pagamento del paese dell'account con importo minimo e massimo e tempi di accredito.

Cercare i pagamenti: l'AI filtra per stato, per un intervallo di date su creazione, approvazione, ultimo aggiornamento o accredito del denaro, e per il tuo riferimento esterno. Riceve da 1 a 100 pagamenti per pagina, vede quanti corrispondono in totale e scorre il resto. Per un mese intero di contabilità i report sono lo strumento migliore.

Report per la riconciliazione: il report del denaro liberato (Dinero liberado / Dinheiro liberado: il denaro diventato disponibile, con ogni pagamento, commissione, rimborso e prelievo) e il report del saldo del conto (Dinero en cuenta, prima all transactions: ogni movimento del saldo). L'AI elenca prima i report già esistenti, compresi quelli programmati nel pannello di Mercado Pago. Se nessuno va bene, ne genera uno per il tuo periodo, aspetta che lo stato sia processed (un minuto o più) e lo scarica. I report CSV arrivano come testo separato da punto e virgola, con una riga di intestazione e le colonne impostate nel pannello; i report XLSX arrivano come file.

Importi e date: gli importi sono decimali nella valuta dell'account (ARS, BRL, MXN, CLP, COP, PEN o UYU). Le date dei pagamenti hanno il fuso orario dell'account, quelle dei report sono in UTC: la mezzanotte di Buenos Aires corrisponde alle 03:00 UTC.

Chiede prima di ogni modifica: mercado_pago_create_release_report e mercado_pago_create_settlement_report sono gli unici strumenti che scrivono. Creano un file di report sull'account e non muovono denaro. L'AI ti mostra tipo di report e periodo e aspetta il tuo sì. Tutto il resto legge soltanto.

Limiti: la ricerca dei pagamenti arriva a 12 mesi indietro, i merchant order a 90 giorni. Mercado Pago rifiuta una data di fine report nel futuro o oltre il proprio limite e indica l'ultima data consentita. Il testo dei report oltre 200 KB viene tagliato, quindi l'AI usa periodi più brevi. Dopo un 429 (local_rate_limited o too_many_requests) aspetta un minuto prima di riprovare.

Errori comuni: 401 indica un token sbagliato, reimpostato o di test. 403 indica che l'applicazione del token non ha accesso a quella risorsa. 404 su un pagamento significa che appartiene a un altro account.

Il connettore non muove denaro: non rimborsa, non effettua prelievi né addebiti e non crea preferenze di pagamento o link di pagamento.

Prerequisiti: MERCADO_PAGO_ACCESS_TOKEN

Installazione locale del connettore

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

Apri http://localhost:3000/connectors/store, scegli Mercado Pago e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Quanto abbiamo incassato con Mercado Pago la settimana scorsa, e quanto è rimasto dopo le commissioni?"
• "Trova il pagamento con riferimento esterno ORDER-1042 e dimmi se è stato rimborsato."
• "Quali pagamenti verranno accreditati sul mio saldo nei prossimi 7 giorni, e per quale totale?"
• "Genera il report del denaro liberato di settembre e somma commissioni e rimborsi. Chiedimi conferma prima di crearlo."
• "Quali dei nostri abbonamenti sono in pausa o cancellati, e quanto pagava ciascuno al mese?"

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT