Installatieoverzicht

Deze pagina beschrijft hoe je een MCP-compatibele client verbindt met de Cryptohopper Market Data MCP. Het is het startpunt voor de documentatiesite en linkt naar de installatiegidsen per client in de support kennisbank.

Endpoint

De Cryptohopper Market Data MCP wordt aangeboden op: https://mcp-data.cryptohopper.com/mcp

Het transport is HTTP met Server-Sent Events (SSE). Alle verzoeken moeten worden geverifieerd — ofwel via OAuth 2.0 ofwel via een bearer-token API-sleutel. Zie OAuth versus API-sleutel authenticatie voor een vergelijking van beide methoden.

Vereisten

Om een client te verbinden heb je nodig:

• Een Cryptohopper-account.
• Een van de volgende authenticatiemethoden:

1. OAuth 2.0 — geen sleutel vereist; de client regelt een browsergebaseerde autorisatiestroom bij de eerste verbinding.
2. Een Cryptohopper MCP API-sleutel (bearer token) — zie hoe je een Cryptohopper MCP API-sleutel krijgt.

• Een MCP-compatibele client (zie ondersteunde clients hieronder).

Het gratis Pioneer-abonnementsniveau is voldoende om de MCP te verbinden en te testen. Zie abonnementsniveaus voor een volledige vergelijking.

Ondersteunde clients

De volgende clients hebben speciale installatiegidsen:

Client	Type	Installatiegids
Claude Code	Terminal	Claude Code installatie
Claude desktop	Desktop app	Claude desktop installatie
Cursor	IDE	Cursor installatie
VS Code	IDE (Copilot agent modus)	VS Code installatie
Zed	IDE	Zed installatie
Gemini CLI	Terminal	Gemini CLI installatie
OpenAI Codex	Terminal	Codex installatie

Elke andere MCP-compatibele client (LM Studio, Continue, Cline, en vergelijkbare) kan worden verbonden via de generieke client installatiegids.

Verbindingsmodel

Wanneer een client verbindt met het MCP-endpoint:

1. De client voert een initiële handshake uit via HTTP.
2. De client verifieert met ofwel OAuth 2.0 (browsergebaseerde autorisatie bij de eerste verbinding, met automatische tokenvernieuwing daarna) ofwel een bearer-token API-sleutel.
3. De client vraagt de lijst met beschikbare tools op. De server retourneert toolnamen, beschrijvingen en argumentschema's.
4. De client upgradet naar een SSE-stream voor doorlopende toolaanroepen.

Alle status wordt aan de clientzijde bewaard. De server bewaart geen sessiestatus tussen verzoeken. Zie Architectuur voor details.

Authenticatie

De MCP ondersteunt twee authenticatiemechanismen:

• OAuth 2.0. Bij de eerste verbinding opent de client een browsergebaseerde autorisatiestroom. Access tokens hebben een korte levensduur en worden automatisch vernieuwd. Er wordt geen langdurig geheim opgeslagen in de clientconfiguratie.
• Bearer token (API-sleutel). Een langdurige sleutel wordt doorgegeven in de Authorization-header van elk verzoek:

{
  "Authorization": "Bearer <your_api_key>"
}

De client regelt beide stromen automatisch zodra deze zijn geconfigureerd. Authenticatie is beperkt tot een enkel Cryptohopper-account. Wekelijkse quota en snelheidslimieten worden toegepast per account, niet per sleutel of per OAuth-toestemming. Zie OAuth versus API-sleutel authenticatie voor advies over welke te kiezen, best practices voor API-sleutelbeveiliging en uitleg over snelheidslimieten.

Configuratieformaat

De meeste clients gebruiken een JSON-configuratieblok dat de server-URL bevat en — voor de API-sleutelstroom — het bearer token. Het exacte formaat varieert per client.

Optie A — API-sleutel (bearer token):

{
  "mcpServers": {
    "cryptohopper": {
      "type": "http",
      "url": "https://mcp-data.cryptohopper.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Optie B — OAuth 2.0 (geen sleutel in configuratie):

{
  "mcpServers": {
    "cryptohopper": {
      "type": "http",
      "url": "https://mcp-data.cryptohopper.com/mcp"
    }
  }
}

Met Optie B activeert de client de OAuth-autorisatiestroom bij de eerste verbinding. Gidsen per client documenteren de exacte bestandslocatie en eventuele client-specifieke velden.

De verbinding verifiëren

Controleer na het configureren van een client de verbinding door een minimale query uit te voeren. Voorbeeld:

Wat is de huidige BTC/USDT ticker op Binance?

Een succesvolle respons bevat een laatste prijs, bod/vraagprijs, 24-uurs verandering en 24-uurs volume. Zie ticker tool referentie voor het volledige responsschema.

Als de respons niet aankomt, zie foutmeldingenreferentie en probleemoplossing.

Beschikbare tools

De MCP biedt de volgende toolcategorieën:

Categorie	Tools	Referentie
Ticker	Huidige ticker (get_ticker)	Ticker tool referentie
Orderboek	Orderboeksnapshot (get_orderbook)	Orderboek tool referentie
Kaarsen (OHLCV)	Kaarsgeschiedenis (get_candles)	Kaars tool referentie
Metadata	Lijst beurzen (list_exchanges), lijst markten (list_markets), haal markt op (get_market), lijst quotevaluta (list_quote_currencies)	Ondersteunde beurzen
Account	Gebruik en quota query (get_usage)	Gebruik en limieten

De exacte beschikbare tools hangen af van het abonnementsniveau. Zie abonnementsniveaus.

Niveau-specifiek gedrag

Bepaalde gedragingen verschillen per abonnementsniveau. Voorbeelden:

• Beursdekking. Het Pioneer-niveau is beperkt tot Binance, Coinbase en Kraken. Hogere niveaus bieden toegang tot extra beurzen. Zie ondersteunde beurzen.
• Historische data. Het Pioneer-niveau retourneert alleen realtime data. Explorer, Adventurer en Hero ondersteunen historische kaarsquery's, met verschillende terugkijklimieten.
• Kostenfactor voor historische data. Op Explorer en Adventurer worden historische kaarsquery's in rekening gebracht met 5× (korte geschiedenis) of 20× (lange geschiedenis) ten opzichte van een baseline-aanroep. Op Hero worden alle query's in rekening gebracht met 1×. Zie uitleg over snelheidslimieten.

Pogingen om functionaliteit buiten het huidige niveau op te vragen, retourneren een niveau-beperkingsfout. Zie foutmeldingenreferentie.

Quickstart

Het snelste pad naar een werkende verbinding:

1. Kies een authenticatiemethode — OAuth 2.0 (aanbevolen voor interactieve clients) of een bearer-token API-sleutel (aanbevolen voor scripts en automatisering). Genereer voor API-sleutels er een in je Cryptohopper-accountinstellingen.
2. Configureer de client van jouw keuze met behulp van de installatiegids.
3. Voer een testquery uit.

De totale tijd is meestal minder dan vijf minuten.