Conectando a Woovi ao Claude Code, Cursor, Codex e VS Code com o MCP

O MCP (Model Context Protocol) permite que assistentes de IA consultem e operem a sua conta Woovi com a sua autorização explícita. Você escolhe qual conta e quais permissões o assistente pode acessar, e pode revogar esse acesso a qualquer momento.

Com o MCP da Woovi conectado, você pode pedir ao assistente coisas como:

• "Liste as cobranças pagas hoje"
• "Crie uma cobrança de R$ 50,00 para o cliente João"
• "Quais webhooks estão configurados na minha conta?"

Endereço do servidor

Todos os clientes utilizam o mesmo servidor:

https://mcp.woovi.com/mcp

• Transporte: HTTP
• Autenticação: OAuth

info

Não é necessário gerar um AppID. O login é feito no navegador na primeira vez que o assistente se conecta.

Instalação

Claude Code

Execute no terminal:

claude mcp add --transport http --client-id claude-code woovi https://mcp.woovi.com/mcp

Para habilitar o MCP da Woovi em todos os seus projetos, adicione --scope user:

claude mcp add --transport http --client-id claude-code --scope user woovi https://mcp.woovi.com/mcp

Cursor

Edite o arquivo ~/.cursor/mcp.json (global) ou .cursor/mcp.json (apenas no projeto):

{
  "mcpServers": {
    "woovi": {
      "url": "https://mcp.woovi.com/mcp",
      "auth": {
        "CLIENT_ID": "cursor"
      }
    }
  }
}

Codex

Execute no terminal:

codex mcp add woovi --url https://mcp.woovi.com/mcp --oauth-client-id codex
codex mcp login woovi

VS Code

Crie o arquivo .vscode/mcp.json no seu projeto:

{
  "servers": {
    "woovi": {
      "type": "http",
      "url": "https://mcp.woovi.com/mcp",
      "oauth": {
        "clientId": "vscode"
      }
    }
  }
}

Autorização

Na primeira conexão, o navegador será aberto para você:

1. Fazer login na Woovi
2. Selecionar a conta que o assistente vai acessar
3. Revisar as permissões na tela de autorização
4. Conceder o acesso

As permissões cobrem operações de leitura e de escrita sobre dados da empresa, cobranças, transações, clientes, webhooks, disputas e assinaturas. Conceda apenas as permissões que o assistente realmente precisa.

Limites de uso

Tipo de operação	Limite
Leitura	60 chamadas por minuto
Escrita	20 chamadas por minuto

Gerenciando o acesso

Você pode ver e revogar os assistentes conectados em:

• app.woovi.com/home/applications/tab/mcp
• auth.woovi.com/mcp/connections