MCP do Crivo: como conectar uma IA aos dados do mercado brasileiro

O MCP do Crivo permite que um cliente compatível consulte ferramentas de dados por uma conexão HTTP remota. A conexão usa X-API-Key e exige o acesso comercial correspondente. Não é necessário presumir um pacote local chamado crivo-mcp: o servidor está em https://api.crivo.ai/mcp/.

Conectar o servidor dá ao agente uma forma de solicitar dados estruturados. Ainda é preciso conferir qual ferramenta foi chamada, seus argumentos e o período retornado. A integração não transforma todo texto gerado pela IA em informação verificada.

Confira o transporte e a autenticação do cliente

O cliente precisa suportar o transporte HTTP do servidor e permitir o envio do header X-API-Key. Uma configuração para outro provedor ou um exemplo de servidor local por stdio não é automaticamente compatível.

No formato portable da documentação do Crivo, a configuração usa mcpServers, type http e a URL remota. O VS Code também tem seu próprio formato de arquivo e opções de execução. Consulte a documentação da versão utilizada para distinguir servers de mcpServers e o tratamento de variáveis de entrada. A configuração abaixo é uma referência do formato portable, não um relato de instalação em todos esses clientes.

{
  "mcpServers": {
    "crivo": {
      "type": "http",
      "url": "https://api.crivo.ai/mcp/",
      "headers": {
        "X-API-Key": "SUA_CHAVE_NO_GERENCIADOR_DE_SEGREDOS"
      }
    }
  }
}

O valor mostrado é um placeholder. Insira o segredo pelo mecanismo seguro do seu cliente e não compartilhe um arquivo que contenha a chave. Se o cliente não suportar o header necessário, a configuração precisa ser revista antes de tentar consultar dados.

Descubra as ferramentas antes de pedir uma análise

O catálogo de ferramentas informa nomes, argumentos e campos obrigatórios. Leia tools/list na sessão negociada. O nome de uma capacidade HTTP não garante que exista uma ferramenta MCP equivalente com o mesmo nome ou os mesmos filtros.

Na verificação autenticada de 11 de outubro de 2026, o servidor anunciou 26 ferramentas. A inicialização negociou a versão 2025-03-26 do protocolo. O teste usou um cliente HTTP em Python e conferiu a consulta crivo_get_ohlc contra a resposta HTTP equivalente. Não foi um teste de instalação no aplicativo VS Code.

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "crivo_get_ohlc",
    "arguments": {
      "ticker": "TOTS3",
      "limit": 5
    }
  }
}

Esse é o corpo JSON-RPC da consulta usada no teste, depois da inicialização. O cliente precisa encaminhá-lo na sessão negociada e preservar os headers de autenticação e protocolo; colar apenas o JSON não abre uma sessão MCP.

Uma primeira consulta pequena de OHLC ajuda a testar transporte, argumentos e resposta. Depois confronte uma amostra com a consulta HTTP equivalente. Para fundamentos, leia as datas e intervalos de provenance; para relatórios, abra as fontes originais que sustentam a resposta.

Na consulta realizada, os cinco fechamentos de TOTS3, de 5 a 9 de outubro, coincidiram com o HTTP, assim como abertura, máxima, mínima e volume. Esse teste verifica uma ferramenta e uma amostra; não certifica todas as ferramentas do catálogo nem a interpretação feita por uma IA.

Separe uma consulta de dados de uma execução de IA

Algumas ferramentas consultam séries e cadastros; outras executam fluxos que podem consumir recursos de IA. Descobrir uma ferramenta não é autorização para chamar todas elas, e a disponibilidade de um nome não prova cobertura suficiente para qualquer pergunta.

Comece com dados pequenos e uma pergunta específica. Um pedido útil é: “Consulte os fundamentos de uma empresa, identifique a referência contábil e o intervalo do lucro, mostre as fontes disponíveis e diga o que falta para concluir.” Isso facilita a revisão antes de solicitar uma análise mais ampla.

O MCP não substitui o sistema editorial do blog e não deve receber a chave de publicação como se ela fosse acesso comercial às ferramentas. As duas credenciais têm funções distintas.

Quando uma conexão falhar

Problemas de autenticação pedem revisão da chave e do header. Restrições de acesso pedem conferência do entitlement comercial. Uma chamada com argumentos inválidos pede leitura do schema real da ferramenta. Repetir a mesma solicitação não resolve essas três situações.

Em uma sessão do protocolo utilizado na verificação, o cliente preserva o identificador e a versão negociados nas chamadas seguintes. Uma sessão encerrada ou perdida exige uma nova inicialização. Clientes e revisões recentes do protocolo podem oferecer outros modos; não misture esses formatos sem verificar a compatibilidade do servidor.

O resultado esperado de uma configuração bem conferida é uma consulta rastreável, com argumentos e dados que podem ser examinados. A interpretação financeira continua precisando de revisão. Uma IA com acesso a uma fonte pode usar a unidade errada ou confundir semestre com trimestre, mesmo quando o transporte funcionou.