Asegúrate de que tu dispositivo esté conectado a internet y que no haya bloqueos que impidan el acceso al endpoint del MCP Server (https://mcp.mercadopago.com/mcp).

Para acceder al MCP Server, necesitas una credencial válida. Llama a una de nuestras APIs públicas para verificar tu credencial, por ejemplo la/v1/payment_methodsAPI.

Mira cómo funciona en la práctica:

bash
Copiar
curl -X GET "https://api.mercadopago.com/v1/payment_methods" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

El resultado esperado es:

json
Copiar
[
  {
    "id": "visa",
    "name": "Visa",
    "payment_type_id": "credit_card",
    "status": "active",
    "secure_thumbnail": "https://www.mercadopago.com/org-img/MP3/API/logos/visa.gif",
    "thumbnail": "http://img.mlstatic.com/org-img/MP3/API/logos/visa.gif",
    "deferred_capture": "supported",
    "settings": {
      "card_number": {
        "length": 16,
        "validation": "standard"
      },
      "security_code": {
        "mode": "mandatory",
        "length": 3,
        "card_location": "back"
      }
    },
    "additional_info_needed": [
      {}
    ],
    "min_allowed_amount": 0.5,
    "max_allowed_amount": 60000,
    "accreditation_time": 2880,
    "financial_institutions": {},
    "processing_modes": "aggregator"
  }
]

Si recibes una respuesta diferente, tus credenciales pueden no ser válidas. En caso de que necesites obtener una nueva clave, sigue nuestra documentación de credenciales.

Para la mayoría de los clientes MCP, como Cursor, Claude y Windsurf, es necesario usar Node.js versión 20 o superior. Para verificar cuál es tu versión actual de Node.js, ejecuta:

bash
Copiar
node -v

El resultado mostrará la versión predeterminada de Node.js y lo esperado es que sea la versión 20 o superior. Si usas NVM (Node Version Manager), ejecuta los siguientes comandos para verificar las versiones instaladas y, si es necesario, instalar una nueva:

bash
Copiar
# Listar versiones instaladas de Node.js
nvm list

# Instalar Node.js 20
nvm install 20

# Desinstalar una versión específica (reemplaza XX por el número de versión)
nvm uninstall XX

NPX es una herramienta ejecutora de paquetes incluida en NPM (Node Package Manager) que se usa para conectarse al MCP Server de Mercado Pago.

Para verificar si NPX ya está instalado, ejecuta:

bash
Copiar
npx --version

Si aparece un número de versión, significa que el paquete está instalado. En caso de recibir un error "command not found", instala o actualiza NPM, lo que incluye también NPX.

El paquete de NPX está incluido en NPM versión 5.2.0 y superior. Ejecuta el siguiente comando para instalar o actualizar ambos paquetes (NPM y NPX):

bash
Copiar
npm install -g npm

Después de la actualización, verifica la instalación:

bash
Copiar
npx --version

Si los problemas persisten, asegúrate de que tus instalaciones de Node.js y NPM estén actualizadas. Luego, verifica tu versión de NPM con el comando:

bash
Copiar
npm -v

Para más información, consulta la documentación de NPX.

Para conectarse exitosamente con nuestro MCP Server, es importante contar siempre con la última versión disponible del cliente que estás utilizando.

Para verificar esto y, de ser necesario, realizar una actualización, consulta el paso a paso según tu cliente de preferencia.

Si los problemas para conectarte persisten, prueba realizar la conexión al MCP Server a través del terminal con el comando:

bash
Copiar
npx -y mcp-remote@latest https://mcp.mercadopago.com/mcp --header 'Authorization:Bearer <ACCESS_TOKEN>'

La respuesta debería ser como el siguiente ejemplo:

text
Copiar
[22599] Using automatically selected callback port: 22476
[22599] Using custom headers: {"Authorization":"Bearer <ACCESS_TOKEN>"}
[22599] [22599] Connecting to remote server: https://mcp.mercadopago.com/mcp
[22599] Using transport strategy: http-first
[22599] Connected to remote server using StreamableHTTPClientTransport
[22599] Local STDIO server running
[22599] Proxy established successfully between local STDIO and remote StreamableHTTPClientTransport
[22599] Press Ctrl+C to exit

Los errores comunes en esta etapa son:

Si tienes inconvenientes para conectar nuestro MCP Server en Cursor o VS Code, intenta cambiando el modo de autenticación. Para eso, sigue los pasos indicados para el cliente que estés utilizando.

json
Copiar
{
  "mcpServers": {
    "mercadopago-mcp-server-prod": {
      "url": "https://mcp.mercadopago.com/mcp",
      "headers": {
        "Authorization": "Bearer <ACCESS_TOKEN>"
      }
    }
  }
}