# Mercado Libre setup for PopMCP You sign in with your Mercado Libre account's main user, pick your country on Mercado Libre's page and approve access. Until PopMCP's own app is switched on, you first create a free app in the Mercado Libre DevCenter, add PopMCP's redirect URI, and enter its Client ID and Client Secret in PopMCP. - Auth: OAuth authorization - Setup time: 5 min - API base URL: https://api.mercadolibre.com - Credentials screen: https://developers.mercadolibre.com.ar/devcenter - Provider docs: https://developers.mercadolibre.com.ar/en_us/authentication-and-authorization ## Before you begin - A Mercado Libre account you sell from, and its main user. A collaborator (operator) user cannot approve apps or create them. - In Argentina, Brazil, Mexico and Chile, the account's identity details filled in and validated: Mercado Libre asks for them before it lets you create an app. - PopMCP's redirect URI from the connect form: https://app.popmcp.com/api/providers/mercado-libre/callback ## Get your credentials ### 1. Open the DevCenter Go to developers.mercadolibre.com.ar/devcenter (use your own country's site if you prefer, such as developers.mercadolivre.com.br) and sign in with the account's main user. Click Create new application. The page may show this in Spanish or Portuguese as Crear nueva aplicación or Criar nova aplicação. Screen: https://developers.mercadolibre.com.ar/devcenter ### 2. Name the app and add the redirect URI Enter a Name, which must be unique on Mercado Libre, such as `PopMCP Tienda Norte`, a Description of up to 150 characters, and a Logo. Under Redirect URIs paste `https://app.popmcp.com/api/providers/mercado-libre/callback` exactly. Leave PKCE as it is: PopMCP works with it on or off. Screen: https://developers.mercadolibre.com.ar/devcenter ### 3. Turn on the scopes Under Scopes, tick Read, Write and offline access. Read is enough to look at things, Write lets PopMCP publish and change them when you allow it, and offline access keeps the connection working after the first six hours. Leave Topics and the notifications Callback URL empty: PopMCP does not need them. Click Save. Screen: https://developers.mercadolibre.com.ar/devcenter ### 4. Copy the Client ID and Client Secret Mercado Libre takes you back to My applications. Open your app's menu and click Configure. Copy the Client ID, which is all numbers, and the Client Secret. If you ever need a new secret, use Schedule renewal so the old one keeps working until you have updated PopMCP. Screen: https://developers.mercadolibre.com.ar/devcenter ### 5. Enter both in PopMCP and sign in Paste the numbers into Client ID and the secret into Client Secret, then click Sign in with Mercado Libre. On Mercado Libre's page, choose your country and click Confirm, sign in with the main user, and approve access. ## Fields PopMCP asks for - Client ID (clientId) [required]: Only needed to use your own app. Sign in with the account's main user at developers.mercadolibre.com.ar/devcenter and choose Create application (Argentina, Brazil, Mexico and Chile ask for your validated identity details first). Fill in the name and description, paste the redirect URI shown here, and under Scopes tick Read, Write and offline access. Save, then copy the Client ID and Client Secret from the app's Configure page. - Client Secret (clientSecret) [required]: On the app's Configure page in the DevCenter. Stored encrypted and used only on our server. ## Callback URL to register https://app.popmcp.com/api/providers/mercado-libre/callback ## Scopes requested - offline_access - read - write ## Verify PopMCP shows Mercado Libre as Connected under your nickname and site, such as TIENDA NORTE (MLA), and mercado_libre_get_account_overview returns your reputation, active listings and unanswered questions. ## Troubleshooting ### "Sorry, the application cannot connect to your account" Cause: The redirect URI on the app differs from PopMCP's by a character, you signed in with a collaborator, or the account has pending details or restrictions. Fix: Set **Redirect URIs** to `https://app.popmcp.com/api/providers/mercado-libre/callback` on the app, sign in with the account's main user, and check the account has no pending identity details in Mercado Libre. Then connect again. ### "That sign-in was a collaborator" Cause: Mercado Libre lets only an account's main user approve apps. Operators and collaborators get invalid_operator_user_id. Fix: Sign out of Mercado Libre, sign in with the main user, then connect again. ### "Mercado Libre did not accept the app's Client ID and Client Secret" Cause: One was mistyped, or the secret was renewed after you copied it. Fix: Copy both again from your app's **Configure** page in the DevCenter, then connect again. ### "Issued no refresh token" Cause: Offline access is not ticked on the app. Fix: Under **Scopes** on your app, tick **Offline access**, save, then connect again. ### Reads work but anything that changes something answers 403 Cause: **Write** is not ticked on your app, or the connection is read-only in PopMCP. Fix: Tick **Write** under **Scopes** and connect again, and allow write actions on the connection in PopMCP. ### A connection stops working after months of no use, or after a password change Cause: Mercado Libre ends a sign-in when the seller changes their password, removes the app or renews the secret at once, or after 4 months with no calls. Fix: Reconnect Mercado Libre from PopMCP to sign in again. ### Tools that start mercado_libre_gs_ answer 403 Cause: Those are for Global Selling (cross-border) sellers, and this account sells on one country's site. Fix: Use the same tool without gs_, such as mercado_libre_get_item. --- Source: https://www.docs.popmcp.com/docs/integrations/mercado-libre/