Usa o BananaSplit com o Claude, o ChatGPT e outros assistentes de IA

Liga o BananaSplit ao Claude, ao ChatGPT, ao Grok ou ao Cursor e é só pedir. Quem ainda te deve da viagem? Quanto gastou a casa em supermercado este mês? Tu e o Alex estão quites? O teu assistente também pode adicionar despesas, registar pagamentos e configurar a renda por ti. E só vê o que tu vês no BananaSplit — nada mais.

O que podes pedir

  • Quem é que ainda me deve dinheiro da Viagem a Lisboa?
  • A Sam deve-te 42 € e o Alex 18 €. O resto está tudo quite.
  • O jantar foram 60 €, paguei eu. Divide com o Alex e a Sam na Viagem a Lisboa.
  • Feito. Adicionei Jantar, 60 €, pago por ti, dividido por três: 20 € cada.
  • O Alex acabou de me mandar 20 €. Regista isso.
  • Registei 20 € do Alex. Agora ele deve-te 18 €.
  • A renda é 1200 € no dia 1 de cada mês. Configura-a na Casa 3B, em partes iguais.
  • Configurado: Renda, 1200 €, no dia 1 de cada mês na Casa 3B, dividida pelos quatro (300 € cada).

Liga o teu assistente

O assistente envia-te para o BananaSplit para iniciares sessão e aprovares o acesso.

Claude

  1. Em claude.ai ou na app de desktop do Claude, abre Customize → Connectors.
  2. Carrega em + e escolhe Add custom connector.
  3. Chama-lhe BananaSplit e cola o endereço abaixo.
  4. Inicia sessão no BananaSplit e aprova o acesso.

Num plano Claude Team ou Enterprise, um owner adiciona o BananaSplit uma vez em Organization settings → Connectors. Depois, cada pessoa liga a sua própria conta BananaSplit.

ChatGPT

  1. Em chatgpt.com, abre Settings → Security and login e ativa o Developer mode.
  2. Vai a Plugins, carrega em +, chama-lhe BananaSplit e cola o endereço abaixo.
  3. Se te perguntar como iniciar sessão, escolhe OAuth. Depois inicia sessão no BananaSplit e aprova o acesso.
  4. Numa conversa nova, escolhe Developer mode no menu + e seleciona BananaSplit.

Nos planos Business, Enterprise e Edu, pode ser preciso um administrador ativar primeiro o developer mode.

Grok

  1. Vai a grok.com/connectors.
  2. Carrega em New Connector e escolhe Custom.
  3. Cola o endereço abaixo, inicia sessão no BananaSplit e aprova o acesso.

Também funciona no Grok Bot.

Cursor

  1. Abre Cursor Settings.
  2. Adiciona um servidor novo chamado BananaSplit e cola o endereço abaixo.
  3. Quando o Cursor abrir o BananaSplit, inicia sessão e aprova o acesso.

Copia e cola este endereço se o teu assistente o pedir:

https://api.bananasplit.net/mcp

O que podem fazer os assistentes de IA?

Quase tudo o que tu fazes no BananaSplit.

  • Saldos: vê quanto deves, quanto te devem e com quem.
  • Grupos: encontra grupos, vê membros e atividade recente, e cria grupos novos.
  • Despesas: adiciona, edita, apaga e recupera despesas, em partes iguais ou à tua maneira.
  • Pagamentos: regista acertos de contas e recupera um que tenhas apagado sem querer.
  • Despesas recorrentes: cria, edita, pausa e remove coisas como a renda e subscrições.
  • Amigos e moedas: procura pessoas, moedas e categorias para acertar nos nomes.

Ainda não: fotos de recibos, nem editar ou apagar pagamentos. Para isso, usa a app.

Entrega a um agente sempre ligado

Alguns assistentes continuam a trabalhar depois de fechares o portátil. Dá-lhes o BananaSplit e ficam de olho nas contas por ti, e só te chamam quando precisam de ti.

Coisas que podes delegar:

  • Quando a fatura da luz chegar ao meu email, adiciona-a à Casa 3B, em partes iguais.
  • No dia 2 de cada mês, diz-me quem na Casa 3B ainda não pagou a renda.
  • Todos os domingos à noite, manda-me como estou em todos os meus grupos.
  • Quando acabar a Viagem a Lisboa, calcula quem paga a quem e manda-me a lista.
  • Se alguém adicionar uma despesa acima de 100 € na Casa 3B, avisa-me.

