01 · Visão geral
O que o conector faz
A Bravora é um ecossistema de crédito privado que conecta originadores, assessores e consultores ao mercado de capitais. No app da Bravora, cada parceiro acompanha a própria carteira: empresas, sócios, operações de crédito, documentos pendentes e o andamento de cada etapa.
O conector usa o padrão aberto Model Context Protocol (MCP) para levar essa carteira ao Claude. Com ele, você pode:
- Consultar as operações que você enxerga no app, com etapa, valor e próximos passos.
- Ver o que falta: documentos pendentes ou recusados de cada operação, por responsável.
- Acompanhar as suas tarefas abertas, vencidas e de hoje.
- Consultar um CNPJ na base pública da Receita Federal e o resultado do Compliance de uma operação.
- Cadastrar empresa, sócio ou contato e abrir uma operação, sempre com prévia e confirmação sua antes de gravar.
O conector trabalha com o seu login: o Claude vê e faz só o que as suas permissões deixam no app. Um parceiro vê apenas a própria carteira.
02 · Requisitos
Antes de conectar
- Uma conta ativa no app da Bravora (app.bravoracap.com). O acesso é para parceiros cadastrados e para o time da Bravora. Para ser parceiro, fale conosco.
- A permissão Conectores no seu perfil de acesso. Ela vem ligada por padrão para os membros dos parceiros; se o conector recusar, peça ao administrador da sua conta.
- O conector ligado para a sua organização. O administrador da Bravora pode ligar ou desligar o canal MCP no geral ou por parceiro.
- Uma conta no Claude com acesso a conectores (claude.ai, Claude Desktop ou Claude no celular).
03 · Passo a passo
Como conectar no Claude
URL do servidor MCP
O servidor usa o transporte Streamable HTTP e fica na infraestrutura do app da Bravora, a mesma que guarda os dados da sua carteira.
Pelo diretório de conectores do Claude
- No Claude, abra Configurações → Conectores e clique em Procurar conectores.
- Busque por Bravora e clique em Conectar.
- Abre uma janela do app da Bravora. Entre com o seu e-mail e senha da Bravora (e o segundo fator, se estiver ligado).
- Na tela de autorização, confira o nome do aplicativo e o endereço de retorno (
claude.ai) e clique em Aprovar. - De volta ao Claude, o conector aparece como conectado. Em cada conversa, ligue ou desligue a Bravora no menu de ferramentas.
Como conector personalizado (pela URL)
- No Claude, abra Configurações → Conectores → Adicionar conector personalizado.
- Dê o nome Bravora e cole a URL do servidor acima. Não é preciso preencher Client ID nem segredo: o Claude se registra sozinho.
- Clique em Conectar e siga os passos 3 a 5 acima.
Times e empresas
Em planos Team e Enterprise do Claude, o proprietário da organização pode precisar liberar o conector antes que os membros consigam conectar.
04 · Segurança
Autenticação e permissões
A conexão usa OAuth 2.1 com PKCE (S256) e registro dinâmico de cliente. O servidor de autorização é o mesmo login do app da Bravora. O Claude nunca vê a sua senha: você entra na página da Bravora e aprova o acesso.
- O token é a sua sessão. Cada chamada roda com o seu usuário, sob as mesmas regras de acesso do banco de dados que valem no app.
- A carteira é respeitada. Um parceiro só enxerga empresas, contatos e operações da própria carteira. O time interno da Bravora enxerga conforme o seu papel.
- As ferramentas seguem as permissões. Cada ferramenta exige a permissão do módulo correspondente (por exemplo, Oportunidades: criar para abrir operação). Quem não tem a permissão não recebe a ferramenta.
- As travas do app continuam valendo. Etapas, aprovações e validações de cadastro são as mesmas da tela; o conector não as contorna.
- Cada chamada fica registrada (data, ferramenta, resultado e duração) para segurança e auditoria.
05 · Referência
Ferramentas disponíveis
São dez ferramentas: sete de leitura e três de cadastro. As de leitura são marcadas como somente leitura (readOnlyHint); as de cadastro, como escrita. Nenhuma ferramenta apaga ou altera dados existentes.
| Ferramenta | O que faz | Tipo | Permissão no app |
|---|---|---|---|
Listar operaçõeslistar_operacoes |
Operações que você pode ver, com etapa e valor. Filtros por texto e etapa; até 50 por chamada. | Leitura | Oportunidades: ver |
Status de uma operaçãostatus_operacao |
Etapa, próximos passos, pendências abertas e última movimentação de uma operação, por nome ou id. | Leitura | Oportunidades: ver |
Pendências de documentospendencias_operacao |
Documentos que faltam ou foram recusados numa operação, separados por responsável (parceiro ou analista). | Leitura | Oportunidades: ver |
Minhas tarefastarefas_minhas |
As suas tarefas no app: abertas, vencidas ou de hoje. | Leitura | Nenhuma adicional |
Consultar CNPJconsultar_cnpj |
Razão social, situação cadastral, CNAE, município e quadro societário pela base pública da Receita Federal (resultado guardado por 30 dias). | Leitura | Nenhuma adicional |
Compliance de uma operaçãoconsultar_compliance |
Resultado das consultas de Compliance já feitas para a operação (Receita, embargos do Ibama, cadastros de sanções da CGU), por pessoa ou empresa, e o que ainda falta consultar. Não dispara consulta nova. | Leitura | Compliance: ver |
Anexar documentoanexar_documento |
Devolve o link da operação no app para você anexar os arquivos e a lista do que falta. O arquivo não passa pelo conector. | Leitura | Oportunidades: ver |
Cadastrar empresacriar_empresa |
Cadastra uma empresa na sua carteira pelo CNPJ, com os dados da Receita. Dois passos: prévia e confirmação. | Escrita | Empresas: criar |
Cadastrar sócio ou contatocriar_contato |
Cadastra uma pessoa física (sócio, administrador ou produtor rural) e, se informada a empresa, o vínculo com cargo e participação. Dois passos. | Escrita | Contatos: criar |
Abrir operaçãocriar_operacao |
Abre uma operação de crédito para um tomador já cadastrado. A lista de documentos da operação nasce sozinha, como no app. Dois passos. | Escrita | Oportunidades: criar |
A lista que o Claude recebe é montada para cada pessoa no momento da conexão. Se o seu perfil não tem uma permissão, a ferramenta correspondente não aparece.
06 · Escrita com confirmação
Cadastro em dois passos
Nenhum cadastro é gravado sem a sua aprovação. As três ferramentas de escrita funcionam assim:
- Prévia. O Claude chama a ferramenta com os dados que você deu. A Bravora confere CNPJ, CPF, catálogos e carteira e devolve uma prévia com o que vai ser gravado e o que ainda falta. Nada é gravado neste passo.
- Confirmação. O Claude mostra a prévia. Só depois que você aprova ele chama a ferramenta de novo com
confirmar: true, e a gravação segue o mesmo caminho da tela do app, com a sua sessão.
Além disso, o Claude pede a sua confirmação antes de usar ferramentas de escrita, conforme as configurações de permissão do próprio Claude.
07 · Na prática
Exemplos de pedidos
- “Quais operações da minha carteira estão com documentos pendentes?”listar_operacoes, pendencias_operacao
- “Qual é o status da operação Agro Exemplo e qual o próximo passo?”status_operacao
- “O que tenho de tarefa vencida hoje na Bravora?”tarefas_minhas
- “Consulte o CNPJ 00.000.000/0001-91 e me diga a situação e os sócios.”consultar_cnpj
- “Cadastre na minha carteira a empresa deste CNPJ e abra uma operação de CCB de R$ 3 milhões em 24 meses.”criar_empresa, criar_operacao (com prévia)
- “Como está o Compliance da operação Fazenda Demo Dois? Tem algum apontamento grave?”consultar_compliance
08 · Limites
Limites do conector
- 60 chamadas por minuto por pessoa. Acima disso, o servidor responde com aviso de limite e volta a aceitar no minuto seguinte.
- Arquivos não passam pelo conector. Para anexar documentos, use o link que a ferramenta Anexar documento devolve.
- O conector não apaga, não aprova e não muda etapa. Aprovação de cadastro, avanço de etapa, análise de crédito e distribuição seguem no app, com as regras de cada etapa.
- Sem movimentação financeira. Nenhuma ferramenta transfere dinheiro ou ativos, nem envia mensagens a terceiros.
- Respostas resumidas. Listas trazem até 50 itens por chamada e respostas longas são cortadas; peça um filtro (etapa, nome) para refinar.
- Consulta de CNPJ usa a base pública da Receita Federal e guarda o resultado por 30 dias.
09 · Controle
Como revogar o acesso
Você pode desligar o conector a qualquer momento, por qualquer um dos lados:
- No Claude: Configurações → Conectores → Bravora → Desconectar (ou remover o conector).
- No app da Bravora: Configurações → Conectores → Conexões aprovadas → Desligar ao lado do Claude. O Claude perde a autorização e só volta a acessar se você aprovar de novo.
- Pela organização: o administrador pode retirar a permissão Conectores de uma pessoa ou desligar o canal MCP para todo o parceiro.
Usuário desativado no app perde o acesso pelo conector na hora.
10 · LGPD
Dados e privacidade
- O conector devolve ao Claude apenas o resultado da ferramenta pedida, dentro da sua carteira e das suas permissões.
- A Bravora recebe só os argumentos de cada chamada (por exemplo, o nome da operação ou o CNPJ). Ela não recebe nem guarda a conversa com o Claude.
- A Bravora não usa os dados que passam pelo conector para treinar modelos de inteligência artificial.
- O que o Claude faz com o conteúdo da conversa segue a política de privacidade da Anthropic e as configurações da sua conta no Claude.
O tratamento completo está na Política de Privacidade da Bravora, seção 9.
11 · Diagnóstico
Problemas comuns
- “Sessão vencida ou encerrada: conecte a Bravora de novo”
- A autorização expirou ou foi desligada no app. No Claude, desconecte e conecte a Bravora outra vez.
- “Sem permissão de Conectores” ou “MCP desligado para a sua organização”
- O seu perfil não tem a permissão Conectores ou o canal está desligado para o seu parceiro. Fale com o administrador da sua conta ou com a Bravora.
- “A ferramenta não está liberada para esta pessoa”
- O seu perfil não tem a permissão do módulo daquela ferramenta (por exemplo, Empresas: criar). A resposta lista as ferramentas que você tem.
- “Limite de 60 chamadas por minuto”
- Aguarde alguns segundos e repita o pedido.
- A janela de login abre e não volta para o Claude
- Confira se o navegador bloqueou a janela e se você entrou com a conta da Bravora certa. Se persistir, escreva para o suporte com o horário da tentativa.
12 · Contato
Suporte
Dúvidas sobre o conector, problemas de acesso ou questões de segurança: contato@bravoracap.com, com o assunto “Conector Claude”. Informe o e-mail da sua conta na Bravora, o horário e a mensagem de erro, se houver. Nunca envie a sua senha.
Telefone: (11) 96498-8899.
Summary in English
The Bravora connector links Claude to the Bravora app, a private-credit origination workspace used by Brazilian credit advisors. It is a remote MCP server (Streamable HTTP) at https://mcp.bravoracap.com, protected by OAuth 2.1 with PKCE and dynamic client registration. The access token is the user's own Bravora session, so every call runs under the same row-level security, portfolio scope and module permissions as the app.
It exposes ten tools: seven read-only (list deals, deal status, pending documents, my tasks, CNPJ lookup on the public Federal Revenue registry, compliance results, document upload link) and three write tools (create company, create partner/contact, open a deal). Write tools are two-step: the first call returns a preview and saves nothing; data is saved only on a second call with confirmar: true after the user approves. No tool deletes data, changes deal stages, moves money or uploads files. Limit: 60 calls per minute per user. Revoke access in Claude (Settings → Connectors) or in the Bravora app (Settings → Connectors → Approved connections). Support: contato@bravoracap.com.