O Claude consulta ações brasileiras sem que você cole uma planilha a cada conversa. Conecte o servidor MCP da brapi e pergunte em português.
A conexão dá acesso a cotações, históricos, dividendos, indicadores e demonstrativos. A divisão de trabalho é clara: a brapi busca os números, o Claude organiza a resposta.
Escolha o cliente Claude
Claude Desktop para quem prefere interface visual, Claude Code para quem vive no terminal. Os dois falam com o servidor MCP da brapi.
Este artigo é sobre o uso sem programação. Não tem chamada de API para escrever: você adiciona a conexão e autoriza a conta.
Abra o guia do MCP da brapi e selecione a aba do seu cliente. Quando o Claude pedir o endereço do servidor, use esta URL:
https://brapi.dev/api/mcp/mcpClientes com OAuth abrem o navegador para você autorizar. Depois disso, confirme que a brapi aparece na lista de ferramentas.
Teste a conexão com uma cotação
Faça uma pergunta pequena antes de pedir uma análise longa:
Use a brapi para consultar PETR4.
Mostre a última cotação disponível, a variação, a moeda e a data.
Informe qual ferramenta foi usada.
Não recomende compra ou venda.Veja se o Claude realmente chamou a ferramenta. Uma resposta bem escrita sobre a Petrobras não é a mesma coisa que uma cotação consultada. Se ele responder de memória, peça a consulta de forma explícita.
Compare ações com o mesmo período
O Claude lida bem com tabelas e textos longos, e é justamente por isso que ele entrega uma comparação bonita entre datas diferentes se você não fixar período e campos.
Use a brapi para comparar PETR4, VALE3 e ITUB4.
Mostre preço, variação, volume e valor de mercado.
Use a mesma data de referência quando possível.
Explique qualquer diferença de data.Para comparar fundamentos:
Consulte P/L, P/VP, ROE, margem líquida e dívida de PETR4 e VALE3.
Mostre primeiro uma tabela com valores e datas.
Depois explique as diferenças sem escolher uma vencedora.
Preserve campos null.Tabela bem formatada esconde campo mal interpretado. Quando a unidade ou a fórmula não estiver clara, confira o dicionário da brapi.
Leia demonstrativos sem misturar períodos
Empresas divulgam balanço, DRE e fluxo de caixa por período. Comparar um número anual com um trimestral dá uma diferença de quatro vezes que não significa nada.
Consulte as quatro DREs trimestrais mais recentes de VALE3 na brapi.
Mostre receita, resultado operacional e lucro líquido.
Identifique o encerramento de cada trimestre.
Não misture valores anuais e trimestrais.Você também pode pedir uma análise do caixa:
Consulte o fluxo de caixa anual de PETR4.
Separe atividades operacionais, investimento e financiamento.
Mostre os valores e o período de cada demonstração.
Não calcule campos que não existem na resposta.Para revisar a explicação do Claude, o artigo sobre como ler balanço patrimonial serve de referência.
Guarde um formato que você possa repetir
Análise recorrente pede estrutura fixa. Salve um prompt com campos, período e regras de conferência, e troque só o ticker.
Use a brapi para criar uma ficha de PETR4.
Mostre perfil, última cotação disponível, múltiplos, dividendos e último balanço.
Inclua a data de cada grupo de dados.
Preserve null e não use estimativas.
Separe dados de interpretação.Pedir tudo que a empresa já publicou não ajuda. Ficha curta é mais fácil de revisar e deixa as lacunas visíveis. Quando um ponto merecer atenção, abra outra conversa só sobre ele, em vez de deixar uma resposta gigante misturar preço de hoje com balanço de dois anos atrás.
Consulte dividendos com as datas certas
Peça data-com e pagamento de forma separada:
Consulte dividendos e JCP de ITUB4 nos últimos 24 meses.
Mostre tipo, valor por ação, data-com e pagamento.
Some os valores por ano e mostre a conta.
Não projete dividendos futuros.O total recebido depende de quantas ações você tinha na data-com. O histórico da empresa não sabe nada sobre a sua posição na corretora.
Peça uma revisão crítica
O Claude escreve conclusões limpas mesmo quando os dados estão pela metade. Um segundo pedido separa fato de leitura:
Revise a análise anterior.
Liste os dados consultados, as datas e as unidades.
Separe fatos da brapi de interpretações do modelo.
Mostre quais informações faltam para uma conclusão mais segura.O Claude não conhece sua carteira
A conexão consulta dados de mercado. Ela não acessa suas posições, seu preço médio ou seus objetivos, salvo quando você fornece essas informações.
Nunca cole senha ou token na conversa. O fluxo de autorização do cliente existe para isso. Revogue a conexão quando parar de usar.
Conecte o Claude na página do MCP da brapi e faça o teste com PETR4.
