mcpField
M
mcp-tienda-nube

mcp-tienda-nube

ローカル
github.com/codesparビジネス・マーケティング2754 週間前に更新
リポジトリ

mcp-tienda-nube について

mcp-tienda-nube は、ラテンアメリカ向け EC プラットフォームである Tienda Nube（Nuvemshop）の MCP サーバーです。MCP クライアントから、ストアの商品、注文、顧客、カテゴリ、クーポン、Webhook を操作できます。Tienda Nube のストアを扱う運営者や開発者を対象としています。

主な機能

  1. 01商品とバリエーションの参照・作成・更新
  2. 02注文の参照、ステータス更新、クローズ、キャンセル
  3. 03顧客とカテゴリの管理
  4. 04割引クーポンと放棄カートの一覧取得
  5. 05Webhook の購読管理
  6. 06アクセストークンとストア ID の環境変数による設定

活用シーン

  1. 01AI アシスタントによる注文確認と発送ステータスの更新
  2. 02商品価格と在庫数の一括調整
  3. 03放棄カートを確認し顧客へのフォローアップを行う

MCP 対応

本プロジェクトは MCP サーバーであり、Tienda Nube のストアデータを読み書きするための 24 個のツールを MCP クライアントに公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの 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いいえ1 ページあたりの結果数（最大 200 件）
since_idnumberいいえこの ID より後の商品で絞り込みます
created_at_maxstringいいえ作成日の上限（ISO 8601）
created_at_minstringいいえ作成日の下限（ISO 8601）

詳細

MCP Tienda Nube

Tienda Nube（Nuvemshop）向け MCP サーバーです。アルゼンチン発祥の、LATAM を代表する e コマースプラットフォームで、ラテンアメリカにおける 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いいえHTTP トランスポートを有効にするには "true" を設定します
MCP_PORTいいえHTTP ポート（デフォルト：3000）

ツール（24）

ツール目的
list_productsストアの商品を一覧表示します
get_productID で商品詳細を取得します
create_product新しい商品を作成します
update_product既存の商品を更新します
list_orders注文を一覧表示します
get_orderID で注文詳細を取得します
list_customers顧客を一覧表示します
get_customerID で顧客詳細を取得します
list_categories商品カテゴリを一覧表示します
update_order_status注文のフルフィルメント／配送状況を更新します
delete_productID で商品を削除します
list_product_variants商品のバリエーションを一覧表示します
update_product_variant商品バリエーションを更新します（価格、在庫、sku、重量）
close_order注文を終了します（フルフィルメント済み／終了済みとしてマークします）
cancel_order注文をキャンセルします。オプションで在庫を戻し、返金できます
create_category商品カテゴリを作成します
update_category商品カテゴリを更新します
delete_categoryID で商品カテゴリを削除します
list_webhooks設定済みの Webhook を一覧表示します
create_webhookWebhook イベントを購読します
delete_webhookID で Webhook を削除します
list_discount_coupons割引クーポンを一覧表示します
create_discount_coupon割引クーポンを作成します
list_abandoned_carts放棄されたチェックアウトを一覧表示します

認証

Bearer トークン認証を使用します。Tienda Nube の Partners OAuth フローでアクセストークンを取得してください。ストア ID は API ベース URL に含まれます。

API リファレンス

エンタープライズ

エージェントによる支払いのガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

認証

サーバーを起動する前に、以下の環境変数を設定してください。

  • TIENDANUBE_ACCESS_TOKEN (必須、シークレット) — Tienda Nube のアクセストークン
  • TIENDANUBE_STORE_ID (必須) — ストア識別子

プロバイダーの開発者ポータルで認証情報を発行してください：https://tiendanube.github.io。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。