Połączenie KasLens z OpenCode

OpenCode to interaktywny agent kodujący CLI, który działa w terminalu. Ten przewodnik pokazuje, jak połączyć serwer MCP KasLens z OpenCode, aby miał dostęp do danych rynkowych Kaspa i analityki w czasie rzeczywistym.

Wymagania wstępne

OpenCode zainstalowany na komputerze
Zweryfikowane konto KasLens. Utwórz je tutaj, jeżeli jeszcze go nie masz

Przypomnienie: Sprawdź folder spam lub wiadomości-śmieci, jeżeli wiadomość weryfikacyjna z adresu `[email protected]` nie dotarła.

Krok 1: Dodanie serwera MCP do konfiguracji

OpenCode używa pliku konfiguracyjnego JSON do zarządzania serwerami MCP. Otwórz plik konfiguracyjny OpenCode:

Konfiguracja globalna: `~/.config/opencode/opencode.jsonc`
Konfiguracja projektu: `opencode.jsonc` w katalogu głównym projektu

Dodaj serwer MCP KasLens do sekcji `mcpServers`:

```jsonc { "mcpServers": { "kaslens": { "enabled": true, "type": "remote", "url": "https://kaspa-lens.com/mcp", "oauth": {} } } } ```

Krok 2: Uruchomienie OpenCode i uwierzytelnienie

Uruchom OpenCode w terminalu:

```bash opencode ```

OpenCode wykryje nowy serwer MCP i rozpocznie przepływ OAuth
Otworzy się okno przeglądarki ze stroną logowania KasLens. Jeżeli przeglądarka nie otworzy się automatycznie, przejdź do terminala i uruchom:

```bash opencode mcp auth kaslens ``` 4. Zaloguj się adresem e-mail KasLens i hasłem 5. Autoryzuj OpenCode do dostępu do danych KasLens 6. Wróć do terminala. OpenCode potwierdzi połączenie

Krok 3: Zacznij korzystać

Możesz teraz pytać OpenCode o dane Kaspa. Na przykład:

„Jaka jest aktualna cena Kaspa i wolumen z 24 godzin?"
„Jakie wydarzenia gospodarcze są dziś i jak mogą wpłynąć na cenę Kaspa?"
„Podsumuj dzisiejszy codzienny puls Kaspa"
„Pokaż 10 największych adresów Kaspa według salda"
„Które tokeny KRC-20 mają najwyższą kapitalizację?"

OpenCode wywoła serwer MCP KasLens, aby pobrać dane na żywo i podać odpowiedzi bezpośrednio w terminalu.

Ponowne uwierzytelnienie

OpenCode przechowuje tokeny OAuth lokalnie. Jeżeli sesja wygaśnie, OpenCode automatycznie otworzy przeglądarkę, aby można było uwierzytelnić się ponownie. Ponowne uwierzytelnienie można też uruchomić ręcznie:

```bash opencode mcp auth kaslens ```

Rozwiązywanie problemów

„Connection refused" lub przekroczenie czasu

Upewnij się, że masz dostęp do internetu i że adres `https://kaspa-lens.com/mcp\` jest osiągalny. Możesz to sprawdzić poleceniem:

```bash curl -s -o /dev/null -w "%{http_code}" https://kaspa-lens.com/mcp ```

Powinna pojawić się odpowiedź `405` (metoda niedozwolona: punkt końcowy MCP oczekuje POST, a nie GET). Potwierdza to, że serwer jest osiągalny.

Przeglądarka nie otwiera się do uwierzytelnienia

Jeżeli środowisko terminala nie obsługuje otwierania przeglądarki, OpenCode wyświetli adres URL do otwarcia ręcznie. Skopiuj go i wklej w przeglądarce.

„Email not verified"

Przed logowaniem trzeba zweryfikować adres e-mail. Sprawdź skrzynkę odbiorczą (oraz folder spam) i poszukaj wiadomości weryfikacyjnej z adresu `[email protected]`.

Diagnostyka problemów z połączeniem

Jeżeli coś nie działa, OpenCode ma wbudowaną diagnostykę serwerów MCP. Uruchom poniższe polecenie, aby przetestować połączenie, sprawdzić stan OAuth i zweryfikować przepływ wykrywania:

```bash opencode mcp debug kaslens ```

Aby sprawdzić stan uwierzytelnienia wszystkich skonfigurowanych serwerów MCP:

```bash opencode mcp auth list ```

Więcej informacji znajdziesz w plikach dziennika OpenCode w `~/.local/share/opencode/log/`. Możesz też uruchomić OpenCode z rozszerzonym logowaniem, aby uzyskać więcej danych diagnostycznych:

```bash opencode --log-level DEBUG ```

Więcej szczegółów znajdziesz w przewodniku rozwiązywania problemów OpenCode oraz w dokumentacji serwerów MCP.