GitHub Copilot no VS Code com Dados da B3 via MCP: Agent Mode e o mcp.json para Ações Brasileiras (2026)

O que muda com MCP no Copilot

O MCP é um padrão aberto que conecta modelos de linguagem a ferramentas e fontes de dados externas. No VS Code, ele estende o Copilot: cada servidor declarado no mcp.json expõe funções que o modelo pode invocar durante a conversa. Um servidor de dados da B3, como o bolsai-mcp, entrega cotações, fundamentos e dividendos sem que você saia do editor.

Há um detalhe que derruba a maioria das primeiras tentativas: no VS Code, as ferramentas MCP só ficam disponíveis em agent mode. Nos modos Ask e Edit do Copilot Chat, elas simplesmente não aparecem no seletor e não podem ser chamadas. Quem testa a integração no modo Ask conclui que "não funcionou", quando na verdade estava no modo errado.

A diferença de fluxo em relação a um chatbot comum é grande. Em vez de você copiar o P/L de um site e colar no prompt, o próprio agente decide chamar get_fundamentals, recebe o JSON, interpreta os números e continua a tarefa, tudo dentro do VS Code, junto do código que você está escrevendo.

Pré-requisitos

Antes de configurar, garanta que o ambiente atende a estes quatro pontos:

• VS Code recente: uma versão atual do editor, com suporte a mcp.json e ao agent mode do Copilot já estável.
• Extensão GitHub Copilot: Copilot e Copilot Chat instalados e autenticados, com o agent mode disponível no dropdown de modo do chat.
• uv / uvx: o executor uvx, do gerenciador uv, que roda o servidor em um ambiente isolado. Instalável com curl -LsSf https://astral.sh/uv/install.sh | sh em sistemas Unix. Requer Python 3.10 ou superior.
• API key da bolsai: uma chave gerada no dashboard após o cadastro. O plano gratuito oferece 200 requisições por dia, sem cartão de crédito.

Adicionando o bolsai-mcp ao VS Code

.vscode/mcp.json do workspace vs configuração do usuário

O VS Code lê servidores MCP a partir de um arquivo mcp.json, e existem dois locais possíveis. O primeiro é o workspace: você cria .vscode/mcp.json na raiz do projeto e pode versioná-lo no Git, o que compartilha a configuração do servidor com toda a equipe. O segundo é o perfil do usuário: abra a Command Palette e execute MCP: Open User Configuration, que abre o mcp.json global, válido para todos os projetos.

Em ambos os casos, a chave raiz do arquivo é servers. A entrada mínima para o bolsai declara o comando, os argumentos e a variável de ambiente com a chave de API:

// .vscode/mcp.json  (ou o mcp.json do usuário)
{
  "servers": {
    "bolsai": {
      "command": "uvx",
      "args": ["bolsai-mcp"],
      "env": {
        "BOLSAI_API_KEY": "sk_sua_chave_aqui"
      }
    }
  }
}

Atenção à chave raiz: no VS Code é servers, dentro do arquivo mcp.json. Isso é diferente do Claude Desktop, que usa mcpServers no claude_desktop_config.json. Copiar a configuração de um guia do Claude sem trocar a chave raiz é o erro de configuração mais comum. O formato da entrada (command, args, env) é o mesmo entre os dois; só o invólucro muda.

Iniciar o servidor, ativar o Agent mode e o tool picker

Assim que o arquivo é salvo, o VS Code detecta a mudança e oferece iniciar o servidor. O editor (re)inicia o processo automaticamente a cada alteração de configuração, então não é preciso reabrir a janela após editar o mcp.json. Se o servidor não iniciar sozinho, um botão de start aparece acima da entrada no próprio arquivo.

Com o servidor ativo, abra o Copilot Chat e troque o dropdown de modo para Agent. Esse passo é obrigatório: sem o agent mode, o próximo botão nem existe. Em seguida, clique em Configure Tools no campo de mensagem para abrir o tool picker e marque as ferramentas do servidor bolsai que deseja liberar para a requisição. É possível ativar todas ou apenas um subconjunto, como get_fundamentals e screen_stocks.

