How to Use the Nuvemshop MCP in Claude Code

Q: How do I add the Nuvemshop MCP Server to my Claude Code config?

Run the command claude mcp add --transport http nuvemshop-mcp -- in your terminal. This registers all 24 tools in your local /.claude.json configuration file automatically.

Q: What store metrics can I query from the terminal?

You can query general configuration using getstore, list categories with listcategories, or check overall order volume using listorders to get an instant snapshot of your business performance.

Run your Nuvemshop store from the terminal with Claude Code to automate bulk inventory scripts and sync orders through your CLI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nuvemshop MCP to Claude Code

Create your Vinkius account to connect Nuvemshop to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Nuvemshop with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Terminal-Based Store Audits and Updates

Auditing your catalog from the terminal uses the `list_products` and `update_product` tools to bypass the web dashboard entirely. Ditch the slow web dashboard when checking your catalog status. Run a quick command to ask about low stock, and your agent uses `list_products` to scan inventory levels and outputs a clean terminal table of everything that needs restocking. Making updates is incredibly fast. You can tell the command-line agent to mark an item as out of stock, and it executes `update_product` instantly, saving you from navigating through multiple browser tabs.

Automate CLI Pipelines with the Nuvemshop MCP Server

Building headless automation pipelines relies on the `list_orders` and `create_coupon` tools to run store tasks automatically. Integrating your storefront with external warehouse systems or cron jobs becomes simple. Claude Code can run headless scripts that call `list_orders` to fetch overnight sales and pipe the JSON output directly into your shipping software. You can also automate marketing tasks. Set up shell scripts that trigger `create_coupon` on the first of every month, ensuring your promotional codes are always generated and updated without manual intervention.

Instant Customer and Webhook Management

Managing store contacts and events is driven by the `list_customers` and `create_webhook` tools directly in your shell. Managing store integrations from the command line is highly efficient. The agent can query your customer database using `list_customers` to find specific buyers, or inspect detailed profiles with `get_customer` to resolve support issues fast. It also lets you control your event-driven architecture. You can list active endpoints using `list_webhooks`, set up new real-time listeners via `create_webhook`, or tear down stale ones with `delete_webhook` directly from your terminal session.

Setup guide

Set up Nuvemshop MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see nuvemshop-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Nuvemshop transactions." It will automatically discover and invoke the available Nuvemshop tools.

Terminal

claude mcp add --transport http nuvemshop-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Nuvemshop MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "nuvemshop-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Nuvemshop. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Nuvemshop now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Nuvemshop MCP in Claude Code

Yes, you can pipe terminal data directly into the agent. It can read a list of product IDs and run `update_product` or `delete_product` sequentially, making it ideal for fast, headless store maintenance.

Run the command `claude mcp add --transport http nuvemshop-mcp -- ` in your terminal. This registers all 24 tools in your local `~/.claude.json` configuration file automatically.

Yes. You can ask the agent to list all active endpoints using `list_webhooks`. If an endpoint is broken, the agent can remove it with `delete_webhook` and register a fresh one using `create_webhook` in seconds.

You can query general configuration using `get_store`, list categories with `list_categories`, or check overall order volume using `list_orders` to get an instant snapshot of your business performance.

Your store's customer records, order history, and coupon codes are accessed over secure HTTPS connections. The MCP server runs within an ephemeral V8 sandbox on Vinkius, meaning no customer details from `list_customers` are ever written to persistent storage.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript