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.

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.

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

Conectando no ChatGPT

1No ChatGPT, abra Configurações > Conectores e ative o modo desenvolvedor em Avançado.
2Clique em Criar e preencha o conector com os dados ao lado.
3O navegador abrirá a tela de login da Woovi.

Depois de conectado, ative o conector Woovi na conversa para usar as ferramentas.

Novo conector

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. Faça login
Entre com seu usuário da Woovi.
2. Escolha a conta
Se sua empresa tiver mais de uma conta, escolha em qual o assistente vai atuar.
3. Revise as permissões
Na tela "Conectar à Woovi", desmarque o que você não quer conceder.
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 →

Perguntas frequentes

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.

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.

ChatGPT, Claude Code, Cursor, Codex e VS Code (modo agente do GitHub Copilot). Todos usam o mesmo endereço: https://mcp.woovi.com/mcp.

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.

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.

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.