Certifique-se de que seu dispositivo está conectado à internet e que não há bloqueios impedindo o acesso ao endpoint do MCP Server (https://mcp.mercadopago.com/mcp).

Para acessar o MCP Server, você precisa de uma credencial válida. Chame uma de nossas APIs públicas para verificar sua credencial, por exemplo a/v1/payment_methodsAPI.

Veja como funciona na prática:

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

O resultado esperado é:

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"
  }
]

Se receber uma resposta diferente, suas credenciais podem não ser válidas. Caso tenha de obter uma nova chave, siga nossa documentação de credenciais.

Para a maioria dos clientes MCP, como Cursor, Claude e Windsurf, é necessário usar a versão Node.js 20 ou acima. Para verificar qual sua versão atual do Node.js, execute:

bash
Copiar
node -v

O resultado irá exibir a versão padrão do Node.js e o esperado é que seja a versão 20 ou superior. Caso utilize NVM (Node Version Manager), execute os seguintes comandos para verificar as versões instaladas e, se necessário, instalar uma nova:

bash
Copiar
# Listar versões instaladas do Node.js
nvm list

# Instalar Node.js 20
nvm install 20

# Desinstalar uma versão específica (substitua XX pelo número da versão)
nvm uninstall XX

NPX é uma ferramenta executora de pacotes incluída no NPM (Node Package Manager) e que é usada para se conectar ao MCP Server do Mercado Pago.

Para verificar se o NPX já está instalado, execute:

bash
Copiar
npx --version

Se aparecer um número de versão, significa que o pacote está instalado. No caso de receber um erro "command not found", instale ou atualize o NPM, o que inclui também o NPX.

O pacote de NPX está incluído no NPM versão 5.2.0 e superior. Execute o comando a seguir para instalar ou atualizar ambos os pacotes (NPM e NPX):

bash
Copiar
npm install -g npm

Após a atualização, verifique a instalação:

bash
Copiar
npx --version

Se os problemas persistirem, certifique-se de que suas instalações do Node.js e NPM estão atualizadas. Em seguida, verifique sua versão do NPM com o comando:

bash
Copiar
npm -v

Para mais informações, consulte a documentação do NPX.

Se os problemas para se conectar persistirem, tente realizar a conexão ao MCP Server através do terminal com o comando:

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

A resposta deve ser como o exemplo a seguir:

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

Os erros comuns nesta etapa são: