Conectando o Pluma ao Claude (MCP)

O Pluma oferece um servidor MCP (Model Context Protocol) que permite conectar sua conta a assistentes de IA como o Claude. Depois de conectado, você pode perguntar em linguagem natural coisas como "quanto gastei com restaurantes este mês?", "qual é a minha fatura do cartão que vence agora?" ou "quais assinaturas eu pago?" — e o assistente consulta os seus dados do Pluma para responder.

A conexão é feita com login e autorização no próprio Pluma, sem copiar senhas ou chaves. O assistente só acessa a conta que você autorizou e enxerga exatamente o que você enxerga no app.

O que você precisa

• Uma conta no Pluma com dados sincronizados (contas, cartões ou transações)
• Uma conta no Claude (claude.ai, Claude Desktop ou Claude Code)
• O endereço do servidor MCP do Pluma:

https://app.pluma.finance/api/mcp

Conectores personalizados (remote MCP) estão disponíveis na maioria dos planos do Claude. Se a opção não aparecer para você, confirme na central de ajuda do Claude se o seu plano a inclui.

Conectando pelo Claude (web ou Desktop)

Os passos são os mesmos no navegador (claude.ai) e no aplicativo Claude Desktop:

1. Abra o Claude e acesse Configurações (Settings)
2. Entre em Conectores (Connectors)
3. Clique em Adicionar conector personalizado (Add custom connector)
4. Preencha:
   • Nome: Pluma
   • URL do servidor MCP: https://app.pluma.finance/api/mcp
5. Clique em Adicionar — não é necessário preencher Client ID ou Client Secret nas opções avançadas
6. Na lista de conectores, clique em Conectar ao lado do Pluma
7. Uma janela do Pluma será aberta pedindo autorização (veja a próxima seção)

Depois de autorizar, você volta para o Claude e o conector aparece como conectado. Os conectores adicionados no claude.ai ficam disponíveis também no aplicativo para celular.

Em planos Team e Enterprise

Nesses planos, um proprietário da organização precisa adicionar o conector primeiro, nas configurações da organização. Depois disso cada pessoa conecta a sua própria conta Pluma individualmente — os dados nunca são compartilhados entre membros.

Conectando pelo Claude Code

Se você usa o Claude Code no terminal, adicione o servidor com transporte HTTP:

claude mcp add --transport http pluma https://app.pluma.finance/api/mcp

O parâmetro --transport http é obrigatório: sem ele o Claude Code não inicia o fluxo de autorização. Em seguida:

1. Abra uma sessão do Claude Code e digite /mcp
2. Selecione pluma e conclua o login no navegador que será aberto

A tela de autorização do Pluma

Durante a conexão, o Pluma abre a tela "Autorizar Claude":

1. Se você não estiver logado, faça login normalmente — depois do login você volta automaticamente para a autorização
2. Confira as permissões solicitadas (identificar você, ver seu e-mail e seu perfil)
3. Clique em Aprovar para concluir ou em Recusar para cancelar

Ao aprovar, o Claude poderá ler seus dados financeiros no Pluma em seu nome. Na próxima vez que o Claude precisar renovar o acesso, a autorização já aprovada é reaproveitada sem pedir confirmação de novo.

Usando o Pluma no Claude

Com o conector ativo, basta conversar. Em algumas interfaces é preciso ativar o conector Pluma no menu de ferramentas da conversa antes do primeiro uso. Exemplos de perguntas:

• "Como está meu mês? Resuma receitas, despesas e saldo."
• "Quanto gastei em cada categoria em setembro?"
• "Compare meu orçamento com o gasto real deste mês."
• "Quais faturas de cartão estão abertas e quando vencem?"
• "Quais parcelas ainda tenho em andamento?"
• "O que vence nos próximos 7 dias?"
• "Liste minhas transações sem categoria."

O Pluma também oferece o prompt Revisão mensal (revisao_mensal), que guia o Claude por um fechamento completo do mês — visão geral, gastos por categoria e comparação com o orçamento — e pede uma síntese com recomendações.

O que o Claude consegue fazer

Por padrão o acesso é somente leitura. O Claude pode consultar:

