A Nuvemshop permite conectar a sua loja manualmente via URL a ferramentas de IA que suportam o padrão aberto MCP (Model Context Protocol). Com ela, você pode gerenciar a sua loja Nuvemshop pelas próprias plataformas de IA, conversando em linguagem natural.
Neste guia, mostramos o passo a passo de como realizar a conexão com as ferramentas abaixo:
- Cursor
- VS Code (GitHub Copilot, modo agente)
- Windsurf
Helpjuice Info Callout Title
Se você ainda não sabe o que é o conector ou deseja entender tudo o que pode fazer com ele, recomendamos ler primeiro o guia introdutório: Como gerenciar sua Nuvemshop com ferramentas de IA sem entrar no painel administrador?
O que você precisa antes de começar?
Para conectar a sua loja a qualquer uma dessas ferramentas, você precisa:
- Ter instalada a ferramenta onde vai conectar (Cursor, VS Code ou Windsurf).
- Ter uma conta ativa na Nuvemshop e acesso ao painel administrador da sua loja.
- Usar a URL oficial do Admin MCP da Nuvemshop: https://admin-mcp.nuvemshop.com.br
Como conectar a sua loja em cada ferramenta?
Cada ferramenta tem a sua própria forma de adicionar um servidor MCP. Para ver o passo a passo completo de cada uma, clicar nas opções abaixo:
Cursor
O Cursor aceita servidores MCP remotos via HTTP. Você pode adicionar o servidor pelas configurações ou editando o arquivo de configuração.
1. Abrir o Cursor no seu computador.
2. Acessar "Settings > Tools & MCP > New MCP Server".
Como alternativa, editar o arquivo mcp.json (global em ~/.cursor/mcp.json ou por projeto em .cursor/mcp.json) com o conteúdo abaixo:
{
"mcpServers": {
"nuvemshop": {
"url": "https://admin-mcp.nuvemshop.com.br"
}
}
}
3. Ao iniciar, o Cursor abrirá o fluxo de autenticação OAuth para você autorizar o acesso à sua loja.
VS Code (GitHub Copilot, modo agente)
1. Abrir o VS Code no seu computador.
2. Criar o arquivo .vscode/mcp.json no seu workspace (ou adicionar ao perfil de usuário), usando o transporte http:
{
"servers": {
"nuvemshop": {
"type": "http",
"url": "https://admin-mcp.nuvemshop.com.br"
}
}
}
3. O VS Code pedirá para iniciar o servidor e autorizar o acesso via OAuth.
Windsurf
1. Abrir o Windsurf no seu computador.
2. Editar o arquivo ~/.codeium/windsurf/mcp_config.json. O Windsurf usa o campo serverUrl para servidores MCP remotos via HTTP:
{
"mcpServers": {
"nuvemshop": {
"serverUrl": "https://admin-mcp.nuvemshop.com.br"
}
}
}
3. Reiniciar ou recarregar os servidores MCP no Windsurf (Cascade) e concluir a autorização via OAuth.
Helpjuice Info Callout Title
Você também pode conectar sua loja com qualquer outra ferramenta compatível com MCP remoto via HTTP, como Continue e Zed, por exemplo. Basta adicionar um servidor MCP do tipo HTTP apontando para a URL oficial da Nuvemshop (https://admin-mcp.nuvemshop.com.br) e autorizar o acesso via OAuth.
Pronto!
Sua loja já está conectada à ferramenta que você escolheu. Agora você pode conversar em linguagem natural para consultar vendas, atualizar dados de estoque, conferir o status de pedidos e muito mais, sem precisar abrir o painel administrador.
Para conferir os tutoriais completos de como realizar a conexão com Claude e ChatGPT, acessar os artigos abaixo: