Centro de ajuda / Servidor MCP / OpenCode

Ligue o KasLens ao OpenCode

Aceda a dados Kaspa a partir do agente de IA do terminal.

Ligar o KasLens ao OpenCode

O OpenCode é um agente interativo de programação em linha de comandos que corre no terminal. Este guia mostra como ligar o servidor MCP do KasLens ao OpenCode para que este possa aceder a dados de mercado e análises da Kaspa em tempo real.

Pré-requisitos

Lembrete: verifique a pasta de spam ou de lixo se não tiver recebido o e-mail de verificação de [email protected].

Passo 1: adicionar o servidor MCP à configuração

O OpenCode utiliza um ficheiro de configuração JSON para gerir servidores MCP. Abra o ficheiro de configuração do OpenCode:

  • Configuração global: ~/.config/opencode/opencode.jsonc
  • Configuração do projeto: opencode.jsonc na raiz do projeto

Adicione o servidor MCP do KasLens à secção mcpServers:

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

Passo 2: iniciar o OpenCode e autenticar

  1. Inicie o OpenCode no terminal:
opencode
  1. O OpenCode deteta o novo servidor MCP e inicia o fluxo OAuth
  2. Abre-se uma janela do navegador com a página de início de sessão do KasLens. Se o navegador não abrir automaticamente, vá ao terminal e execute:
opencode mcp auth kaslens
  1. Inicie sessão com o e-mail do KasLens e a palavra-passe
  2. Autorize o OpenCode a aceder aos seus dados do KasLens
  3. Volte ao terminal: o OpenCode confirmará a ligação

Passo 3: começar a utilizar

Já pode perguntar ao OpenCode sobre dados da Kaspa. Por exemplo:

  • "Qual é o preço atual da Kaspa e o volume das últimas 24 horas?"
  • "Quais são os eventos económicos de hoje e como podem influenciar o preço da Kaspa?"
  • "Resume o Daily Pulse da Kaspa de hoje"
  • "Mostra os 10 principais endereços Kaspa por saldo"
  • "Que tokens KRC-20 têm a maior capitalização de mercado?"

O OpenCode chamará o servidor MCP do KasLens para obter dados em tempo real e responder diretamente no terminal.

Autenticar novamente

O OpenCode guarda os tokens OAuth localmente. Se a sessão expirar, o OpenCode abre automaticamente o navegador para voltar a autenticar. Também pode desencadear a reautenticação manualmente:

opencode mcp auth kaslens

Resolução de problemas

"Connection refused" ou tempo esgotado

Certifique-se de que tem acesso à Internet e de que https://kaspa-lens.com/mcp está acessível. Pode testar com:

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

Deve obter uma resposta 405 (Method Not Allowed: o endpoint MCP espera POST, e não GET). Isto confirma que o servidor está acessível.

O navegador não abre para a autenticação

Se o ambiente do terminal não suportar a abertura de navegadores, o OpenCode mostra um URL para abrir manualmente. Copie-o e cole-o no navegador.

"Email not verified"

Tem de verificar o endereço de e-mail antes de poder iniciar sessão. Verifique a caixa de entrada (e a pasta de spam) à procura do e-mail de verificação de [email protected].

Depurar problemas de ligação

Se algo não funcionar, o OpenCode disponibiliza diagnósticos integrados para servidores MCP. Execute o seguinte comando para testar a ligação, verificar o estado OAuth e confirmar o fluxo de descoberta:

opencode mcp debug kaslens

Para verificar o estado de autenticação de todos os servidores MCP configurados:

opencode mcp auth list

Para informações mais detalhadas, consulte os ficheiros de registo do OpenCode em ~/.local/share/opencode/log/. Também pode iniciar o OpenCode com registo detalhado para obter mais saída de depuração:

opencode --log-level DEBUG

Consulte o guia de resolução de problemas do OpenCode e a documentação de servidores MCP para mais pormenores.