Einrichtungsübersicht
Diese Seite beschreibt, wie du einen MCP-kompatiblen Client mit dem Cryptohopper Market Data MCP verbindest. Sie ist der Einstiegspunkt für die Dokumentationsseite und verlinkt zu den clientspezifischen Einrichtungsanleitungen in der Support-Wissensdatenbank.
Endpunkt
Der Cryptohopper Market Data MCP wird unter folgender Adresse bereitgestellt: https://mcp-data.cryptohopper.com/mcp
Der Transport erfolgt über HTTP mit Server-Sent Events (SSE). Alle Anfragen müssen authentifiziert werden — entweder über OAuth 2.0 oder über einen Bearer-Token-API-Schlüssel. Siehe OAuth vs. API-Schlüssel-Authentifizierung für einen Vergleich beider Methoden.
Voraussetzungen
Um einen Client zu verbinden, benötigst du:
- Ein Cryptohopper-Konto.
- Eine der folgenden Authentifizierungsmethoden:
- OAuth 2.0 — kein Schlüssel erforderlich; der Client führt beim ersten Verbinden einen browserbasierten Autorisierungsflow durch.
- Einen Cryptohopper MCP API-Schlüssel (Bearer-Token) — siehe wie du einen Cryptohopper MCP API-Schlüssel erhältst.
- Einen MCP-kompatiblen Client (siehe unterstützte Clients unten).
Die kostenlose Pioneer-Abonnementstufe ist ausreichend, um das MCP zu verbinden und zu testen. Siehe Abonnementstufen für einen vollständigen Vergleich.
Unterstützte Clients
Die folgenden Clients verfügen über dedizierte Einrichtungsanleitungen:
| Client | Typ | Einrichtungsanleitung |
|---|---|---|
| Claude Code | Terminal | Claude Code-Einrichtung |
| Claude Desktop | Desktop-App | Claude Desktop-Einrichtung |
| Cursor | IDE | Cursor-Einrichtung |
| VS Code | IDE (Copilot-Agent-Modus) | VS Code-Einrichtung |
| Zed | IDE | Zed-Einrichtung |
| Gemini CLI | Terminal | Gemini CLI-Einrichtung |
| OpenAI Codex | Terminal | Codex-Einrichtung |
Jeder andere MCP-kompatible Client (LM Studio, Continue, Cline und ähnliche) kann über die generische Client-Einrichtungsanleitung verbunden werden.
Verbindungsmodell
Wenn ein Client sich mit dem MCP-Endpunkt verbindet:
- Der Client führt einen initialen Handshake über HTTP durch.
- Der Client authentifiziert sich entweder über OAuth 2.0 (browserbasierte Autorisierung beim ersten Verbinden, mit automatischer Token-Aktualisierung danach) oder über einen Bearer-Token-API-Schlüssel.
- Der Client fordert die Liste der verfügbaren Tools an. Der Server gibt Tool-Namen, Beschreibungen und Argument-Schemata zurück.
- Der Client aktualisiert auf einen SSE-Stream für laufende Tool-Aufrufe.
Der gesamte Status wird clientseitig gehalten. Der Server speichert keinen Sitzungsstatus zwischen Anfragen. Siehe Architektur für Details.
Authentifizierung
Das MCP unterstützt zwei Authentifizierungsmechanismen:
- OAuth 2.0. Beim ersten Verbinden öffnet der Client einen browserbasierten Autorisierungsflow. Zugangs-Token sind kurzlebig und werden automatisch aktualisiert. Kein langlebiges Geheimnis wird in der Client-Konfiguration gespeichert.
- Bearer-Token (API-Schlüssel). Ein langlebiger Schlüssel wird im Authorization-Header jeder Anfrage übergeben:
{
"Authorization": "Bearer <your_api_key>"
}
Der Client verarbeitet beide Flows automatisch, sobald er konfiguriert ist. Die Authentifizierung ist auf ein einzelnes Cryptohopper-Konto beschränkt. Wöchentliche Kontingente und Raten-Limits werden pro Konto angewendet, nicht pro Schlüssel oder pro OAuth-Berechtigung. Siehe OAuth vs. API-Schlüssel-Authentifizierung für Hinweise zur Auswahl, Best Practices für API-Schlüssel-Sicherheit und Erläuterungen zu Raten-Limits.
Konfigurationsformat
Die meisten Clients verwenden einen JSON-Konfigurationsblock, der die Server-URL und — für den API-Schlüssel-Flow — den Bearer-Token enthält. Das genaue Format variiert je nach Client.
Option A — API-Schlüssel (Bearer-Token):
{
"mcpServers": {
"cryptohopper": {
"type": "http",
"url": "https://mcp-data.cryptohopper.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Option B — OAuth 2.0 (kein Schlüssel in der Konfiguration):
{
"mcpServers": {
"cryptohopper": {
"type": "http",
"url": "https://mcp-data.cryptohopper.com/mcp"
}
}
}
Mit Option B löst der Client beim ersten Verbinden den OAuth-Autorisierungsflow aus. Die clientspezifischen Anleitungen dokumentieren den genauen Dateipfad und alle clientspezifischen Felder.
Verbindung verifizieren
Verifiziere nach der Konfiguration eines Clients die Verbindung, indem du eine minimale Abfrage sendest. Beispiel:
Wie lautet der aktuelle BTC/USDT-Ticker auf Binance?
Eine erfolgreiche Antwort enthält einen letzten Preis, Bid/Ask, 24-Stunden-Änderung und 24-Stunden-Volumen. Siehe Ticker-Tool-Referenz für das vollständige Response-Schema.
Wenn die Antwort nicht eintrifft, siehe Fehlerreferenz und Fehlersuche.
Verfügbare Tools
Das MCP stellt die folgenden Tool-Kategorien bereit:
| Kategorie | Tools | Referenz |
|---|---|---|
| Ticker | Aktueller Ticker (get_ticker) | Ticker-Tool-Referenz |
| Orderbuch | Orderbuch-Snapshot (get_orderbook) | Orderbuch-Tool-Referenz |
| Candles (OHLCV) | Candle-Historie (get_candles) | Candle-Tool-Referenz |
| Metadaten | Börsen auflisten (list_exchanges), Märkte auflisten (list_markets), Markt abrufen (get_market), Kurswährungen auflisten (list_quote_currencies) | Unterstützte Börsen |
| Konto | Nutzungs- und Kontingentabfrage (get_usage) | Nutzung und Limits |
Die genau verfügbaren Tools hängen von der Abonnementstufe ab. Siehe Abonnementstufen.
Stufenspezifisches Verhalten
Bestimmte Verhaltensweisen unterscheiden sich je nach Abonnementstufe. Beispiele:
- Börsenabdeckung. Die Pioneer-Stufe ist auf Binance, Coinbase und Kraken beschränkt. Höhere Stufen stellen zusätzliche Börsen bereit. Siehe unterstützte Börsen.
- Historische Daten. Die Pioneer-Stufe gibt nur Echtzeit-Daten zurück. Explorer, Adventurer und Hero unterstützen historische Candle-Abfragen mit unterschiedlichen Rückblick-Limits.
- Kostenfaktor für historische Daten. Bei Explorer und Adventurer werden historische Candle-Abfragen mit dem 5-fachen (kurze Historie) oder 20-fachen (lange Historie) Faktor im Vergleich zu einem Basis-Aufruf berechnet. Bei Hero werden alle Abfragen mit dem 1-fachen Faktor berechnet. Siehe Erläuterungen zu Raten-Limits.
Versuche, Funktionen außerhalb der aktuellen Stufe abzufragen, geben einen Stufenbeschränkungs-Fehler zurück. Siehe Fehlerreferenz.
Schnellstart
Der schnellste Weg zu einer funktionierenden Verbindung:
- Wähle eine Authentifizierungsmethode — OAuth 2.0 (empfohlen für interaktive Clients) oder einen Bearer-Token-API-Schlüssel (empfohlen für Skripte und Automatisierung). Generiere für API-Schlüssel einen in deinen Cryptohopper-Kontoeinstellungen.
- Konfiguriere den Client deiner Wahl anhand seiner Einrichtungsanleitung.
- Sende eine Test-Abfrage.
Die Gesamtzeit beträgt typischerweise unter fünf Minuten.