• Resumo do dashboard, receitas, despesas e saldo do período
• Transações, com filtros por período, categoria, conta, valor e busca por texto
• Contas, patrimônio e totais de caixa, investimentos e crédito
• Categorias e relatórios de gastos por categoria, grupo ou estabelecimento
• Orçamentos e comparação de orçado versus realizado
• Cartões de crédito: faturas (abertas, fechadas e futuras), detalhes de cada fatura, parcelas e assinaturas
• Recorrentes: assinaturas, contas e receitas recorrentes, resumo do mês e próximos vencimentos

A única ação de escrita, recategorizar uma transação, é liberada gradualmente. Quando disponível, o Claude sempre pede sua confirmação antes de alterar, e a mudança aparece no Pluma como uma categorização manual. Veja mais em Categorias e categorização.

Feedback automático para a equipe do Pluma

O Claude também pode avisar a equipe do Pluma por conta própria quando perceber um problema durante a conversa — por exemplo, algo que você não conseguiu fazer, uma consulta que falhou ou dados que parecem errados (uma transação duplicada, uma categoria trocada, um total de fatura que não bate). Assim a equipe fica sabendo e pode corrigir sem que você precise abrir um chamado. Esse recurso é liberado gradualmente.

• O relato vira um post privado no portal de feedback do Pluma: só você e a equipe conseguem ver.
• O Claude é orientado a descrever o problema e apontar os registros envolvidos pelo identificador, sem copiar valores ou dados pessoais. Além disso, o Pluma remove automaticamente do texto CPF, CNPJ, números de cartão e e-mails antes de enviar.
• O Claude avisa na conversa quando envia um relato. Relatos repetidos do mesmo problema não geram posts novos, e há um limite de 5 relatos por dia por conta.
• Enviar feedback não altera nenhum dado seu no Pluma.

Se preferir que o Claude não envie relatos, peça isso na conversa ou desative a ferramenta de feedback do Pluma nas configurações do conector no Claude.

O que o Claude nunca consegue fazer

• Excluir ou mover transações para a lixeira
• Criar transações ou movimentar dinheiro
• Alterar regras, contas, conexões bancárias ou dados de pagamento
• Acessar dados de outras pessoas, inclusive de membros do seu espaço compartilhado

Segurança e privacidade

• A autorização usa OAuth 2.1: o Claude recebe um token temporário vinculado à sua conta, nunca a sua senha.
• Todas as consultas passam pelas mesmas regras de permissão do app. O Claude só vê o que você veria logado.
• Há um limite de requisições por minuto por conta para evitar abuso. Se o Claude informar que o Pluma recusou por excesso de requisições, aguarde um minuto e tente novamente.
• Para revogar o acesso, remova ou desconecte o conector Pluma em Configurações > Conectores no Claude. Isso encerra o acesso imediatamente; para reconectar, basta repetir os passos acima.

Problemas comuns

O conector não conecta ou mostra erro de URL. Confira se o endereço está exatamente como https://app.pluma.finance/api/mcp, sem barra no final. O servidor MCP é liberado gradualmente — se ainda não estiver disponível para a sua conta, aguarde ou entre em contato com o suporte.

A tela de autorização diz "Requisição de autorização inválida". O link de autorização expirou. Volte ao Claude e clique em Conectar novamente para gerar um novo pedido.

Fiz login mas voltei para a tela de login de novo. Verifique se o navegador permite cookies e janelas pop-up para app.pluma.finance e tente novamente.

O Claude pede para autorizar repetidamente ou fica em loop. Remova o conector no Claude e adicione-o de novo. No Claude Code, use claude mcp remove pluma e repita o passo de adicionar.

O Claude responde que não tem acesso aos meus dados. Confirme que o conector Pluma está ativado na conversa (menu de ferramentas) e que a conexão está marcada como conectada em Configurações > Conectores.

Outros assistentes

O servidor MCP do Pluma segue o padrão aberto e também funciona em outros assistentes compatíveis, como o ChatGPT (modo desenvolvedor > adicionar conector com a mesma URL). A tela de autorização do Pluma e as permissões são as mesmas.