# Configuração do Eqvero MCP: Claude Code

## O que é conectado

A Eqvero fornece dados de empresas dos EUA e de Hong Kong, busca de divulgações originais, análise de empresas e cálculos financeiros. O MCP conecta as ferramentas. O Skill orienta a análise e não é necessário para a conexão.

## Antes da instalação

1. Confira cliente, sistema operacional e configuração MCP existentes. Explique local e escopo das mudanças; mescle só após confirmação do usuário, preservando outros servidores.
2. É necessária chave dedicada da Eqvero e acesso da conta à API/MCP. Crie em https://eqvero.com/pt-br/developers?tab=keys. Sem chave, peça inserção segura neste dispositivo; não solicite a chave completa na conversa.
3. Não altere modelos, configurações globais da conta nem outras ferramentas de busca. Não sobrescreva credenciais válidas nem coloque chaves em URLs, logs, repositórios públicos ou arquivos compartilhados.

## Configuração

URL do servidor: https://eqvero.com/api/mcp
Transporte: Streamable HTTP
Autenticação: Authorization: Bearer <EQVERO_API_KEY>
Nome do servidor: eqvero

Execute o comando no terminal que você usa para o Claude Code.

```sh
claude mcp add --transport http eqvero https://eqvero.com/api/mcp --header "Authorization: Bearer <EQVERO_API_KEY>"
```

Substitua o marcador por chave real na configuração segura do cliente. O exemplo não comprova conexão. A Eqvero não oferece OAuth nem acesso sem chave atualmente. Outros clientes podem usar campos diferentes; use a configuração HTTP MCP compatível, não copie este formato sem ajustes.

## Verificar conexão

Liste as ferramentas do servidor atual e execute companies_search com query AAPL e limit 1. O teste somente leitura só passa com nome, ticker e ID reais. Se exigir recarregar ou reiniciar, informe que ainda não entrou em vigor. Gravar configuração não equivale a verificar conexão.

`companies_search({"query":"AAPL","limit":1})`

Não use research_create, analytics_create nem tarefas cobráveis para testar instalação. Em 401 confira chave; em 402, acesso e franquia; em 403, permissões. Não crie nem revogue outras chaves automaticamente.

## Opcional: instalar o Skill de análise

Fonte pública: https://github.com/LJK0719/eqvero-skill. Leia README e SKILL.md apenas se o usuário quiser orientação metodológica e instale no escopo Skill compatível. Não instale globalmente sem confirmar nem execute scripts arbitrários incluídos em downloads.

## Análises e cálculos

Crie tarefas só após pedido explícito de análise ou cálculo. Salve o ID e use research_get / analytics_get para status e resultados. Sair da página ou desconectar MCP não cancela tarefas aceitas.

Use idempotencyKey estável para criação, perguntas adicionais e novas tentativas. Reutilize ao reenviar a mesma operação; crie outra só se os dados mudarem. Se perder a resposta, use research_submission para conferir aceitação em vez de enviar com outra chave. Cancele só com pedido explícito de interrupção.