Grok Bot

Adiciona o BananaSplit em grok.com/connectors, como acima, e os teus Bots também o podem usar. Manda mensagem a um Bot no telemóvel ou no computador e ele continua de onde ficaste. O Grok Bot está em beta nos planos SuperGrok e Cursor.

ChatGPT dots

Adiciona o BananaSplit no ChatGPT, como acima, e depois dá acesso ao teu dot. Os dots estão disponíveis no ChatGPT Pro (fora do EEE, Reino Unido e Suíça) e no Business Premium.

Meta MuseEm breve

Estamos a tratar disso. Os passos vão aparecer aqui assim que o BananaSplit funcionar com o Muse.

Tu tens o controlo

  • O teu acesso, nada mais. O teu assistente só vê o que tu vês no BananaSplit, e só faz o que tu podes fazer.
  • Nada se perde de vez. Despesas e pagamentos apagados podem ser recuperados. É só pedir.
  • Desliga quando quiseres. Remove o BananaSplit dos conectores do teu assistente e o acesso acaba. Tudo o que ele adicionou fica onde estava.

Para developers e outras apps

Este é o nosso servidor MCP alojado, e funciona com qualquer app que suporte conectores MCP. Aponta-a para https://api.bananasplit.net/mcp e inicia sessão. Não há nada para configurar do nosso lado.

Ou deixa o teu agente tratar disso. Cola isto no Claude Code, Codex, Cursor ou em qualquer agente que possa editar as próprias definições:

Adiciona o servidor MCP do BananaSplit às tuas definições MCP. Nome: bananasplit. URL: https://api.bananasplit.net/mcp (Streamable HTTP, inicia sessão com OAuth, sem API key). Depois diz-me como terminar o início de sessão.

Claude Code:

claude mcp add --transport http bananasplit https://api.bananasplit.net/mcp

VS Code: corre MCP: Add Server na Command Palette, escolhe HTTP e cola o endereço. Ou adiciona-o a mcp.json:

{
  "servers": {
    "bananasplit": { "type": "http", "url": "https://api.bananasplit.net/mcp" }
  }
}

Cursor, por ficheiro de configuração: adiciona-o a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bananasplit": { "url": "https://api.bananasplit.net/mcp" }
  }
}

Por dentro: Streamable HTTP, OAuth com PKCE e 26 ferramentas. Cada pessoa pode fazer 20 pedidos por minuto.

Trabalhas no terminal, ou estás a criar o teu próprio agente? Vê a CLI do BananaSplit e a skill para agentes.

Tenho perguntas…

Tem custos extra?

Não. Está incluído em todas as contas BananaSplit. O teu assistente de IA pode precisar de um plano pago para adicionar conectores.

O meu assistente vê grupos de que não faço parte?

Não. Age como tu. Se não vês um grupo, uma despesa ou um amigo no BananaSplit, o teu assistente também não.

Uso isto ou a CLI do BananaSplit?

Usa isto em apps de chat e editores. Não há nada para instalar. Se o teu agente tem terminal, ou queres scripts e JSON, a CLI faz o mesmo com a mesma conta.

Um agente pode fazer isto sozinho, com regularidade?

Pode. Agentes sempre ligados, como o Grok Bot e os dots do ChatGPT, continuam a trabalhar quando não estás. Pede-lhe para adicionar a fatura da luz quando chegar ao teu email, ou para te mandar os saldos todos os domingos. Liga primeiro o BananaSplit ao assistente e depois dá acesso ao agente.

E se o assistente se enganar?

Tudo o que adiciona é uma despesa ou um pagamento normal, por isso podes corrigir na app, ou pedir-lhe que corrija. Se uma alteração parecer ter falhado, pede-lhe para ver o grupo antes de tentar de novo. Às vezes já foi feita.

Tenho mais de uma conta BananaSplit. Qual é que ele usa?

A conta com que tens sessão iniciada quando aprovas o acesso. Para trocar, desliga e volta a ligar.

Algo não está a funcionar. Quem me ajuda?

Nós. Envia um email para [email protected] a dizer que assistente usas e o que pediste.