Collega KasLens a OpenCode

OpenCode è un agente di programmazione interattivo da riga di comando, che gira nel terminale. Questa guida mostra come collegare il server MCP di KasLens a OpenCode, così può accedere a dati di mercato e analisi Kaspa in tempo reale.

Prerequisiti

OpenCode installato sul tuo computer
Un account KasLens verificato: creane uno qui se non l'hai già fatto

Promemoria: controlla la cartella spam o la posta indesiderata se non hai ricevuto l'e-mail di verifica da `[email protected]`.

Passo 1: aggiungi il server MCP alla configurazione

OpenCode usa un file di configurazione JSON per gestire i server MCP. Apri il file di config di OpenCode:

Config globale: `~/.config/opencode/opencode.jsonc`
Config di progetto: `opencode.jsonc` nella radice del progetto

Aggiungi il server MCP di KasLens alla sezione `mcpServers`:

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

Passo 2: avvia OpenCode e autenticati

Avvia OpenCode nel terminale:

```bash opencode ```

OpenCode rileva il nuovo server MCP e avvia il flusso OAuth
Si apre una finestra del browser con la pagina di accesso di KasLens. Se il browser non si apre in automatico, vai nel terminale ed esegui:

```bash opencode mcp auth kaslens ``` 4. Accedi con l'e-mail KasLens e la password 5. Autorizza OpenCode ad accedere ai tuoi dati KasLens 6. Torna al terminale: OpenCode confermerà il collegamento

Passo 3: inizia a usarlo

Ora puoi chiedere a OpenCode dati su Kaspa. Ad esempio:

"Qual è il prezzo attuale di Kaspa e il volume sulle 24 ore?"
"Quali sono gli eventi economici di oggi e come potrebbero influenzare il prezzo di Kaspa?"
"Riassumi il Daily Pulse di Kaspa di oggi"
"Mostrami i 10 indirizzi Kaspa con il saldo più alto"
"Quali token KRC-20 hanno la capitalizzazione di mercato più alta?"

OpenCode chiamerà il server MCP di KasLens per recuperare dati in diretta e rispondere direttamente nel terminale.

Nuova autenticazione

OpenCode conserva i token OAuth in locale. Se la sessione scade, OpenCode apre in automatico il browser perché tu ti autentichi di nuovo. Puoi anche avviare la nuova autenticazione a mano:

```bash opencode mcp auth kaslens ```

Risoluzione dei problemi

"Connection refused" o timeout

Verifica di avere accesso a Internet e che `https://kaspa-lens.com/mcp\` sia raggiungibile. Puoi provare con:

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

Dovresti ottenere una risposta `405` (Method Not Allowed: l'endpoint MCP si aspetta POST, non GET). Questo conferma che il server è raggiungibile.

Il browser non si apre per l'autenticazione

Se l'ambiente del terminale non può aprire il browser, OpenCode stampa un URL da aprire a mano. Copialo e incollalo nel browser.

"E-mail non verificata"

Devi verificare l'indirizzo e-mail prima di poter accedere. Controlla la posta in arrivo (e la cartella spam) per l'e-mail di verifica da `[email protected]`.

Debug dei problemi di connessione

Se qualcosa non funziona, OpenCode offre una diagnostica integrata per i server MCP. Esegui il comando seguente per provare la connessione, controllare lo stato OAuth e verificare il flusso di discovery:

```bash opencode mcp debug kaslens ```

Per controllare lo stato di autenticazione di tutti i server MCP configurati:

```bash opencode mcp auth list ```

Per informazioni più dettagliate, controlla i file di log di OpenCode in `~/.local/share/opencode/log/`. Puoi anche avviare OpenCode con log dettagliati per avere più output di debug:

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

Per maggiori dettagli, consulta la guida alla risoluzione dei problemi di OpenCode e la documentazione sui server MCP.