Przegląd konfiguracji

Ta strona opisuje jak połączyć klienta zgodnego z MCP z Cryptohopper Market Data MCP. Jest to punkt wyjścia dla witryny dokumentacji i zawiera odnośniki do przewodników konfiguracji dla poszczególnych klientów w bazie wiedzy wsparcia.

Punkt końcowy

Cryptohopper Market Data MCP jest dostępny pod adresem: https://mcp-data.cryptohopper.com/mcp

Transport to HTTP z Server-Sent Events (SSE). Wszystkie żądania muszą być uwierzytelnione — za pomocą OAuth 2.0 lub za pomocą klucza API tokena bearer. Zobacz Uwierzytelnianie OAuth a klucz API, aby porównać obie metody.

Wymagania wstępne

Aby połączyć klienta, potrzebujesz:

• Konta Cryptohopper.
• Jednej z następujących metod uwierzytelniania:

1. OAuth 2.0 — klucz nie jest wymagany; klient obsługuje przepływ autoryzacji w przeglądarce przy pierwszym połączeniu.
2. Klucza API Cryptohopper MCP (tokenu bearer) — zobacz, jak uzyskać klucz API Cryptohopper MCP.

• Klienta zgodnego z MCP (zobacz obsługiwanych klientów poniżej).

Darmowy poziom subskrypcji Pioneer jest wystarczający, aby połączyć i przetestować MCP. Zobacz poziomy subskrypcji, aby uzyskać pełne porównanie.

Obsługiwani klienci

Następujący klienci mają dedykowane przewodniki konfiguracji:

Klient	Typ	Przewodnik konfiguracji
Claude Code	Terminal	Konfiguracja Claude Code
Claude desktop	Aplikacja desktopowa	Konfiguracja Claude desktop
Cursor	IDE	Konfiguracja Cursor
VS Code	IDE (tryb agenta Copilot)	Konfiguracja VS Code
Zed	IDE	Konfiguracja Zed
Gemini CLI	Terminal	Konfiguracja Gemini CLI
OpenAI Codex	Terminal	Konfiguracja Codex

Każdy inny klient zgodny z MCP (LM Studio, Continue, Cline i podobne) można połączyć, korzystając z ogólnego przewodnika konfiguracji klienta.

Model połączenia

Gdy klient łączy się z punktem końcowym MCP:

1. Klient wykonuje wstępne uzgadnianie przez HTTP.
2. Klient uwierzytelnia się za pomocą OAuth 2.0 (autoryzacja w przeglądarce przy pierwszym połączeniu z automatycznym odświeżaniem tokena następnie) lub klucza API tokena bearer.
3. Klient żąda listy dostępnych narzędzi. Serwer zwraca nazwy narzędzi, opisy i schematy argumentów.
4. Klient przechodzi na strumień SSE dla bieżących wywołań narzędzi.

Cały stan jest przechowywany po stronie klienta. Serwer nie zachowuje stanu sesji między żądaniami. Zobacz Architektura, aby uzyskać szczegóły.

Uwierzytelnianie

MCP obsługuje dwa mechanizmy uwierzytelniania:

• OAuth 2.0. Przy pierwszym połączeniu klient otwiera przepływ autoryzacji w przeglądarce. Tokeny dostępu są krótkoterminowe i odświeżane automatycznie. Żaden długoterminowy sekret nie jest przechowywany w konfiguracji klienta.
• Token bearer (klucz API). Długoterminowy klucz jest przekazywany w nagłówku Authorization każdego żądania:

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

Klient obsługuje oba przepływy automatycznie po skonfigurowaniu. Uwierzytelnianie jest ograniczone do pojedynczego konta Cryptohopper. Tygodniowy limit i limity szybkości są stosowane na konto, a nie na klucz lub przyznanie OAuth. Zobacz Uwierzytelnianie OAuth a klucz API, aby uzyskać wskazówki dotyczące wyboru, najlepsze praktyki bezpieczeństwa klucza API i wyjaśnienie limitów szybkości.

Format konfiguracji

Większość klientów używa bloku konfiguracji JSON, który zawiera adres URL serwera i — w przypadku przepływu klucza API — token bearer. Dokładny format różni się w zależności od klienta.

Opcja A — klucz API (token bearer):

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

Opcja B — OAuth 2.0 (brak klucza w konfiguracji):

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

W opcji B klient uruchamia przepływ autoryzacji OAuth przy pierwszym połączeniu. Przewodniki dla poszczególnych klientów dokumentują dokładną lokalizację pliku i wszelkie pola specyficzne dla klienta.

Weryfikacja połączenia

Po skonfigurowaniu klienta zweryfikuj połączenie, wydając minimalne zapytanie. Przykład:

Jaki jest bieżący ticker BTC/USDT na Binance?

Pomyślna odpowiedź zawiera ostatnią cenę, bid/ask, zmianę 24-godzinną i wolumen 24-godzinny. Zobacz dokumentację narzędzia ticker, aby uzyskać pełny schemat odpowiedzi.

Jeśli odpowiedź nie nadchodzi, zobacz dokumentację błędów i diagnostyka.

Udostępnione narzędzia

MCP udostępnia następujące kategorie narzędzi:

Kategoria	Narzędzia	Dokumentacja
Ticker	Aktualny ticker (get_ticker)	Dokumentacja narzędzia ticker
Księga zleceń	Migawka księgi zleceń (get_orderbook)	Dokumentacja narzędzia księgi zleceń
Świece (OHLCV)	Historia świec (get_candles)	Dokumentacja narzędzia świec
Metadane	Lista giełd (list_exchanges), lista rynków (list_markets), pobierz rynek (get_market), lista walut kwotowanych (list_quote_currencies)	Obsługiwane giełdy
Konto	Zapytanie o użycie i limit (get_usage)	Użycie i limity

Dokładne dostępne narzędzia zależą od poziomu subskrypcji. Zobacz poziomy subskrypcji.

Zachowanie specyficzne dla poziomu

Pewne zachowania różnią się w zależności od poziomu subskrypcji. Przykłady:

• Pokrycie giełd. Poziom Pioneer jest ograniczony do Binance, Coinbase i Kraken. Wyższe poziomy udostępniają dodatkowe giełdy. Zobacz obsługiwane giełdy.
• Dane historyczne. Poziom Pioneer zwraca tylko dane w czasie rzeczywistym. Explorer, Adventurer i Hero obsługują zapytania o historyczne świece, z różnymi limitami wsteczności.
• Współczynnik kosztu dla danych historycznych. Na Explorer i Adventurer zapytania o historyczne świece są naliczane w stosunku 5× (krótka historia) lub 20× (długa historia) w stosunku do wywołania bazowego. Na Hero wszystkie zapytania są naliczane w stosunku 1×. Zobacz wyjaśnienie limitów szybkości.

Próby zapytania o funkcjonalność poza obecnym poziomem zwracają błąd ograniczenia poziomu. Zobacz dokumentację błędów.

Szybki start

Najszybsza ścieżka do działającego połączenia:

1. Wybierz metodę uwierzytelniania — OAuth 2.0 (zalecane dla interaktywnych klientów) lub klucz API tokena bearer (zalecane dla skryptów i automatyzacji). W przypadku kluczy API wygeneruj jeden w ustawieniach konta Cryptohopper.
2. Skonfiguruj wybranego klienta, korzystając z jego przewodnika konfiguracji.
3. Wydaj zapytanie testowe.

Całkowity czas to zazwyczaj poniżej pięciu minut.