nuvemshop-mcp
Servidor MCP para a API de e-commerce Nuvemshop/Tiendanube.
Requisitos
- Node.js >= 18
- Uma loja Nuvemshop com token de acesso
Instalação
npm install nuvemshop-mcpConfiguração
Claude Desktop
Adicione ao arquivo de configuração do Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"nuvemshop": {
"command": "npx",
"args": ["nuvemshop-mcp"],
"env": {
"USER_ACCESS_TOKEN": "seu_token_aqui",
"STORE_ID": "seu_store_id"
}
}
}
}Transporte HTTP
Para usar o transporte HTTP (compatível com a especificação MCP mais recente):
npx nuvemshop-mcp --httpInicia na porta 3000 por padrão. Configurável com as variáveis de ambiente MCP_HTTP_HOST e MCP_HTTP_PORT.
Ferramentas Disponíveis
Loja (1)
| Ferramenta | Descrição | Status |
|---|---|---|
get_store | Retorna informações da loja (plano, nome, moeda) | ✅ |
Categorias (5)
| Ferramenta | Descrição | Status |
|---|---|---|
list_categories | Lista todas as categorias | ✅ |
get_category | Busca uma categoria por ID | ✅ |
create_category | Cria uma nova categoria | ✅ |
update_category | Atualiza uma categoria existente | ✅ |
delete_category | Remove uma categoria | ✅ |
Produtos (10)
| Ferramenta | Descrição | Status |
|---|---|---|
list_products | Lista produtos com filtros opcionais | ✅ |
get_product | Busca um produto por ID | ✅ |
get_product_by_sku | Busca um produto pelo SKU | ✅ |
create_product | Cria um novo produto | ✅ |
update_product | Atualiza um produto existente | ✅ |
delete_product | Remove um produto | ✅ |
create_variant | Adiciona uma variante a um produto | ✅ |
update_variant | Atualiza uma variante existente | ✅ |
delete_variant | Remove uma variante | ✅ |
bulk_update_stock_price | Atualiza estoque e preço de múltiplas variantes | ✅ |
Pedidos (5)
| Ferramenta | Descrição | Status |
|---|---|---|
list_orders | Lista pedidos com filtros opcionais | ✅ |
get_order | Busca um pedido por ID | ✅ |
close_order | Fecha um pedido | ✅ |
reopen_order | Reabre um pedido fechado | ✅ |
cancel_order | Cancela um pedido | ✅ |
Fulfillment (4)
| Ferramenta | Descrição | Status |
|---|---|---|
list_fulfillment_orders | Lista ordens de fulfillment de um pedido | ✅ |
get_fulfillment_order | Busca uma ordem de fulfillment por ID | ✅ |
update_fulfillment_order | Atualiza o status de uma ordem de fulfillment | ✅ |
add_tracking_event | Adiciona evento de rastreamento a uma ordem | ✅ |
Clientes (5)
| Ferramenta | Descrição | Status |
|---|---|---|
list_customers | Lista clientes com filtros opcionais | ✅ |
get_customer | Busca um cliente por ID | ✅ |
create_customer | Cria um novo cliente | ✅ |
update_customer | Atualiza um cliente existente | ✅ |
delete_customer | Remove um cliente | ✅ |
Cupons (2)
| Ferramenta | Descrição | Status |
|---|---|---|
list_coupons | Lista cupons de desconto | ✅ |
create_coupon | Cria um novo cupom de desconto | ✅ |
Exemplos
Alguns exemplos de prompts para usar com seu assistente de IA:
- "Liste meus produtos mais recentes"
- "Crie um cupom de 10% de desconto com o codigo PROMO10"
- "Mostre os pedidos pendentes de envio"
- "Qual o plano atual da minha loja?"
Tecnologia
Construído com @modelcontextprotocol/sdk.
Contribuindo
O desenvolvimento acontece no branch develop. Releases são feitas via PR para main. Merge em main publica automaticamente no npm via GitHub Actions. Para contribuir, crie seu branch a partir de develop e abra um PR para develop.
Licença
MIT
Este projeto foi em sua maior parte (~90%) construído com assistência de IA.