O que é MCP
O Model Context Protocol (MCP) é um protocolo aberto que define como modelos de IA se comunicam com ferramentas externas e fontes de dados. O Cryptohopper Market Data MCP é uma implementação deste protocolo que expõe dados de mercado de criptomoedas — livros de ofertas, tickers e velas — para qualquer cliente compatível com MCP.
Esta página é o explicador de referência. Para a versão completa do blog, consulte O que é MCP e por que isso importa para traders de criptomoedas?
Definição
MCP é uma interface padronizada através da qual um modelo de linguagem pode:
- Descobrir as ferramentas disponíveis em um servidor (descoberta de ferramentas).
- Invocar uma ferramenta com argumentos estruturados (invocação de ferramenta).
- Receber resultados estruturados (resposta da ferramenta).
O MCP foi introduzido pela Anthropic no final de 2024 e agora é suportado por grandes clientes de IA, incluindo Claude Code, Claude desktop, Cursor, VS Code, Zed, Gemini CLI e OpenAI Codex.
Primitivas
Um servidor MCP pode expor três tipos de primitivas:
| Primitiva | Descrição | Exemplo no Cryptohopper MCP |
|---|---|---|
| Tool | Uma função que o modelo pode chamar. Definida por nome, descrição e esquema de argumentos. | get_ticker, get_orderbook, get_candles |
| Resource | Um dado nomeado que o modelo pode ler. | Não exposto atualmente |
| Prompt | Um modelo de prompt reutilizável sugerido pelo servidor. | Não usado atualmente pelo Cryptohopper MCP |
O Cryptohopper Market Data MCP usa apenas ferramentas. Consulte Arquitetura para a superfície completa.
Transporte
O Cryptohopper MCP usa HTTP com Server-Sent Events (SSE) como seu transporte:
- Handshake inicial e autenticação: HTTP
- Invocações de ferramentas contínuas: fluxo SSE
- Codificação de requisição: JSON
- Autenticação: token bearer no cabeçalho
Authorization - Endpoint:
https://mcp-data.cryptohopper.com/mcp
Modelo de interação
Uma interação típica procede da seguinte forma:
- O cliente se conecta ao servidor e se autentica.
- O cliente consulta o servidor para ferramentas disponíveis.
- O servidor retorna uma lista de definições de ferramentas, cada uma incluindo um esquema JSON para seus argumentos.
- O cliente apresenta as definições de ferramentas ao modelo de linguagem.
- O modelo decide se deve chamar uma ferramenta com base na mensagem do usuário.
- Se o modelo escolher uma ferramenta, o cliente a invoca no servidor e recebe o resultado.
- O resultado é inserido no contexto do modelo e uma resposta é gerada.
Nota: O modelo não mantém estado persistente entre chamadas de ferramentas. Cada chamada é independente.
Comparação com REST
O MCP não substitui APIs REST. Ele é otimizado para casos de uso diferentes:
| Eixo | API REST | MCP |
|---|---|---|
| Chamador | Código de aplicação | Modelo de IA / agente |
| Descoberta de ferramentas | Manual (desenvolvedor lê documentação) | Automática (modelo lê esquema) |
| Formato de requisição | URL + parâmetros | Chamada de ferramenta estruturada |
| Melhor para | ETL, bots, painéis de controle | Análise interativa, agentes |
| Perfil de latência | Baixa, fixa | Baixa por chamada + raciocínio do modelo |
| Determinismo | Alto | Depende do modelo |
Consulte MCP vs. API REST para dados de mercado de criptomoedas para a comparação estendida.
Capacidades expostas pelo Cryptohopper MCP
O Cryptohopper Market Data MCP expõe ferramentas para:
- Recuperar dados de ticker atuais para um par específico em uma corretora específica.
- Recuperar um snapshot do livro de ofertas para um par específico em uma corretora específica.
- Recuperar dados de velas (OHLCV) em intervalos de tempo configuráveis.
- Listar corretoras suportadas.
- Listar pares suportados em uma determinada corretora.
- Retornar o uso atual e a cota para a conta autenticada.
- As ferramentas disponíveis dependem do nível de assinatura ativo. Consulte níveis de assinatura.
Limitações
O Cryptohopper Market Data MCP é somente leitura. Ele não:
- Executa operações.
- Gerencia pedidos ou posições.
- Modifica o estado da conta.
- Persiste dados entre chamadas.
A execução de operações está disponível através da API REST de Trading do Cryptohopper. Consulte Combine MCP + API de Trading do Cryptohopper para agentes de ponta a ponta. Um MCP dedicado para execução de operações está no roadmap.
Propriedades de segurança
- Todas as conexões são sobre TLS.
- A autenticação é por token bearer por conta.
- Os tokens são revogáveis pela interface de conta do Cryptohopper.
- O servidor não persiste estado de sessão.
Consulte as práticas recomendadas de segurança para chaves de API.
Especificação
MCP é uma especificação aberta mantida pela Anthropic. A especificação completa está disponível em modelcontextprotocol.io.