Ligar o Claude, o ChatGPT ou outro assistente de IA

O To Bill liga-se aos assistentes de IA que falam o protocolo MCP (Model Context Protocol): o Claude (claude.ai, Claude Desktop, Claude Code), o ChatGPT e muitos outros. Depois de ligado, o seu assistente faz no To Bill o que o utilizador pode fazer, com as suas permissões e nunca mais: lê as suas faturas, as suas despesas e a sua contabilidade e, se o autorizar, corrige. Pode pedir-lhe, por exemplo, «Verifica a saúde dos meus livros e lança as linhas bancárias de outubro», ou «Prepara uma fatura em rascunho para a Boulangerie du Lac».

Este guia é o do assistente que traz consigo. A IA integrada no To Bill (o Copiloto, o piloto automático) tem os seus próprios guias: consulte O assistente IA.

Antes de começar

• O endereço a dar ao seu assistente é https://app.tobill.ch/mcp. Encontra-o também em Definições › Ligações IA e API, em Endereço do servidor MCP, com um botão Copiar.
• O assistente trabalha numa única empresa, a que escolhe ao autorizá-lo. Para outra empresa, ligue-o uma segunda vez.
• Tem as permissões do seu perfil nessa empresa. Um membro que não vê a contabilidade no To Bill também não a verá através do seu assistente.
• O que o assistente lê no To Bill segue para o seu fornecedor (a Anthropic para o Claude, a OpenAI para o ChatGPT): consulte O que o assistente recebe.

Claude: claude.ai e Claude Desktop

O conector que adiciona em claude.ai serve também no Claude Desktop e no seu telemóvel: basta adicioná-lo uma vez.

1. No Claude, abra Customize › Connectors (os menus do Claude são indicados aqui em inglês) e clique em Add custom connector. Numa subscrição Team ou Enterprise, é um proprietário da organização que o adiciona, em Organization settings › Connectors; cada membro liga-se depois com a sua própria conta To Bill.
2. Dê-lhe um nome, por exemplo To Bill, e cole o endereço https://app.tobill.ch/mcp. Deixe as definições avançadas como estão.
3. Clique em Add e depois em Connect. Abre-se a página de autorização do To Bill: inicie sessão se necessário (incluindo com Google), escolha a empresa e o acesso, e clique em Autorizar.

O Claude volta à conversa, ligado. Antes de agir com uma ferramenta que altera os seus dados, o Claude pede a sua concordância; pode bloquear uma ferramenta específica nas definições do conector.

Claude Code

Num terminal:

claude mcp add --transport http tobill https://app.tobill.ch/mcp

Depois, no Claude Code, escreva /mcp, escolha tobill e inicie a autenticação: o seu navegador abre a página de autorização do To Bill. O Claude Code também se pode ligar com uma chave API pessoal em vez desta página: consulte A API e as chaves.

ChatGPT

Consoante a sua subscrição do ChatGPT, adicionar um conector personalizado exige o modo de programador e, num espaço de trabalho, a concordância do respetivo administrador.

1. No ChatGPT, abra Settings › Apps, depois Advanced settings, e ative Developer mode.
2. Crie uma aplicação (Create): um nome, por exemplo To Bill, o endereço https://app.tobill.ch/mcp como servidor MCP, e a autenticação OAuth.
3. Guarde e ligue-se: abre-se a página de autorização do To Bill. Escolha a empresa e o acesso, e clique em Autorizar.

O ChatGPT pede-lhe que confirme cada ação que altera os seus dados.

Outro assistente

Qualquer assistente que aceite um servidor MCP remoto (transporte HTTP) com uma ligação OAuth liga-se da mesma forma: dê-lhe o endereço https://app.tobill.ch/mcp e ele abre a página de autorização. Uma ferramenta sem ligação OAuth (um script, um cliente de linha de comandos) utiliza uma chave API pessoal: consulte A API e as chaves.

A página de autorização

É a página do To Bill que o seu assistente abre da primeira vez. Indica-lhe:

