Agentes de IA

O gluvyn tem um servidor MCP (Model Context Protocol). Com ele, agentes como Claude, Codex, Cursor e o Copilot do VS Code consultam o seu mês e registram despesas, pagamentos, receitas e assinaturas na sua conta, a partir de um pedido em linguagem natural.

Como funciona

O agente entra com a mesma conta do app, Google ou Apple, pela tela de login do gluvyn. Você vê o pedido de acesso e autoriza.
Cada alteração do agente vai para a cópia do gluvyn na nuvem. O app recebe na próxima sincronização: ao abrir o app ou a cada 30 segundos enquanto ele estiver aberto.
As regras são as do app: valores, categorias, parcelas e pagamentos passam pelas mesmas validações, e nada é apagado.

Antes de conectar, entre no app com a sua conta e espere a primeira sincronização terminar. Sem essa cópia na nuvem, o agente não registra nada, para não criar um conflito com os dados do seu aparelho.

Se você editar no aparelho sem conexão enquanto o agente registra algo, o app mostra um conflito e você escolhe qual cópia manter, como acontece com dois aparelhos.

Configurar

Use este endereço no seu agente. Na primeira vez, ele abre o navegador para você entrar e autorizar:

https://mcp.gluvyn.app/mcp

Claude Code

No terminal, rode o comando abaixo. Depois, no Claude Code, digite /mcp, escolha gluvyn e entre.

claude mcp add --transport http gluvyn https://mcp.gluvyn.app/mcp

Claude (claude.ai e app para computador)

Em Configurações › Conectores, toque em Adicionar conector personalizado, dê o nome gluvyn e cole o endereço. Depois toque em Conectar.

https://mcp.gluvyn.app/mcp

Codex

No terminal, rode os comandos abaixo. O segundo abre o navegador para entrar.

codex mcp add gluvyn --url https://mcp.gluvyn.app/mcp
codex mcp login gluvyn

Cursor

Adicione o servidor em ~/.cursor/mcp.json. Em Configurações › MCP, toque em Login ao lado de gluvyn.

{
  "mcpServers": {
    "gluvyn": {
      "url": "https://mcp.gluvyn.app/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Crie .vscode/mcp.json no projeto, ou use o comando MCP: Add Server. O VS Code pede para entrar ao iniciar o servidor.

{
  "servers": {
    "gluvyn": {
      "type": "http",
      "url": "https://mcp.gluvyn.app/mcp"
    }
  }
}

Outros agentes funcionam se aceitarem servidores MCP remotos (HTTP) com login OAuth. Informe o mesmo endereço.

O que o agente pode fazer

get_month consulta salário, metas, receitas, contas e totais de um mês.
list_subscriptions lista as assinaturas e os totais mensal e anual.
add_expense lança uma conta no mês, com categoria, valor mínimo, parcelas e o que já foi pago.
pay_expense registra o pagamento de uma conta, em dinheiro, Pix ou cartão, total ou parcial.
add_income lança uma receita extra no mês.
add_subscription cadastra uma assinatura mensal ou anual, em real ou dólar.
update_month_plan define o salário líquido e as metas de reserva e de investimento do mês.

Exemplos de pedidos

“Lança a fatura do Nubank de R$ 1.240,50 em novembro, mínimo de R$ 186.”
“Paguei a energia no Pix, marca como paga.”
“Recebi R$ 800 de um freela hoje.”
“Cadastra o ChatGPT Plus, US$ 20 por mês, com dólar a R$ 5,40.”
“Quanto falta pagar este mês?”

Privacidade e segurança

O agente só acessa a conta que autorizou e não consegue apagar dados. Revise o que ele pretende registrar antes de confirmar: agentes de IA podem errar.

Para desconectar, remova o servidor gluvyn do seu agente. Para revogar todos os acessos já autorizados, escreva para support@gluvyn.app.

O que o agente lê ou registra também passa pelo provedor dele. Detalhes na política de privacidade.