Connecter KasLens à OpenCode

OpenCode est un agent de code interactif en ligne de commande qui s'exécute dans votre terminal. Ce guide vous montre comment connecter le serveur MCP KasLens à OpenCode afin qu'il puisse accéder aux données de marché et aux analyses Kaspa en temps réel.

Prérequis

OpenCode installé sur votre machine
Un compte KasLens vérifié : créez-en un ici si ce n'est pas déjà fait

Rappel : vérifiez votre dossier spam ou courrier indésirable si vous n'avez pas reçu l'e-mail de vérification de [email protected].

Étape 1 : ajouter le serveur MCP à votre configuration

OpenCode utilise un fichier de configuration JSON pour gérer les serveurs MCP. Ouvrez votre fichier de configuration OpenCode :

Configuration globale : ~/.config/opencode/opencode.jsonc
Configuration du projet : opencode.jsonc à la racine de votre projet

Ajoutez le serveur MCP KasLens à la section mcpServers :

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

Étape 2 : démarrer OpenCode et s'authentifier

Démarrez OpenCode dans votre terminal :

opencode

OpenCode détecte le nouveau serveur MCP et lance le flux OAuth
Une fenêtre de navigateur s'ouvre et affiche la page de connexion KasLens. Si le navigateur ne s'ouvre pas automatiquement, allez dans votre terminal et exécutez :

opencode mcp auth kaslens

Connectez-vous avec votre adresse e-mail KasLens et votre mot de passe
Autorisez OpenCode à accéder à vos données KasLens
Revenez à votre terminal : OpenCode confirmera la connexion

Étape 3 : commencer à l'utiliser

Vous pouvez désormais interroger OpenCode au sujet des données Kaspa. Par exemple :

« Quel est le cours actuel de Kaspa et le volume sur 24 h ? »
« Quels sont les événements économiques du jour et comment pourraient-ils influencer le cours de Kaspa ? »
« Résume le Daily Pulse Kaspa du jour »
« Montre-moi les 10 principales adresses Kaspa par solde »
« Quels jetons KRC-20 ont la plus forte capitalisation ? »

OpenCode appellera le serveur MCP KasLens pour récupérer des données en direct et fournir les réponses directement dans votre terminal.

Se réauthentifier

OpenCode stocke les jetons OAuth localement. Si votre session expire, OpenCode ouvrira automatiquement le navigateur pour que vous vous réauthentifiiez. Vous pouvez aussi déclencher manuellement la réauthentification :

opencode mcp auth kaslens

Dépannage

« Connection refused » ou délai dépassé

Vérifiez que vous avez accès à Internet et que https://kaspa-lens.com/mcp est accessible. Vous pouvez tester avec :

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

Vous devriez obtenir une réponse 405 (Method Not Allowed : le point de terminaison MCP attend POST, et non GET). Cela confirme que le serveur est accessible.

Le navigateur ne s'ouvre pas pour l'authentification

Si votre environnement de terminal ne permet pas d'ouvrir un navigateur, OpenCode affichera une URL à ouvrir manuellement. Copiez-la et collez-la dans votre navigateur.

« Adresse e-mail non vérifiée »

Vous devez vérifier votre adresse e-mail avant de pouvoir vous connecter. Consultez votre boîte de réception (et le dossier spam) pour trouver l'e-mail de vérification de [email protected].

Déboguer les problèmes de connexion

Si quelque chose ne fonctionne pas, OpenCode fournit des diagnostics intégrés pour les serveurs MCP. Exécutez la commande suivante pour tester la connexion, vérifier l'état OAuth et contrôler le flux de découverte :

opencode mcp debug kaslens

Pour vérifier l'état d'authentification de tous les serveurs MCP configurés :

opencode mcp auth list

Pour des informations plus détaillées, consultez les fichiers journaux d'OpenCode dans ~/.local/share/opencode/log/. Vous pouvez aussi démarrer OpenCode avec une journalisation détaillée pour obtenir davantage de sorties de débogage :

opencode --log-level DEBUG

Consultez le guide de dépannage OpenCode et la documentation des serveurs MCP pour en savoir plus.