Karrito

karrito-mcp

Servidor MCP para Karrito — o construtor de catálogo digital para vendedores do WhatsApp na LATAM.

Conecte seu assistente de IA (Claude, Cursor, Windsurf) ao Karrito e gerencie toda a sua loja — produtos, pedidos, descontos, avaliações, envios, análises — sem sair do seu editor.

Instalação

Início rápido (npx)

npx karrito-mcp

Claude Code

claude mcp add karrito -- npx karrito-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "karrito": {
      "command": "npx",
      "args": ["karrito-mcp"],
      "env": {
        "KARRITO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / Windsurf

Adicione à sua configuração MCP:

{
  "karrito": {
    "command": "npx",
    "args": ["karrito-mcp"],
    "env": {
      "KARRITO_API_KEY": "your-api-key-here"
    }
  }
}

Configuração

Variável	Obrigatório	Descrição
KARRITO_API_KEY	Para ferramentas autenticadas	Sua chave de API do Karrito em Configurações > API
KARRITO_API_URL	Não	URL de API personalizada (padrão: https://karrito.shop)

Recursos (5)

Dados estáticos sobre o Karrito — nenhuma autenticação necessária.

Recurso	URI	Descrição
Preços	karrito://pricing	Comparação de planos, preços e recursos
Recursos	karrito://features	Lista completa de recursos (núcleo, pro, futuros)
Nichos	karrito://niches	Todos os 50 nichos de loja disponíveis
Concorrentes	karrito://competitors	19 concorrentes comparados com as vantagens do Karrito
Moedas	karrito://currencies	6 moedas LATAM suportadas

Ferramentas (30)

Públicas (sem autenticação necessária)

Ferramenta	Descrição
search_catalogs	Pesquisar catálogos públicos por palavra-chave
get_niche_info	Obter informações sobre um nicho específico

Produtos (autenticação necessária)

Ferramenta	Descrição
list_my_products	Listar produtos do seu catálogo
create_product	Criar um novo produto
update_product	Atualizar um produto existente
delete_product	Excluir um produto (exclusão suave)

Categorias (autenticação necessária)

Ferramenta	Descrição
list_categories	Listar categorias da sua loja
create_category	Criar uma nova categoria
update_category	Atualizar uma categoria existente
delete_category	Excluir uma categoria

Pedidos (autenticação necessária)

Ferramenta	Descrição
list_my_orders	Listar pedidos com filtro de status opcional
get_order	Obter informações detalhadas do pedido
update_order_status	Alterar o status do pedido (confirmar, enviar, entregar, cancelar)

Loja (autenticação necessária)

Ferramenta	Descrição
get_my_store	Obter informações da loja (nome, slug, moeda, estatísticas)
update_store	Atualizar configurações da loja (nome, WhatsApp, moeda, etc.)
toggle_publish	Publicar ou despublicar sua loja rapidamente

Descontos (autenticação necessária)

Ferramenta	Descrição
list_discounts	Listar códigos de desconto
create_discount	Criar um código de desconto (percentual ou fixo)
update_discount	Atualizar um desconto existente
delete_discount	Excluir um código de desconto

Avaliações (autenticação necessária)

Ferramenta	Descrição
list_reviews	Listar avaliações com filtro de status opcional
moderate_review	Aprovar ou rejeitar uma avaliação
delete_review	Excluir permanentemente uma avaliação

Clientes (autenticação necessária)

Ferramenta	Descrição
list_customers	Listar clientes que fizeram pedidos
get_customer	Obter detalhes do cliente com histórico de pedidos

Análises (autenticação necessária)

Ferramenta	Descrição
get_analytics	Estatísticas da loja: pedidos, receita, produtos, clientes, AOV, produtos populares

Envio (autenticação necessária)

Ferramenta	Descrição
list_shipping_options	Listar opções de envio
create_shipping_option	Criar uma opção de envio (entrega, retirada, expresso)
update_shipping_option	Atualizar uma opção de envio
delete_shipping_option	Excluir uma opção de envio

Exemplos de uso

Navegar por catálogos públicos

"Pesquise catálogos de padaria no Karrito"

O assistente usará search_catalogs com a consulta "bakery" para encontrar lojas correspondentes.

Explorar nichos

"Quais nichos o Karrito suporta para negócios de alimentação?"

O assistente usará get_niche_info para pesquisar nichos relacionados a alimentos.

Gerenciar seu catálogo

"Liste todos os meus produtos e adicione um novo chamado 'Chocolate Cake' por $15"

O assistente usará list_my_products e create_product (requer KARRITO_API_KEY).

Gerenciar pedidos

"Mostre-me todos os pedidos pendentes e confirme o primeiro"

O assistente usará list_my_orders com filtro de status e update_order_status.

Criar descontos

"Crie um código de desconto de 20% VERANO20 que expira em 31 de dezembro"

O assistente usará create_discount com os parâmetros fornecidos.

Moderar avaliações

"Mostre-me avaliações pendentes e aprove as que tiverem 4+ estrelas"

O assistente usará list_reviews com status "pending" e moderate_review.

Obter análises

"Como está o desempenho da minha loja? Mostre-me as estatísticas"

O assistente usará get_analytics para recuperar as métricas da loja.

Comparar plataformas

"Como o Karrito se compara ao Shopify e à TiendaNube?"

O assistente lerá o recurso karrito://competitors.

Desenvolvimento

git clone https://github.com/curetcore/karrito-mcp
cd karrito-mcp
npm install
npm run dev

Licença

MIT