software

Antigravity/Cursor에서 MercadoLibre MCP 연결 방법: 놓친 가이드

발행: (2026년 2월 7일 오전 08:37 GMT+9)
4 분 소요
원문: Dev.to

Source: Dev.to

Introduction

만약 Antigravity(또는 Cursor)를 AI‑네이티브 IDE로 사용하고 있다면, 공식 MercadoLibre 개발자 문서가 아직 이 도구들을 지원하지 않는다는 점을 눈치채셨을 겁니다. MercadoLibre용 Model Context Protocol(MCP)을 설정하는 과정은 특정 포트 요구사항과 OAuth 흐름 때문에 까다로울 수 있습니다. 긴 트러블슈팅을 거친 뒤, Antigravity 사용자를 위한 최종 가이드를 정리했습니다.

The most common issue

브라우저에서 인증을 진행하면 종종 다음과 같은 메시지가 표시됩니다:

“La aplicación no está preparada para conectarse a Mercado Libre”

공식 MercadoLibre MCP 프록시 앱은 리다이렉트를 http://localhost:18999 로 엄격히 기대합니다. 그러나 Antigravity와 같은 IDE에서 사용하는 mcp-remote 클라이언트는 별도로 지정하지 않으면 무작위 포트(예: 17135)를 선택합니다.

Update mcp_config.json

%APPDATA%\.gemini\antigravity\에 위치한 mcp_config.json 파일에 18999를 위치 인수로 추가하세요:

{
  "mercadolibre": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://mcp.mercadolibre.com/mcp",
      "18999"
    ]
  }
}

Warning
mcp_config.json에서 다음 라인을 제거하세요:

"--header",
"Authorization: Bearer APP_USR-..."

브라우저를 통해 로그인하려 할 때 이 라인들을 남겨두면 “Existing OAuth client information is required” 라는 인증 교환 오류가 발생합니다.

Resolve “address already in use 127.0.0.1:18999”

이 오류가 나타난다면 이전(실패한) 시도 때문에 “좀비” 프로세스가 남아 있는 것입니다.

Kill Node.js zombie processes

taskkill /F /IM node.exe

Clear the corrupt auth cache

rmdir /S /Q %USERPROFILE%\.mcp-auth

Browser specifics

기본 브라우저가 Firefox이고 “Authorization Successful” 페이지가 IDE와 통신하지 않는 것처럼 보인다면, 콜백 링크를 Chrome에 복사·붙여넣기 하세요. Chrome은 개발 도구용 로컬 콜백을 더 안정적으로 처리하는 경우가 많습니다.

Beat the timeout

Antigravity에는 내장된 타임아웃이 있습니다. 브라우저가 열리면 인증을 신속히 완료하세요. 실패하면 “context deadline exceeded” 오류가 표시됩니다.

Ngrok is not required

이 설정에 Ngrok은 필요하지 않습니다. MercadoLibre MCP 프록시 자체가 localhost:18999와 통신할 권한을 이미 가지고 있는 공식 앱입니다.

Summary checklist

  • mcp_config.json에서 포트 18999를 강제 지정.
  • 모든 수동 Authorization 헤더를 제거.
  • 좀비 Node.js 프로세스를 정리.
  • 손상된 인증 캐시(.mcp-auth)를 삭제.
  • 기본 브라우저가 실패할 경우 OAuth 콜백을 Chrome에서 수행.

Happy AI‑coding! 🚀

Back to Blog

관련 글

더 보기 »