Resumen de configuración
Esta página describe cómo conectar un cliente compatible con MCP al Cryptohopper Market Data MCP. Es el punto de entrada para el sitio de documentación y enlaza a las guías de configuración por cliente en la base de conocimiento de soporte.
Endpoint
El Cryptohopper Market Data MCP se sirve en: https://mcp-data.cryptohopper.com/mcp
El transporte es HTTP con Server-Sent Events (SSE). Todas las solicitudes deben estar autenticadas — ya sea mediante OAuth 2.0 o mediante una clave api de token de portador. Consulta Autenticación OAuth vs. clave api para una comparación de ambos métodos.
Prerrequisitos
Para conectar un cliente necesitas:
- Una cuenta de Cryptohopper.
- Uno de los siguientes métodos de autenticación:
- OAuth 2.0 — no se requiere clave; el cliente maneja un flujo de autorización basado en navegador en la primera conexión.
- Una clave api MCP de Cryptohopper (token de portador) — consulta cómo obtener una clave api MCP de Cryptohopper.
- Un cliente compatible con MCP (consulta los clientes compatibles a continuación).
El nivel de suscripción gratuito Pioneer es suficiente para conectar y probar el MCP. Consulta los niveles de suscripción para una comparación completa.
Clientes compatibles
Los siguientes clientes tienen guías de configuración dedicadas:
| Cliente | Tipo | Guía de configuración |
|---|---|---|
| Claude Code | Terminal | Configuración de Claude Code |
| Claude desktop | Aplicación de escritorio | Configuración de Claude desktop |
| Cursor | IDE | Configuración de Cursor |
| VS Code | IDE (modo agente Copilot) | Configuración de VS Code |
| Zed | IDE | Configuración de Zed |
| Gemini CLI | Terminal | Configuración de Gemini CLI |
| OpenAI Codex | Terminal | Configuración de Codex |
Cualquier otro cliente compatible con MCP (LM Studio, Continue, Cline, y similares) puede conectarse usando la guía de configuración genérica de cliente.
Modelo de conexión
Cuando un cliente se conecta al endpoint MCP:
- El cliente realiza un protocolo de enlace inicial sobre HTTP.
- El cliente se autentica usando OAuth 2.0 (autorización basada en navegador en la primera conexión, con actualización automática del token posteriormente) o una clave api de token de portador.
- El cliente solicita la lista de herramientas disponibles. El servidor devuelve nombres de herramientas, descripciones y esquemas de argumentos.
- El cliente actualiza a un flujo SSE para invocaciones de herramientas en curso.
Todo el estado se mantiene del lado del cliente. El servidor no persiste el estado de sesión entre solicitudes. Consulta Arquitectura para más detalles.
Autenticación
El MCP soporta dos mecanismos de autenticación:
- OAuth 2.0. En la primera conexión, el cliente abre un flujo de autorización basado en navegador. Los tokens de acceso tienen corta duración y se actualizan automáticamente. No se almacena ningún secreto de larga duración en la configuración del cliente.
- Token de portador (clave api). Una clave de larga duración se pasa en el encabezado Authorization de cada solicitud:
{
"Authorization": "Bearer <your_api_key>"
}
El cliente maneja cualquiera de los dos flujos automáticamente una vez configurado. La autenticación está limitada a una única cuenta de Cryptohopper. La cuota semanal y los límites de tasa se aplican por cuenta, no por clave o por concesión OAuth. Consulta Autenticación OAuth vs. clave api para orientación sobre cuál elegir, prácticas recomendadas de seguridad de clave api, y límites de tasa explicados.
Formato de configuración
La mayoría de los clientes usan un bloque de configuración JSON que incluye la URL del servidor y — para el flujo de clave api — el token de portador. El formato exacto varía por cliente.
Opción A — Clave api (token de portador):
{
"mcpServers": {
"cryptohopper": {
"type": "http",
"url": "https://mcp-data.cryptohopper.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Opción B — OAuth 2.0 (sin clave en la configuración):
{
"mcpServers": {
"cryptohopper": {
"type": "http",
"url": "https://mcp-data.cryptohopper.com/mcp"
}
}
}
Con la Opción B, el cliente activa el flujo de autorización OAuth en la primera conexión. Las guías por cliente documentan la ubicación exacta del archivo y cualquier campo específico del cliente.
Verificar la conexión
Después de configurar un cliente, verifica la conexión emitiendo una consulta mínima. Ejemplo:
¿Cuál es el ticker actual de BTC/USDT en Binance?
Una respuesta exitosa incluye un último precio, bid/ask, cambio de 24 horas y volumen de 24 horas. Consulta la referencia de herramienta ticker para el esquema de respuesta completo.
Si la respuesta no llega, consulta referencia de errores y solución de problemas.
Herramientas expuestas
El MCP expone las siguientes categorías de herramientas:
| Categoría | Herramientas | Referencia |
|---|---|---|
| Ticker | Ticker actual (get_ticker) | Referencia de herramienta ticker |
| Libro de órdenes | Instantánea del libro de órdenes (get_orderbook) | Referencia de herramienta libro de órdenes |
| Velas (OHLCV) | Historial de velas (get_candles) | Referencia de herramienta vela |
| Metadatos | Listar exchanges (list_exchanges), listar mercados (list_markets), obtener mercado (get_market), listar monedas de cotización (list_quote_currencies) | Exchanges soportados |
| Cuenta | Consulta de uso y cuota (get_usage) | Uso y límites |
Las herramientas exactas disponibles dependen del nivel de suscripción. Consulta niveles de suscripción.
Comportamiento específico por nivel
Ciertos comportamientos difieren por nivel de suscripción. Ejemplos:
- Cobertura de exchanges. El nivel Pioneer está limitado a Binance, Coinbase y Kraken. Los niveles superiores exponen exchanges adicionales. Consulta exchanges soportados.
- Datos históricos. El nivel Pioneer devuelve datos en tiempo real únicamente. Explorer, Adventurer y Hero soportan consultas históricas de velas, con diferentes límites de retrospectiva.
- Factor de costo para datos históricos. En Explorer y Adventurer, las consultas históricas de velas se cobran a 5× (historial corto) o 20× (historial largo) en relación con una llamada base. En Hero, todas las consultas se cobran a 1×. Consulta límites de tasa explicados.
Los intentos de consultar funcionalidad fuera del nivel actual devuelven un error de restricción de nivel. Consulta referencia de errores.
Inicio rápido
El camino más rápido hacia una conexión funcional:
- Elige un método de autenticación — OAuth 2.0 (recomendado para clientes interactivos) o una clave api de token de portador (recomendada para scripts y automatización). Para claves api, genera una en los ajustes de tu cuenta de Cryptohopper.
- Configura el cliente de tu elección usando su guía de configuración.
- Emite una consulta de prueba.
El tiempo total suele ser menor a cinco minutos.