Servidor MCP para IAs
O Model Context Protocol (MCP) permite que assistentes de IA acessem dados externos em tempo real. O servidor MCP da Brapi conecta LLMs aos dados financeiros brasileiros, permitindo consultas de cotações, históricos e indicadores econômicos durante conversas.
Início Rápido
Obtenha seu Token
- Acesse brapi.dev e crie uma conta gratuita
- No dashboard, gere sua chave de API
- Copie o token para usar na configuração
Configure seu Cliente
Escolha seu cliente MCP e siga as instruções específicas abaixo.
Faça sua Primeira Consulta
Com o MCP configurado, pergunte ao assistente:
Qual é a cotação atual da PETR4?Configuração por Cliente
Claude Code (CLI)
O Claude Code usa comandos CLI para gerenciar servidores MCP:
claude mcp add --transport http --header "Authorization:Bearer SEU_TOKEN" brapi https://brapi.dev/api/mcp/mcpVerificar instalação:
claude mcp listRemover servidor:
claude mcp remove brapiConfiguração Global vs. Projeto
- Sem flags: configuração local (
~/.claude.json) - Com
--scope project: configuração de projeto (.claude/settings.json) - Com
--scope user: configuração global do usuário
claude mcp add --transport http --header "Authorization:Bearer SEU_TOKEN" --scope project brapi https://brapi.dev/api/mcp/mcpClaude Desktop
Edite o arquivo de configuração:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"brapi": {
"command": "npx",
"args": [
"mcp-remote",
"https://brapi.dev/api/mcp/mcp",
"--header",
"Authorization:Bearer SEU_TOKEN"
]
}
}
}Reinicie o Claude Desktop após salvar.
Cursor
Configure em ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto):
{
"mcpServers": {
"brapi": {
"command": "npx",
"args": [
"mcp-remote",
"https://brapi.dev/api/mcp/mcp",
"--header",
"Authorization:Bearer ${BRAPI_API_KEY}"
],
"env": {
"BRAPI_API_KEY": "SEU_TOKEN"
}
}
}
}Reinicie o Cursor após salvar.
VS Code (Copilot)
Configure em .vscode/mcp.json ou nas configurações do usuário:
{
"mcp": {
"servers": {
"brapi": {
"command": "npx",
"args": [
"mcp-remote",
"https://brapi.dev/api/mcp/mcp",
"--header",
"Authorization:Bearer SEU_TOKEN"
]
}
}
}
}Requisitos
- VS Code 1.99+ ou VS Code Insiders
- Extensão GitHub Copilot atualizada
- Habilite
chat.mcp.enablednas configurações
n8n (Automação de Workflows)
O n8n suporta MCP nativamente através do MCP Client Tool node, permitindo criar automações com dados financeiros brasileiros.
Configuração:
- Adicione um node AI Agent ao seu workflow
- Conecte um MCP Client Tool node
- Configure as credenciais MCP:
{
"serverUrl": "https://brapi.dev/api/mcp/mcp",
"authentication": "Bearer Token",
"token": "SEU_TOKEN"
}Exemplo de Workflow:
Trigger → AI Agent → MCP Client Tool (brapi) → OutputCasos de Uso:
- Alertas automáticos de variação de preço
- Relatórios diários de carteira
- Integração com Slack/Discord para notificações
- Análise automatizada de mercado
Documentação n8n
Consulte a documentação oficial do MCP Client Tool para mais detalhes.
Outros Clientes Compatíveis
O servidor MCP da Brapi funciona com qualquer cliente compatível com o protocolo:
IDEs e Editores:
- Windsurf - IDE com IA integrada
- Cline - Assistente de desenvolvimento
- Zed - Editor colaborativo
- Continue - Extensão de IA para VS Code/JetBrains
- Amp - Agente de código autônomo
CLIs e Terminais:
- Amazon Q CLI - AWS AI assistant
- Gemini CLI - Google AI no terminal
- goose - CLI de IA de código aberto
Plataformas:
- ChatGPT - OpenAI (suporte MCP adicionado)
- Amazon Q Developer - IDE plugin
Configuração Genérica:
Para clientes que usam configuração JSON:
{
"mcpServers": {
"brapi": {
"command": "npx",
"args": [
"mcp-remote",
"https://brapi.dev/api/mcp/mcp",
"--header",
"Authorization:Bearer SEU_TOKEN"
]
}
}
}Para clientes que suportam HTTP direto:
- URL:
https://brapi.dev/api/mcp/mcp - Header:
Authorization: Bearer SEU_TOKEN
Ferramentas Disponíveis
O servidor MCP expõe 13 ferramentas para assistentes de IA:
Ferramentas Públicas (Sem Autenticação)
| Ferramenta | Descrição |
|---|---|
get_available_stocks | Lista ações, FIIs, BDRs e índices com filtros (setor, tipo) |
get_available_currencies | Lista pares de moedas disponíveis (USD-BRL, EUR-BRL, etc.) |
get_available_cryptocurrencies | Lista criptomoedas disponíveis (BTC, ETH, etc.) |
get_available_inflation_countries | Lista países com dados de inflação |
Ferramentas Premium (Requer Token)
| Ferramenta | Descrição |
|---|---|
get_stock_quotes | Cotações e histórico de ações, FIIs, BDRs |
get_currency_rates | Taxas de câmbio em tempo real |
get_crypto_prices | Preços de criptomoedas em BRL e outras moedas |
get_inflation_data | Dados de inflação (IPCA, IGPM) |
get_prime_rate_data | Taxa SELIC e histórico |
get_option_expirations | Vencimentos de opções disponíveis para um ativo subjacente |
get_option_strikes | Strikes disponíveis de opções para um subjacente + vencimento |
get_option_chain | Cadeia de séries negociadas (OHLCV) em um vencimento |
get_option_historical | Histórico diário EOD (OHLCV, bid/ask, volume) de uma série |
Exemplos de Consultas
Análise de Ações
Analise o desempenho da PETR4 no último mês e compare com VALE3Quais são as 5 ações com maior volume de negociação hoje?Liste todas as empresas do setor financeiro ordenadas por valor de mercadoCâmbio e Criptomoedas
Qual é a cotação atual do dólar?Compare o preço do Bitcoin e Ethereum em reaisIndicadores Econômicos
Qual é a taxa SELIC atual e como ela evoluiu nos últimos 12 meses?Mostre a inflação (IPCA) acumulada no anoDescoberta de Mercado
Liste os fundos imobiliários com maior volumeQuais BDRs estão disponíveis na B3?Opções (Plano Pro)
Quais são os vencimentos de opções disponíveis para PETR4?Mostre os strikes de calls de PETR4 para o vencimento de 15/05/2026Qual foi o histórico diário da opção PETRE370 no último mês?Filtros Avançados
A ferramenta get_available_stocks suporta filtros para consultas específicas:
Por Setor:
Finance- Bancos e financeirasEnergy Minerals- Petróleo e energiaTechnology Services- TecnologiaHealth Services- SaúdeRetail Trade- VarejoUtilities- Energia elétrica e saneamento
Por Tipo:
stock- Ações ordinárias e preferenciaisfund- Fundos imobiliários (FIIs)bdr- Brazilian Depositary Receipts
Ordenação:
volume- Volume de negociaçãomarket_cap_basic- Valor de mercadochange- Variação percentualclose- Preço de fechamentoname- Ordem alfabética
Solução de Problemas
Erros de Conexão
"Connection refused" ou "Network error"
- Verifique sua conexão com a internet
- Confirme que a URL está correta:
https://brapi.dev/api/mcp/mcp - Teste a conexão manualmente:
curl -I https://brapi.dev/api/mcp/mcpProblemas de TLS/Certificado
Adicione a flag --experimental-fetch:
{
"mcpServers": {
"brapi": {
"command": "npx",
"args": [
"--node-options=--experimental-fetch",
"mcp-remote",
"https://brapi.dev/api/mcp/mcp",
"--header",
"Authorization:Bearer SEU_TOKEN"
]
}
}
}Erros de Token
"Token de autenticação obrigatório" (TOKEN_REQUIRED)
- Ferramentas premium requerem token válido
- Verifique se o header Authorization está configurado corretamente
- Formato correto:
Authorization: Bearer SEU_TOKEN
"Token de API inválido ou expirado" (TOKEN_INVALID)
- Acesse o dashboard da Brapi
- Verifique se o token está ativo
- Regenere o token se necessário
- Certifique-se de não ter espaços extras
Ferramentas Públicas
As ferramentas get_available_* funcionam sem token para testes:
Liste as ações disponíveis na B3Erros de Runtime
"ERR_MODULE_NOT_FOUND"
Use bunx em vez de npx:
{
"mcpServers": {
"brapi": {
"command": "bunx",
"args": [
"mcp-remote",
"https://brapi.dev/api/mcp/mcp",
"--header",
"Authorization:Bearer SEU_TOKEN"
]
}
}
}Alternativa com Deno:
{
"mcpServers": {
"brapi": {
"command": "deno",
"args": [
"run",
"--allow-env=NO_DEPRECATION,TRACE_DEPRECATION",
"--allow-net",
"npm:mcp-remote",
"https://brapi.dev/api/mcp/mcp",
"--header",
"Authorization:Bearer SEU_TOKEN"
]
}
}
}Node.js Versão
Certifique-se de usar Node.js v18 ou superior:
node --versionAutenticação
O servidor MCP suporta os mesmos métodos de autenticação da API REST:
| Método | Exemplo | Recomendado |
|---|---|---|
| Header Bearer | Authorization: Bearer sua_chave_api | Sim |
| Header Simples | Authorization: sua_chave_api | Sim |
| Query Parameter | ?token=sua_chave_api | Não |
Limites e Planos
As requisições MCP seguem os mesmos limites da API REST:
| Plano | Requisições/mês | Ideal para |
|---|---|---|
| Gratuito | 15.000 | Testes e projetos pessoais |
| Startup | 150.000 | Startups e pequenas empresas |
| Pro | 500.000 | Aplicações de alto volume |
Segurança
O servidor MCP implementa:
- Autenticação obrigatória para ferramentas premium
- Transmissão segura via HTTPS/TLS
- Validação de tokens a cada requisição
- Validação de parâmetros de entrada
- Rate limiting baseado no plano
Clientes Compatíveis
O protocolo MCP é suportado por mais de 100 clientes. Os mais populares:
| Cliente | Tipo | Configuração |
|---|---|---|
| Claude Code | CLI | claude mcp add |
| Claude Desktop | Desktop App | JSON config |
| Cursor | IDE | JSON config |
| VS Code | IDE | JSON config |
| Windsurf | IDE | JSON config |
| n8n | Automação | MCP Client Tool node |
| Cline | VS Code Extension | JSON config |
| Continue | IDE Extension | JSON config |
| Amazon Q | CLI/IDE | JSON config |
| goose | CLI | JSON config |
Lista completa de clientes MCP
Próximos Passos
Aviso Legal
Os dados são fornecidos apenas para fins informativos e não constituem aconselhamento financeiro. Consulte sempre um profissional qualificado antes de tomar decisões de investimento.