Conectar um assistente de IA ao Braxio

A conexão está disponível em todos os planos do Braxio. Abra Config › Integrações para consultar as instruções e gerenciar suas conexões. A disponibilidade de conectores personalizados no ChatGPT ou no Claude depende da sua conta e das regras da sua organização nesses serviços.

Este guia mostra a conexão personalizada, que pode ser usada antes da publicação nos diretórios. O assistente pode identificar o Braxio como não verificado. A disponibilidade também depende da sua conta no Claude ou no ChatGPT e das regras da sua organização.

O que a conexão faz

Depois de conectar, você conversa com o Braxio dentro do assistente que já usa. Ele consulta e altera os dados do escritório a seu pedido: acha um projeto ou um cliente, cria e edita tarefas, lança transações, lê relatórios e fecha orçamentos.

O assistente age como você. Ele recebe as mesmas permissões que a sua conta tem naquele escritório, e nada além disso.

Onde conectar

Em Config › Integrações, escolha o assistente. A tela mostra quem já está conectado no escritório, o que os assistentes fizeram e o botão que leva à configuração.

Conectar no Claude

O botão Conectar no Claude abre Personalizar › Conectores, chamado Customize › Connectors na interface em inglês.

1. Selecione + › Adicionar conector personalizado (Add custom connector).
2. Informe o nome Braxio e o endereço https://app.braxio.com.br/api/mcp.
3. Selecione Adicionar (Add) e depois Conectar (Connect) para autorizar sua conta.

Em contas Team ou Enterprise, um proprietário precisa cadastrar o servidor primeiro em Configurações da organização › Conectores, usando Add › Custom › Web. Depois, cada membro abre Personalizar › Conectores, encontra o Braxio e conecta a própria conta.

Na conversa, ative o Braxio pelo botão + › Conectores.

Conectar no ChatGPT

Para adicionar o Braxio diretamente, use o modo desenvolvedor. Ele pode não estar disponível na sua conta ou estar bloqueado pela organização.

1. Em Configurações › Segurança e login (Settings › Security and login), ative Modo desenvolvedor (Developer mode).
2. Abra Plugins do ChatGPT e selecione +.
3. Informe o nome Braxio e uma descrição, como Consultar e atualizar meu escritório no Braxio.
4. Em Conexão (Connection), use o endereço público https://app.braxio.com.br/api/mcp. Se houver um campo de autenticação, selecione OAuth.
5. Crie a conexão, conclua a autorização no Braxio e confira as ferramentas apresentadas.
6. Abra uma nova conversa e adicione o Braxio pelo menu de ferramentas.

As confirmações de ações dependem das configurações do assistente e da ferramenta. Confira as permissões de leitura e escrita e revise os pedidos de confirmação, especialmente nas operações financeiras.

Escolher o escritório

O Braxio pede seu login, se necessário, e abre a autorização. Confira o assistente, escolha o escritório e autorize. Só aparecem escritórios aos quais você tem acesso e nos quais a integração está habilitada.

A autorização vale para um escritório só. Se você participa de mais de um, faça uma conexão para cada um.

O que o assistente pode acessar

As permissões são as mesmas de Config › Equipe, e valem exatamente igual:

• Completo: o assistente trabalha com todos os registros daquele módulo.
• Atribuído: só os registros que você já podia acessar.
• Visualizar: ele consulta, mas não edita.
• Sem acesso: o módulo inteiro fica fora da conexão.

Se a sua permissão mudar no Braxio, o acesso do assistente muda junto, na hora.

Nada é apagado de verdade

Quando o assistente remove um registro, ele vai para a Lixeira, igual a uma remoção feita por você na tela. Ele não esvazia a Lixeira nem exclui em definitivo. Projeto, lead, cadastro ou tarefa arquivados pelo assistente continuam recuperáveis.

Em alterações em lote e em qualquer coisa que mexa em dinheiro, leia o resumo antes de confirmar. Quando houver nome parecido, peça para ele listar as opções primeiro, ou diga: "mostre o que vai mudar sem executar ainda."

Ver o que os assistentes fizeram

Em Config › Integrações, a página de cada assistente traz a atividade recente: o que foi criado, alterado ou arquivado por um assistente, por quem e quando. A lista mostra só o que passou por assistente, não o que foi feito na tela.

Entram na lista: tarefas, projetos, leads, cadastros, obra, agenda, lançamentos financeiros, contas bancárias, transferências, custos fixos e apontamento de horas.

Nos orçamentos, a lista registra criar, aprovar, compartilhar e excluir o orçamento, mas ainda não registra mudanças nos itens dele, como incluir uma linha, alterar um preço ou aplicar um modelo. Para conferir isso, abra o orçamento e veja o histórico dele.

Desconectar

Em Config › Integrações, abra o assistente e selecione Desconectar na conexão. O acesso é encerrado na hora, e as próximas chamadas daquela conexão são recusadas. Para voltar a usar, é só conectar e autorizar de novo.

Administradores do escritório podem desconectar a conexão de qualquer pessoa. Você também pode remover o Braxio pelas configurações de conectores do próprio assistente.

Quando a conexão não aparece ou está desatualizada

Se o escritório não aparece na autorização, confira se entrou com a conta correta e se a integração está habilitada nele. Se a opção de criar a conexão estiver ausente no assistente, consulte as permissões da conta ou o responsável pela organização.

No ChatGPT, conexões criadas em modo desenvolvedor podem atualizar a lista de ferramentas: abra o Braxio em Plugins, selecione Refresh e comece uma nova conversa. Esse procedimento é para a conexão personalizada; a lista de ferramentas do plugin do diretório só muda após revisão e publicação de uma nova versão.

Os caminhos foram conferidos em 14/09/2026 na documentação do ChatGPT e no guia de conectores personalizados do Claude.

Privacidade

O que sai do Braxio, o que fica registrado e o que o provedor do assistente recebe está na política de privacidade do conector.