Qoder CN Series:Perguntas frequentes sobre o MCP

1. Ambiente ausente para o comando npx

• Mensagem de erro: failed to start command: exec: "npx": executable file not found in $PATH

• Solução: Baixe e instale o Node.js.

• Acesse o site oficial do Node.js, baixe e instale o Node.js 18 ou uma versão posterior, ou siga estas etapas:

  Etapas de instalação e verificação

  Windows

  1. Baixe e instale o nvm-windows e gerencie várias versões.

     nvm install 22.14.0  # Install a specific version
     nvm use 22.14.0

     2. Após concluir a instalação, execute o seguinte comando no terminal e verifique a instalação.

     node -v
     npx -v

     3. Se a instalação for bem-sucedida, o terminal exibirá o número da versão do Node.js instalada.

  macOS

  Baixe e instale o Node.js usando o Homebrew. Primeiro, você precisa instalar o Homebrew.

  # 1. Install or update Homebrew<p># 1. Update Homebrew and install Node.js</p>
  brew update
  brew install node
  
  # 2. Verify the core toolchain
  echo "Node.js version: $(node -v)"
  echo "npm version: $(npm -v)"
  echo "npx version: $(npx -v)"
  
  # 3. Configure environment variables (if necessary)
  echo 'export PATH="/usr/local/opt/node@16/bin:$PATH"' >> ~/.zshrc

2. Ambiente ausente para o comando uvx

• Mensagem de erro: failed to start command: exec: "uvx": executable file not found in $PATH

• Solução: Instale o uv. O uvx é uma interface de linha de comando fornecida pelo uv para que você execute scripts Python rapidamente.

  • Acesse o site oficial do Python, baixe e instale o Python 3.8 ou uma versão posterior, ou siga estas etapas:

    Etapas de instalação e verificação

    1. Baixe e instale

       Windows system

       No Windows, execute o seguinte comando e instale.

       powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

       macOS

       No macOS e no Linux, execute o seguinte comando e instale.

       curl -LsSf https://astral.sh/uv/install.sh | sh

    2. Após concluir a instalação, execute o seguinte comando no terminal e verifique a instalação.

       uv --version

    3. Se a instalação for bem-sucedida, o terminal exibirá o número da versão do uv instalada.

3. Falha ao inicializar o cliente MCP

• Mensagem de erro: failed to initialize MCP client: context deadline exceeded

• Causas possíveis:

  • Configurações incorretas de parâmetros do service: Os parâmetros do service MCP estão incorretos, o que impede a inicialização do service.

  • Falha ao obter recursos: A instalação falha porque problemas de rede impedem que você baixe os recursos.

  • Restrições de segurança de rede: O service MCP não inicializa porque o software de segurança corporativa interna o bloqueia.

• Etapas de solução de problemas:

npm config set registry https://registry.npmmirror.com

export UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/

1. A execução da ferramenta falha devido a variáveis de ambiente ou parâmetros incorretos

2. O modelo não consegue chamar as ferramentas MCP

• Confirme se você está no Agent mode.

  Importante

  Se nenhuma pasta de projeto estiver aberta, o sistema entrará no AI Chat mode e não poderá chamar as ferramentas MCP. Primeiro, carregue a pasta do projeto correspondente e mude para o modo Agent.

• Confirme se o service MCP está no Connected state:

• Sugestão: Evite usar nomes semelhantes para os services MCP e suas ferramentas. Por exemplo, se o TextAnalyzer-Pro e o TextAnalyzer-Plus tiverem uma ferramenta chamada fetchText com funções semelhantes, isso pode causar ambiguidade quando o modelo fizer a chamada.

3. As Personal Settings e a página de ferramentas MCP não abrem, e o painel da sessão fica em branco

Esse problema ocorre quando a página fica em branco e o arquivo idea.log contém a seguinte mensagem de erro: "WARN - #c.i.u.j.JBCefApp - JCefAppConfig.class is not from a JBR module".

Causa: As configurações padrão no Android Studio não suportam o JCEF. Isso impede o carregamento de páginas, como as Personal Settings e a página de ferramentas MCP.

Solução:

4. A lista de services MCP falha ao carregar

A lista de services fica travada no estado de carregamento.

• Reinicie a IDE.

• Se o problema persistir, você poderá iniciar o service do Qoder CN manualmente:

  Windows system

  Acesse o diretório .lingma/bin/x.x.x/CPU_architecture_64_system/.

  Execute o comando:

  Lingma.exe start

  macOS

  Clique no ícone da Apple no canto superior esquerdo da tela, selecione About This Mac e visualize o modelo do seu processador. Em seguida, acesse o diretório correspondente com base no modelo do processador.

  • Chip M1: /.lingma/bin/x.x.x/aarch64_darwin/Qoder CN

  • Chip Intel: /.lingma/bin/x.x.x/x86_64_darwin/Qoder CN

  Execute o comando:

  Qoder CN start

  Após o início do service, clique no botão de login novamente.