Conectar um assistente de IA ao Braxio

O que a conexão faz

O Braxio pode ser conectado a assistentes compatíveis com MCP, como ChatGPT e Claude.

Depois da conexão, você pode pedir no próprio chat para consultar informações e executar ações no Braxio, por exemplo:

• localizar um projeto ou cliente;
• criar e editar tarefas, leads, projetos e cadastros;
• consultar relatórios e dados financeiros;
• lançar transações e organizar orçamentos ou obras.

As ações disponíveis dependem das ferramentas já publicadas pelo Braxio e das permissões da sua conta.

Endereço para conectar

Use este endereço ao configurar o assistente:

https://app.braxio.com.br/api/mcp

Escolha OAuth quando o assistente perguntar como autenticar. Você não precisa criar uma chave, copiar token nem informar a senha do Braxio ao assistente.

Conectar no ChatGPT

No ChatGPT:

1. Abra Settings > Security and login e ative Developer mode.
2. Abra Plugins e selecione o botão +.
3. Informe o nome Braxio e o endereço https://app.braxio.com.br/api/mcp.
4. Em autenticação, escolha OAuth.
5. Confirme o aviso de segurança e crie a conexão.

O ChatGPT abrirá a autorização do Braxio em seguida.

Conectar no Claude

Em uma conta Claude Pro ou Max:

1. Abra Customize > Connectors.
2. Selecione + > Add custom connector.
3. Informe o endereço https://app.braxio.com.br/api/mcp.
4. Conclua a configuração e selecione Connect.

Em contas Team ou Enterprise, um proprietário da organização precisa adicionar primeiro o conector em Organization settings > Connectors. Cada membro ainda conecta a própria conta individualmente.

Depois de configurado, habilite o Braxio na conversa pelo botão + > Connectors.

Autorizar no Braxio

Ao continuar no ChatGPT ou no Claude, o Braxio pede seu login caso a sessão não esteja aberta.

Na tela de autorização:

1. confira qual assistente está solicitando o acesso;
2. escolha o Escritório;
3. selecione Allow access.

Se você participa de mais de um escritório, a escolha vale somente para aquela conexão. Para usar outro escritório, crie outra conexão e escolha o escritório correto durante a autorização.

O que o agente pode acessar

O agente atua como a pessoa que fez a conexão. Ele não recebe acesso administrativo nem enxerga o banco de dados inteiro.

As permissões continuam sendo as mesmas configuradas em Equipe e Permissões:

• Completo: a ferramenta pode trabalhar com todos os registros permitidos naquele módulo.
• Atribuído: a ferramenta só recebe os registros que essa pessoa já pode acessar.
• Visualizar: a ferramenta pode consultar, mas não ganha permissão de edição.
• Sem acesso: as ferramentas daquele módulo não ficam disponíveis para a conexão.

Se a permissão da pessoa mudar no Braxio, o acesso do agente muda junto.

Arquivamento e Lixeira

Quando uma ferramenta permite remover um registro, ela o move para a Lixeira. O agente não pode esvaziar a Lixeira nem excluir definitivamente o conteúdo que está nela.

Assim, um projeto, lead, cadastro, tarefa ou outro registro arquivado pelo agente continua recuperável pela interface do Braxio.

Antes de confirmar uma ação

Leia o resumo apresentado pelo assistente, principalmente em alterações em lote e operações financeiras.

Quando houver nome parecido ou informação insuficiente, peça para o agente listar as opções antes de escolher. Você também pode pedir: “Mostre o que será alterado sem executar ainda.”

Desconectar e revogar o acesso

Há duas formas de encerrar uma conexão:

• no próprio chat, peça “Desconecte este agente do Braxio”;
• remova ou desconecte o Braxio nas configurações de Plugins ou Connectors do assistente.

Ao revogar pelo Braxio, as próximas chamadas daquela conexão são recusadas. Para voltar a usar, faça uma nova autorização.