mcpField
M
mcp-tienda-nube

mcp-tienda-nube

本地服务
github.com/codespar商业与营销2754 周前更新
代码仓库

关于 mcp-tienda-nube

mcp-tienda-nube 是 Tienda Nube（Nuvemshop）的 MCP 服务，Tienda Nube 是拉丁美洲的电商平台。它通过 MCP 客户端管理店铺的商品、订单、客户、分类、优惠券和 webhook。

主要功能

  1. 01商品与变体的查询、创建和更新
  2. 02订单查询、状态更新、关闭与取消
  3. 03客户与分类管理
  4. 04优惠券与废弃购物车查询
  5. 05Webhook 订阅管理
  6. 06通过环境变量配置访问令牌与店铺 ID

适用场景

  1. 01让 AI 助手查询订单并更新发货状态
  2. 02批量调整商品价格与库存
  3. 03查看废弃购物车以跟进客户

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 24 个工具，用于读写 Tienda Nube 店铺数据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-tienda-nube": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-tienda-nube"
      ],
      "env": {
        "TIENDANUBE_ACCESS_TOKEN": "<TIENDANUBE_ACCESS_TOKEN>",
        "TIENDANUBE_STORE_ID": "<TIENDANUBE_STORE_ID>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-tienda-nube
需要配置的环境变量
TIENDANUBE_ACCESS_TOKEN密钥Access token for Tienda Nube
TIENDANUBE_STORE_IDStore identifier

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-tienda-nube0.2.2

工具

24

收录的工具列表 · 更新于 2 周前

参数类型必填说明
pagenumber否页码
per_pagenumber否每页结果数（最多 200）
since_idnumber否筛选此 ID 之后的商品
created_at_maxstring否最晚创建日期（ISO 8601）
created_at_minstring否最早创建日期（ISO 8601）

详细介绍

MCP Tienda Nube

适用于 Tienda Nube（Nuvemshop）的 MCP 服务——拉丁美洲领先的电商平台，创立于阿根廷，相当于面向拉丁美洲的 Shopify。

快速开始

# Set your credentials
export TIENDANUBE_ACCESS_TOKEN="your-access-token"
export TIENDANUBE_STORE_ID="your-store-id"

# Run via stdio
npx tsx packages/argentina/tienda-nube/src/index.ts

# Run via HTTP
npx tsx packages/argentina/tienda-nube/src/index.ts --http

环境变量

变量必填描述
TIENDANUBE_ACCESS_TOKEN是Tienda Nube 的访问令牌
TIENDANUBE_STORE_ID是商店标识符
MCP_HTTP否设置为 "true" 以启用 HTTP 传输
MCP_PORT否HTTP 端口（默认：3000）

工具（24 个）

工具用途
list_products列出商店中的商品
get_product按 ID 获取商品详情
create_product创建新商品
update_product更新现有商品
list_orders列出订单
get_order按 ID 获取订单详情
list_customers列出客户
get_customer按 ID 获取客户详情
list_categories列出商品类别
update_order_status更新订单履行／配送状态
delete_product按 ID 删除商品
list_product_variants列出商品的变体
update_product_variant更新商品变体（价格、库存、sku、重量）
close_order关闭订单（标记为已履行／已关闭）
cancel_order取消订单，可选择补回库存并退款
create_category创建商品类别
update_category更新商品类别
delete_category按 ID 删除商品类别
list_webhooks列出已配置的 Webhook
create_webhook订阅 Webhook 事件
delete_webhook按 ID 删除 Webhook
list_discount_coupons列出折扣券
create_discount_coupon创建折扣券
list_abandoned_carts列出已放弃的结账

身份验证

使用 Bearer token 身份验证。通过 Tienda Nube Partners OAuth 流程获取访问令牌。商店 ID 包含在 API 基础 URL 中。

API 参考

企业版

需要对 Agent 付款进行治理、设置预算限额并保留审计记录？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、付款路由和合规模板。

身份验证

启动服务前，请设置以下环境变量：

  • TIENDANUBE_ACCESS_TOKEN （必填，机密） — Tienda Nube 的访问令牌
  • TIENDANUBE_STORE_ID （必填） — 商店标识符

请在服务提供商的开发者门户中申请凭据：https://tiendanube.github.io。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。