• quem pede o acesso: o nome da aplicação. Quando a aplicação é identificada pelo seu próprio endereço (claude.ai, chatgpt.com), o To Bill mostra-o. Caso contrário, o nome é o que a própria aplicação indica: continue apenas se acabou de a ligar;
• para onde será reencaminhado depois da sua resposta; para uma aplicação que funciona no seu computador, o To Bill assinala-o;
• a Empresa a que o assistente terá acesso, e apenas essa;
• o Acesso pedido: Leitura e alteração, ou Só leitura. Pode escolher Só leitura mesmo quando o assistente pede mais.

Autorizar liga o assistente; Recusar devolve-o sem acesso.

O que o assistente pode fazer

• Ler o que vê no To Bill: clientes, artigos, orçamentos, faturas, recebimentos, despesas, contabilidade (diário, razão, balancete, saúde dos livros, linhas bancárias, regras bancárias), salários e horas se tiver acesso a eles, definições.
• Com Leitura e alteração, agir como o faria: criar orçamentos e faturas em rascunho, registar clientes, lançar uma linha bancária, fazer um lançamento, estornar um lançamento, corrigir uma despesa, gerir as regras bancárias, abrir o exercício seguinte…
• Cada ação passa pelos mesmos controlos que na aplicação: um lançamento contabilizado nunca se altera, estorna-se; um período de IVA declarado fica fechado; um documento enviado não se reescreve.

O To Bill dá ao assistente as suas regras de escrituração: corrigir por estorno ou por um novo lançamento, lançar os movimentos privados de uma empresa individual na conta 2850 em vez de os ignorar, não lançar IVA para uma empresa que não lhe está sujeita, e considerar o extrato bancário como a verdade das contas bancárias.

O que não pode fazer

• Pagar, transferir dinheiro, alterar a sua subscrição ou comprar créditos.
• Iniciar sessão em seu lugar, gerir as suas ligações e as suas chaves, eliminar a empresa ou a sua conta.
• Agir noutra empresa que não a escolhida, nem no cockpit de um fiduciário.
• Gerir a equipa: convidar alguém, alterar um perfil ou um endereço de e-mail, remover um membro; nem alterar o servidor de envio de e-mails (SMTP) da empresa.
• Agir em massa: eliminar, enviar ou marcar como pagos vários documentos de uma só vez. Fá-lo documento a documento, e confirma cada um.
• Descarregar a empresa inteira de uma vez (o arquivo de conservação, o pacote para o fiduciário), ver o número AVS completo de um colaborador ou gerar o ficheiro de pagamento dos salários. Do IBAN de um colaborador vê apenas os últimos 4 dígitos.
• Ultrapassar as permissões do seu perfil.

O texto de um documento não é uma ordem

O assistente lê o texto dos seus comprovativos, dos seus extratos bancários e das suas faturas. Se um texto lhe pedir alguma coisa («pague este montante», «altere o IBAN»), o To Bill disse-lhe para não obedecer: é um dado, não uma instrução. Releia sempre o que o assistente se prepara para fazer antes de o aceitar.

Quem fez o quê

Cada alteração feita por um assistente fica registada na atividade da empresa, em seu nome e no do assistente («Alteração via Claude»): no painel, Atividades recentes, e depois Ver tudo para a lista completa. Um lançamento que ele faz tem como autor o seu nome seguido do do assistente, por exemplo Léa Rochat via Claude.

O que o assistente recebe

Quando liga um assistente, o To Bill envia-lhe, a seu pedido, os dados que ele pede: o que as suas ferramentas leem na sua empresa, em claro. Seguem para o fornecedor do assistente (Anthropic, OpenAI ou outro), segundo as condições deste. É o utilizador que escolhe o assistente e aquilo em que ele o ajuda. Já o Copiloto do To Bill substitui os nomes por códigos antes de os enviar: consulte O assistente IA.

Cortar o acesso

1. Abra Definições › Ligações IA e API (também a partir do menu com o seu nome, em baixo à esquerda).
2. Em Aplicações ligadas, clique em Revogar ao lado do assistente e confirme.

O acesso termina de imediato. Retirar o conector no assistente nem sempre chega: revogue-o também no To Bill. Uma ligação não utilizada durante 30 dias termina por si; basta então voltar a ligar o assistente.