--- title: "Woovi MCP | Sua conta Woovi no seu assistente de IA | Woovi" description: "Consulte e opere sua conta Woovi direto do ChatGPT, Claude Code, Cursor, Codex ou VS Code. Login OAuth, permissões por escopo e sem código de integração." canonical: "https://woovi.com/mcp/" --- Fonte canônica: https://woovi.com/mcp/ Woovi Model Context Protocol # Woovi MCP Consulte e opere sua conta Woovi direto do seu assistente de IA. Peça coisas como "liste as cobranças pagas hoje" ou "crie uma cobrança de R$ 50 para o cliente João" no ChatGPT, Claude Code, Cursor, Codex ou VS Code, sem escrever código de integração. [Cadastre-se grátis](https://app.woovi.com/register?utm%5Fsource=mcp&utm%5Fmedium=header)[Ver guia completo](https://ajuda.woovi.com/hc/duvidas-frequentes/articles/1790353020-como-conectar-a-woovi-ao-claude-code-cursor-codex-e-vs-code-com-o-mcp) - Sem código de integração - Login OAuth, sem tokens - Permissões por escopo - Revogue quando quiser ## Conecte sua conta Woovi às principais IAs - ChatGPT - Claude - Cursor - Codex - VS Code - ChatGPT - Claude - Cursor - Codex - VS Code O que é ## Sua conta Woovi como ferramenta do seu assistente de IA O MCP (Model Context Protocol) da Woovi permite que assistentes de IA consultem e operem sua conta Woovi em seu nome. O acesso é feito com login na Woovi e autorização explícita: você escolhe a conta e as permissões que o assistente pode usar, e pode revogar o acesso a qualquer momento. [Ver guia completo](https://ajuda.woovi.com/hc/duvidas-frequentes/articles/1790353020-como-conectar-a-woovi-ao-claude-code-cursor-codex-e-vs-code-com-o-mcp) Liste as cobranças pagas hoje woovi · CHARGE\_GET\_LIST Encontrei 12 cobranças pagas hoje, somando R$ 3.480,00\. A maior foi de R$ 890,00, paga às 14h32. Crie uma cobrança de R$ 50 para o cliente João woovi · CHARGE\_POST Cobrança criada para João, no valor de R$ 50,00\. Aqui está o link de pagamento Pix. Exemplo ilustrativo de conversa. Instalação ## Conecte em poucos minutos Todos os clientes usam o mesmo endereço. O servidor usa transporte HTTP e autenticação OAuth: você não precisa gerar AppID nem copiar tokens. `https://mcp.woovi.com/mcp`Copiar ChatGPTClaude CodeCursorCodexVS Code ### Conectando no ChatGPT 1. 1No ChatGPT, abra Configurações > Conectores e ative o modo desenvolvedor em Avançado. 2. 2Clique em Criar e preencha o conector com os dados ao lado. 3. 3O navegador abrirá a tela de login da Woovi. Depois de conectado, ative o conector Woovi na conversa para usar as ferramentas. Novo conectorCopiar ``` Nome: Woovi URL do servidor: https://mcp.woovi.com/mcp Autenticação: OAuth Client ID: chatgpt ``` Autorização ## Você decide o que o assistente pode fazer Na primeira conexão, o navegador abre a Woovi. 1. ### 1\. Faça login Entre com seu usuário da Woovi. 2. ### 2\. Escolha a conta Se sua empresa tiver mais de uma conta, escolha em qual o assistente vai atuar. 3. ### 3\. Revise as permissões Na tela "Conectar à Woovi", desmarque o que você não quer conceder. 4. ### 4\. Clique em Permitir O navegador volta para o seu editor e as ferramentas da Woovi ficam disponíveis. Permissões e ferramentas ## Cada ferramenta exige um escopo Se você não conceder o escopo, o assistente não consegue usar a ferramenta correspondente. ### Visualizar Somente leitura - Dados da empresaCOMPANY\_GET - ContasACCOUNT\_GET\_LIST · ACCOUNT\_GET - Limites da contaACCOUNT\_LIMITS\_GET - CobrançasCHARGE\_GET\_LIST · CHARGE\_GET - TransaçõesTRANSACTION\_GET\_LIST · TRANSACTION\_GET - ClientesCUSTOMER\_GET\_LIST · CUSTOMER\_GET - PagamentosPAYMENT\_GET\_LIST · PAYMENT\_GET - WebhooksWEBHOOK\_GET\_LIST - Eventos de webhookWEBHOOK\_EVENTS\_GET\_LIST - DisputasDISPUTE\_GET\_LIST · DISPUTE\_GET - AssinaturasSUBSCRIPTION\_GET\_LIST · SUBSCRIPTION\_GET - Parcelas de assinaturaSUBSCRIPTION\_INSTALLMENT\_GET\_LIST · SUBSCRIPTION\_INSTALLMENT\_GET ### Criar e alterar Escrita - Criar cobrançaCHARGE\_POST - Excluir cobrançaCHARGE\_DELETE - Criar clienteCUSTOMER\_POST - Atualizar clienteCUSTOMER\_PATCH - Criar QR Code Pix estáticoPIX\_QRCODE\_POST Dica Conceda apenas o que você vai usar. Para um assistente que só consulta dados, marque somente a aba Visualizar. Segurança e controle ## Acesso protegido, sob o seu controle ### Login OAuth O login acontece no navegador na primeira conexão. Nenhum AppID ou token fica salvo no seu editor. ### Limites de uso Cada ferramenta de leitura pode ser chamada até 60 vezes por minuto, e cada ferramenta de escrita até 20 vezes por minuto. ### Revogue a qualquer momento Veja os assistentes conectados (ChatGPT, Claude Code, Cursor, Codex ou VS Code) no painel da Woovi e clique em Desconectar. O acesso é encerrado na hora. [Ver assistentes conectados →](https://app.woovi.com/home/applications/tab/mcp) ## Perguntas frequentes Preciso escrever código para usar o MCP? Não. Depois de conectar, você faz pedidos em linguagem natural ao assistente, como "liste as cobranças pagas hoje", e ele usa as ferramentas da Woovi em seu nome. Preciso gerar AppID ou copiar tokens? Não. O login acontece no navegador na primeira conexão, com o seu usuário da Woovi. Nenhum AppID ou token fica salvo no seu editor. Quais assistentes são suportados? ChatGPT, Claude Code, Cursor, Codex e VS Code (modo agente do GitHub Copilot). Todos usam o mesmo endereço: https://mcp.woovi.com/mcp. O assistente pode fazer qualquer coisa na minha conta? Não. Ele só usa as ferramentas dos escopos que você concedeu na tela "Conectar à Woovi", e só na conta que você escolheu. Nenhuma ferramenta faz Pix, saque ou transferência. O que acontece se o limite de uso for atingido? A chamada é recusada até a janela de um minuto liberar. Aguarde alguns segundos e tente novamente. O limite é de 60 chamadas por minuto em cada ferramenta de leitura e 20 em cada ferramenta de escrita. Como desconecto um assistente? No painel da Woovi, em Aplicações > MCP, localize o assistente e clique em Desconectar. O acesso é encerrado na hora. ## Coloque a Woovi dentro do seu assistente de IA Conecte seu assistente de IA à sua conta Woovi e consulte cobranças, clientes e transações em linguagem natural. [Cadastre-se grátis](https://app.woovi.com/register?utm%5Fsource=mcp&utm%5Fmedium=cta)[Ver guia completo](https://ajuda.woovi.com/hc/duvidas-frequentes/articles/1790353020-como-conectar-a-woovi-ao-claude-code-cursor-codex-e-vs-code-com-o-mcp)