A primeira invocação de cada ferramenta pede confirmação. O VS Code mostra os argumentos que o agente pretende enviar antes de executar, o que mantém a chamada auditável. A partir daí, o Copilot passa a considerar as ferramentas do bolsai como parte das ações disponíveis para resolver o que você pedir.

Uma tarefa de agente ponta a ponta

"Analise WEGE3 e escreva o resumo em markdown"

O melhor teste de uma integração de agente é uma tarefa que combina consulta de dados e produção de arquivo. Com o Copilot em agent mode e as ferramentas do bolsai habilitadas, um prompt curto dispara uma sequência de chamadas e termina com um arquivo escrito no workspace.

# Prompt no Copilot Chat (agent mode)
Analise WEGE3: puxe os fundamentos, compare com
EMBR3 e ROMI3 e escreva um resumo em analise-wege3.md

# O agente encadeia as ferramentas do bolsai:
# 1. get_fundamentals({"ticker": "WEGE3"})
#    -> pl=28.46, pvp=11.2, roe=39.5, net_margin=17.2

# 2. compare_stocks(
#      {"tickers": ["WEGE3", "EMBR3", "ROMI3"]})
#    -> P/L: 28.46 / 11.9 / 8.4

# 3. O agente cria analise-wege3.md no workspace

O arquivo gerado sai pronto para revisão, com os números vindos direto da API e a leitura textual escrita pelo modelo:

# analise-wege3.md (trecho gerado)
## WEGE3: resumo fundamentalista

- P/L: 28.46 (setor industrial ~10-12)
- P/VP: 11.2
- ROE: 39.5%
- Margem líquida: 17.2%

WEGE3 negocia com prêmio relevante frente a EMBR3 e
ROMI3. O múltiplo alto é sustentado por ROE de 39.5% e
margem líquida bem acima dos pares, o que reflete
qualidade operacional, não sobrepreço especulativo.

O campo pl vem do endpoint /fundamentals/WEGE3 e é calculado com lucro líquido TTM e o preço de fechamento mais recente. A metodologia por trás de cada indicador está descrita na documentação do MCP da bolsai e no detalhamento dos endpoints em /docs.

Screening no editor com screen_stocks

A ferramenta screen_stocks transforma um filtro fundamentalista em pergunta. Em vez de montar consultas em um dashboard, você descreve o critério e o agente traduz para os parâmetros da ferramenta, útil quando o resultado precisa virar código ou um arquivo no projeto.

# Prompt no Copilot Chat (agent mode)
Liste ações da B3 com ROE acima de 15% e P/L abaixo
de 12. Salve como tickers_valor.csv

# O agente chama:
# screen_stocks(
#   {"roe_gt": 15, "pl_lt": 12, "sort": "roe_desc"})

# Retorno (trecho) e gravação em CSV:
ticker,pl,roe,setor
BBSE3,9.10,35.2,Seguros
BBAS3,4.56,21.3,Bancos
ITUB4,9.87,21.3,Bancos
CPLE6,5.89,18.5,Utilities

Como a chamada de ferramenta fica registrada no chat, o screening é reproduzível: qualquer pessoa que abra a conversa vê exatamente quais filtros foram aplicados. O conjunto completo de parâmetros aceito por screen_stocks está documentado em /docs.

VS Code vs outros clientes MCP

O bolsai-mcp é o mesmo servidor em qualquer cliente compatível; o que muda é o nome do arquivo e da chave raiz onde o servidor é declarado. Vale conhecer as diferenças para não copiar a configuração errada entre guias.

Os passos equivalentes para cada ambiente têm guia próprio: o guia do bolsai-mcp com Claude, a configuração no Windsurf, a integração no Cursor e o uso no terminal com Claude Code. Para escolher entre as opções disponíveis, vale a comparação dos MCP servers de dados da B3.

