Mercado Libre MCP Server 是 Mercado Libre 提供的开发者工具，基于模型上下文协议（MCP）。MCP 是一种开放协议，用于标准化人工智能模型与不同数据源和工具之间的连接。该服务器为开发者提供实用工具，使其能够使用自然语言轻松与 Mercado Libre API 和资源交互，从而简化任务和产品集成。
主要能力方面，Mercado Libre MCP Server 暴露了用于促进集成和查询相关信息的工具，具体包括：search_documentation，用于在 Mercado Libre 开发者技术文档中搜索特定术语或关键概念，其参数包括 query（在文档中搜索的关键词，必需）、language（要查询的文档语言，如 en_us、es_ar、pt_br，必需）、siteId（用于过滤结果的国家/地区 ID，如 MLA、MLB、MLM 等，可选）、limit（返回结果的最大数量，可选）、offset（跳过的结果数量，可选）；get_documentation_page，用于检索特定文档页面的完整内容，便于访问详细规范或用例，其参数包括 path（要检索的页面路径，必需）。
使用方式上，这些工具并非由用户或开发者直接使用，而是由 Agentic IDE 调用。例如，search_documentation 工具允许 Agentic IDE 搜索所有官方 Mercado Libre 文档中的关键术语，并为查询上下文检索最相关的端点或路由；随后通过 get_documentation_page 工具，Agentic IDE 可访问上一步识别出的路由的完整内容，从而直接从文档中获取具体信息和具体用例。这样，IDE 可自动完成文档的查询与导航，让开发者无需手动搜索即可获得上下文相关且精确的答案。
除查询文档外，MCP 工具还被 Agentic IDE 用于生成代码并协助项目中的产品集成。例如，可以要求助手查看想要集成的产品的文档，并确定完成集成所需的步骤。MCP Server 提供相关上下文（包括代码示例和技术文档），Agentic IDE 据此建议甚至直接对项目应用所需的更改。这样，IDE 自动完成集成的查询、分析和实施，简化开发者的工作并加速开发过程。开发者还可以请求针对特定集成的实现建议。
安装与配置方面，文档提供了连接至不同客户端的说明。从 Claude 连接 Mercado Libre DevSite MCP 时可运行相应命令；也可在本地或项目配置文件中手动配置，添加指定 JSON 块。从 Codex 连接时，在全局或项目 config.toml 文件中添加指定块。从 Cursor 连接时，可点击按钮或手动操作，在配置中查看和配置可用的 MCP 服务器，并包含指定 JSON 块以连接 MCP 服务器。从 Windsurf 连接时按相应步骤操作。从 Gemini 连接时，在全局或项目 settings.json 文件中添加指定块。此外，可打开 IDE 设置，查找与 MCP 服务器相关的 JSON 文件。
连接 MCP 服务器时，需从首选客户端（例如 Cursor）建立远程连接。首次连接时，OAuth 认证流程会在浏览器中自动打开，使用 Mercado Libre 账户登录并授权访问。随后确保 MCP 服务器在客户端中可用且配置正确；如果未出现，请检查配置并重新加载 MCP 服务器列表。
认证与授权采用 OAuth 2.0，符合行业标准，消除了手动管理 Access Tokens 的需要。使用前需确保已满足前置条件。
错误与解决方案方面，若连接时应用无限期停留在“Loading Tools”状态或无法建立与服务器的连接，可能是认证流程出现问题。可能原因包括：OAuth 流程未正确完成（在授权前关闭了浏览器窗口）、会话凭证已过期、MCP 客户端不支持所需的 OAuth 流程（需确保使用更新版本的客户端）、MCP 服务器 URL 配置错误。建议解决方案包括：断开并重新连接 MCP 服务器以重启认证流程；确保在关闭窗口前完成浏览器中的授权流程；验证配置的 URL 正好为 https://mcp.mercadolibre.com/devsite/v1/mcp；将 MCP 客户端更新至最新可用版本。
其他信息：Mercado Libre 使用 cookie 改善用户体验，更多内容可查阅其隐私中心。其余细节暂未提供。
