Visão geral da configuração
Esta página descreve como conectar um cliente compatível com MCP ao Cryptohopper Market Data MCP. É o ponto de entrada para o site de documentação e contém links para os guias de configuração por cliente na base de conhecimento de suporte.
Endpoint
O Cryptohopper Market Data MCP é servido em: https://mcp-data.cryptohopper.com/mcp
O transporte é HTTP com Server-Sent Events (SSE). Todas as requisições devem ser autenticadas — seja via OAuth 2.0 ou via chave de API bearer-token. Veja Autenticação OAuth vs. chave de API para uma comparação de ambos os métodos.
Pré-requisitos
Para conectar um cliente você precisa de:
- Uma conta Cryptohopper.
- Um dos seguintes métodos de autenticação:
- OAuth 2.0 — nenhuma chave necessária; o cliente manipula um fluxo de autorização baseado em navegador na primeira conexão.
- Uma chave de API MCP Cryptohopper (bearer token) — veja como obter uma chave de API MCP Cryptohopper.
- Um cliente compatível com MCP (veja os clientes suportados abaixo).
O nível de assinatura gratuito Pioneer é suficiente para conectar e testar o MCP. Veja os níveis de assinatura para uma comparação completa.
Clientes suportados
Os seguintes clientes têm guias de configuração dedicados:
| Cliente | Tipo | Guia de configuração |
|---|---|---|
| Claude Code | Terminal | Configuração do Claude Code |
| Claude desktop | Aplicativo desktop | Configuração do Claude desktop |
| Cursor | IDE | Configuração do Cursor |
| VS Code | IDE (modo agente Copilot) | Configuração do VS Code |
| Zed | IDE | Configuração do Zed |
| Gemini CLI | Terminal | Configuração do Gemini CLI |
| OpenAI Codex | Terminal | Configuração do Codex |
Qualquer outro cliente compatível com MCP (LM Studio, Continue, Cline, e similares) pode ser conectado usando o guia de configuração de cliente genérico.
Modelo de conexão
Quando um cliente se conecta ao endpoint MCP:
- O cliente realiza um handshake inicial sobre HTTP.
- O cliente se autentica usando OAuth 2.0 (autorização baseada em navegador na primeira conexão, com atualização automática de token depois) ou uma chave de API bearer-token.
- O cliente solicita a lista de ferramentas disponíveis. O servidor retorna nomes de ferramentas, descrições e esquemas de argumentos.
- O cliente atualiza para um fluxo SSE para invocações de ferramentas contínuas.
Todo o estado é mantido no lado do cliente. O servidor não persiste o estado da sessão entre requisições. Veja Arquitetura para detalhes.
Autenticação
O MCP suporta dois mecanismos de autenticação:
- OAuth 2.0. Na primeira conexão, o cliente abre um fluxo de autorização baseado em navegador. Os tokens de acesso têm vida curta e são atualizados automaticamente. Nenhum segredo de longa duração é armazenado na configuração do cliente.
- Bearer token (chave de API). Uma chave de longa duração é passada no cabeçalho Authorization de cada requisição:
{
"Authorization": "Bearer <your_api_key>"
}
O cliente manipula qualquer fluxo automaticamente uma vez configurado. A autenticação está vinculada a uma única conta Cryptohopper. Cota semanal e limites de taxa são aplicados por conta, não por chave ou por concessão OAuth. Veja Autenticação OAuth vs. chave de API para orientação sobre qual escolher, práticas recomendadas de segurança de chave de API e explicação dos limites de taxa.
Formato de configuração
A maioria dos clientes usa um bloco de configuração JSON que inclui a URL do servidor e — para o fluxo de chave de API — o bearer token. O formato exato varia por cliente.
Opção A — Chave de API (bearer token):
{
"mcpServers": {
"cryptohopper": {
"type": "http",
"url": "https://mcp-data.cryptohopper.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Opção B — OAuth 2.0 (sem chave na configuração):
{
"mcpServers": {
"cryptohopper": {
"type": "http",
"url": "https://mcp-data.cryptohopper.com/mcp"
}
}
}
Com a Opção B, o cliente aciona o fluxo de autorização OAuth na primeira conexão. Os guias por cliente documentam a localização exata do arquivo e quaisquer campos específicos do cliente.
Verificando a conexão
Após configurar um cliente, verifique a conexão emitindo uma consulta mínima. Exemplo:
Qual é o ticker atual de BTC/USDT na Binance?
Uma resposta bem-sucedida inclui o último preço, bid/ask, mudança de 24 horas e volume de 24 horas. Veja a referência da ferramenta ticker para o esquema de resposta completo.
Se a resposta não chegar, veja a referência de erros e solução de problemas.
Ferramentas expostas
O MCP expõe as seguintes categorias de ferramentas:
| Categoria | Ferramentas | Referência |
|---|---|---|
| Ticker | Ticker atual (get_ticker) | Referência da ferramenta ticker |
| Livro de ofertas | Snapshot do livro de ofertas (get_orderbook) | Referência da ferramenta de livro de ofertas |
| Velas (OHLCV) | Histórico de velas (get_candles) | Referência da ferramenta de velas |
| Metadados | Listar corretoras (list_exchanges), listar mercados (list_markets), obter mercado (get_market), listar moedas de cotação (list_quote_currencies) | Corretoras suportadas |
| Conta | Consulta de uso e cota (get_usage) | Uso e limites |
As ferramentas exatas disponíveis dependem do nível de assinatura. Veja os níveis de assinatura.
Comportamento específico por nível
Certos comportamentos diferem por nível de assinatura. Exemplos:
- Cobertura de corretoras. O nível Pioneer é limitado a Binance, Coinbase e Kraken. Níveis superiores expõem corretoras adicionais. Veja corretoras suportadas.
- Dados históricos. O nível Pioneer retorna apenas dados em tempo real. Explorer, Adventurer e Hero suportam consultas de velas históricas, com diferentes limites de retrospectiva.
- Fator de custo para dados históricos. No Explorer e Adventurer, consultas de velas históricas são cobradas a 5× (histórico curto) ou 20× (histórico longo) em relação a uma chamada base. No Hero, todas as consultas são cobradas a 1×. Veja a explicação dos limites de taxa.
Tentativas de consultar funcionalidades fora do nível atual retornam um erro de restrição de nível. Veja a referência de erros.
Início rápido
O caminho mais rápido para uma conexão funcional:
- Escolha um método de autenticação — OAuth 2.0 (recomendado para clientes interativos) ou uma chave de API bearer-token (recomendado para scripts e automação). Para chaves de API, gere uma nas configurações da sua conta Cryptohopper.
- Configure o cliente de sua escolha usando seu guia de configuração.
- Emita uma consulta de teste.
O tempo total é tipicamente inferior a cinco minutos.