Troubleshooting

As ferramentas não aparecem no chat

Causa quase certa: o Copilot Chat não está em agent mode. Ferramentas MCP são invisíveis nos modos Ask e Edit. Abra o dropdown de modo do chat, selecione Agent e depois Configure Tools para habilitar as ferramentas do servidor bolsai. Se o botão de tools nem existe, o chat continua em outro modo.

O servidor não inicia

Verifique se o uvx está instalado e no PATH, rodando uvx --version em um terminal. Se o comando não for encontrado, instale o uv e reabra o VS Code para que o novo PATH seja carregado. Confira também a sintaxe do mcp.json: a chave raiz precisa ser servers, não mcpServers, e uma vírgula fora do lugar impede o parsing. Salvar o arquivo faz o editor reiniciar o servidor automaticamente.

Erros 401 ou 429

401 Unauthorized indica problema na chave: verifique se BOLSAI_API_KEY no bloco env está correta, sem espaços invisíveis, e se a chave não foi revogada no dashboard. 429 Too Many Requests significa que o limite diário foi atingido. No plano gratuito são 200 requisições em 24h, e uma tarefa de agente com muitas chamadas encadeadas consome rápido essa cota. A solução é aguardar a janela resetar ou migrar para o plano Pro (R$49/mês, 10.000 requisições/dia). A autenticação usa o cabeçalho X-API-Key por baixo dos panos.

Perguntas frequentes

As ferramentas MCP funcionam no modo Ask do Copilot?

Não. No VS Code, as ferramentas de servidores MCP só ficam disponíveis quando o Copilot Chat está em agent mode. Nos modos Ask e Edit elas não aparecem no tool picker e não podem ser chamadas. Para usar o bolsai-mcp, troque o dropdown de modo do Copilot Chat para Agent e habilite as ferramentas no botão Configure Tools do campo de mensagem.

Onde fica o mcp.json no VS Code?

Há dois locais. No workspace, o arquivo é .vscode/mcp.json, criado na raiz do projeto e versionável no Git para compartilhar a configuração com a equipe. No perfil do usuário, o arquivo é aberto pelo comando MCP: Open User Configuration na Command Palette e vale para todos os projetos. Em ambos, a chave raiz é servers.

Preciso do Copilot pago para usar MCP no VS Code?

É necessário ter o GitHub Copilot ativo no VS Code com o agent mode disponível, já que as ferramentas MCP só rodam nesse modo. O plano do Copilot é cobrado pela GitHub e é independente da bolsai. O acesso aos dados da B3 usa a API bolsai, cujo plano gratuito oferece 200 requisições por dia sem cartão de crédito.

Como o Copilot acessa dados da B3?

O Copilot em agent mode chama as ferramentas expostas pelo servidor bolsai-mcp, que roda localmente via uvx. Cada ferramenta (get_fundamentals, get_stock_quote, screen_stocks e outras) consome os endpoints da API bolsai, autenticando com a chave definida em BOLSAI_API_KEY. Os dados vêm de fontes oficiais como CVM, B3 e Banco Central, processados pela bolsai e devolvidos ao modelo em JSON.

Leia também

Referências

• code.visualstudio.com: Use MCP servers in VS Code
• docs.github.com: Extending Copilot Chat with MCP
• modelcontextprotocol.io: especificação do Model Context Protocol

O conteúdo deste artigo tem caráter educacional e técnico. Passos de interface e nomes de comandos do VS Code e do GitHub Copilot podem mudar entre versões; consulte a documentação oficial ao configurar. Os dados citados refletem valores públicos disponíveis no momento da publicação e podem mudar. Nada aqui constitui recomendação de compra ou venda de ativos financeiros. Nomes de produtos e marcas pertencem aos respectivos titulares; VS Code e GitHub Copilot são marcas da Microsoft e da GitHub, e Model Context Protocol é marca da Anthropic PBC.