服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 官方已发布Developer Docs MCP,但当前仅限已批准的解决方案服务商;已批准卖家的开放时间仍未给出。
- 服务提供US和Global市场的API文档与模式,来源文档每日刷新;这不是所有站点、账户或接口都已开放的保证。
- 五个工具用于发现API规格、搜索操作与模式、筛选操作、查看操作规格和认证要求。
- 实际调用卖家API仍需有效凭证及活跃开发者或卖家账户;文档未说明MCP价格、调用额度或服务SLA。
已经发布,但不是所有卖家现在都能用
沃尔玛开发者门户在2026年10月14日的更新中列出“New: Walmart Developer Docs MCP server”,用于把AI编程助手连接到官方开发文档。操作指南进一步明确:目前仅向已批准的解决方案服务商开放,已批准卖家也将很快获得使用资格,但没有给出日期。
这里的解决方案服务商是帮助商家建设或运营API集成的服务方。即使已有卖家账户,也不能仅凭指南中的卖家操作示例认定当前已具备MCP接入资格。先确认自己的服务商审批状态,再决定是否安排团队接入。
US与Global说的是文档范围,连接入口另需认证
该MCP提供US和Global市场的权威开发文档。这个范围描述的是可查询的资料和API规格,不代表每个国家的商家、每种业务接口或所有账户同时获得权限。指南还提到加拿大、墨西哥和智利的市场专属API将逐步退役,并推荐Global API,但没有给出具体退役日期。
官方给出的远程HTTP服务地址是https://developer.walmart.com/mcp,指南包含VS Code、Cursor、Claude Code和Codex的配置方式。配置完成后,还需要在支持的客户端中连接服务,并通过外部沃尔玛登录页完成认证;仅填写地址并不代表账户已获准使用。
在VS Code中,工作区级配置文件是.vscode/mcp.json。按照官方示例,在servers下添加名为walmart-marketplace的项,将type设为http、url设为https://developer.walmart.com/mcp。也可从命令面板选择MCP: Add Server,填写同一地址并命名服务。随后再按客户端提示连接和认证,先核对配置的服务名称。
五个工具怎样帮助开发?先查规格,再看要求
list_marketplace_api_specs用于列出指定市场的API规格;search_marketplace_apis用于在某个规格中查找操作和模式。先找对市场与API集合,再搜索需要的对象或字段,能减少把另一市场的示例直接套进集成的风险。
list_api_operations可按方法、标签或市场条件筛选操作;get_operation_spec返回具体操作的参数、请求载荷和响应模式。它们适合回答“该用哪个操作”“这个字段是否必填”等开发问题,不能证明生成的业务请求一定会成功。
get_auth_requirements用于查询认证要求和安全方案,例如所需认证头、令牌端点和签名规格。它提供的是认证说明,不是替商家授权,也不会因为返回一份规格就自动生成有效凭证。
连接文档,不等于读订单或改库存
官方明确区分文档服务与实际API执行:MCP提供API文档和模式,要执行真实请求,仍需有效凭证,以及活跃的Marketplace开发者或卖家账户。商家的数据访问和写入权限,需要在相应的API授权流程中单独确认。
例如,让助手解释库存更新接口的参数,与允许某个程序更新店铺库存,是两件不同的操作。不能把文档问答成功、MCP登录成功,或一段看起来完整的代码,当成已获得订单读取、价格修改或库存写入权限的证明。
先用一个可核对的小问题,检查生成结果
可以先选择一个不涉及真实商家数据的问题,例如“这个市场的某项库存操作需要哪些参数和认证头?”再人工核对返回的操作规格、必填字段和认证要求。这个例子是接入后的使用思路,不是已执行的账户测试。
准备运行生成的代码时,按照实际业务权限审查请求,并先按官方建议使用独立沙箱凭证验证,再考虑生产请求。文档中的商品上架示例也提醒:PUBLISHED状态可能先于商品真正可见、可购买,还需要核对有效价格、可用库存及处理进度。
每日更新不等于运行保证,费用也不能猜
指南说来源文档每日刷新,这有助于助手取得较新的资料,但不是接口变化即时同步、客户端始终兼容或生成代码永远正确的承诺。出现认证或载荷错误时,仍需核对实际API响应、当前规格和账户权限。
这两份官方资料没有给出MCP价格、免费额度、调用上限或服务SLA,也没有承诺AI客户端订阅费用已包含在内。不要把公开文档、可配置的服务地址或已批准服务商资格理解成免费、无限量或无需授权的卖家API访问。
资料来源
常见问题
我是已批准的沃尔玛卖家,现在就能接入吗?
不能仅凭卖家身份认定。当前指南写的是已批准的解决方案服务商可用,已批准卖家将很快开放,但没有具体时间。应先确认当前账户资格;指南中的卖家用例不等于所有卖家已开放。
接入后,助手会自动读取订单或修改价格吗?
文档MCP提供的是规格、模式和认证要求。真实卖家API请求仍需有效凭证、活跃账户及相应授权;五个文档工具本身不等于订单读取或价格、库存写入权限。
官方没有列价格,是否可以当成免费使用?
不可以。所读公告和指南没有说明MCP费用、额度、调用上限或SLA,AI客户端的费用也需另外确认。缺少价格说明,不能推导出免费、无限量或卖家API费用减免。