OpenCode LSP: o que faz, como ativar e como corrigir servidores desativados

LSP significa Language Server Protocol. Um servidor de linguagem roda ao lado do projeto e oferece diagnósticos, símbolos, definições, referências e informações de hover. O OpenCode pode usar esses dados na sessão em vez de tratar cada arquivo como texto isolado.

O benefício prático é o contexto. Se o servidor TypeScript entende uma importação, o agente tem mais evidências ao explicar um erro de tipos ou um renome. Mesmo assim, LSP não garante respostas corretas: o servidor pode faltar, o projeto pode não carregar ou o pacote pode exigir configuração própria. LSP melhora o contexto, mas não substitui testes nem revisão do diff.

Uma entrada LSP precisa de um comando executável e de uma relação clara com as extensões. O comando inicia o servidor e a lista de extensões indica quais arquivos devem usá-lo. Executável, argumentos e instalação dependem da documentação do servidor; não adivinhe um pacote.

Comece com uma linguagem em um repositório pequeno. Abra um arquivo com a extensão esperada, confirme que o processo inicia e faça uma consulta somente de leitura. Se a extensão não corresponder, um servidor válido pode parecer quebrado porque o OpenCode não o associa ao arquivo.

Coloque decisões compartilhadas em uma configuração de projeto revisada. Deixe experimentos pessoais na configuração global até entender comando, extensões e raiz do projeto. O guia JSONC explica escopo e Schema; esta página fica concentrada no servidor de linguagem.

Uma entrada pequena é mais fácil de depurar que um catálogo grande. Use um nome claro, um array de comandos explícito e apenas as extensões suportadas. Acrescente inicialização depois de o processo básico funcionar. JSON válido não garante executável ou workspace corretos.

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "command": ["typescript-language-server", "--stdio"],
      "extensions": [".ts", ".tsx"]
    }
  }
}

A documentação oficial atual informa que omitir lsp desativa todos os servidores. Para desativar todos depois de outra configuração, use lsp: false; para um servidor, disabled: true. Isso ajuda quando o servidor é lento, barulhento ou incompatível com o repositório.

Servidores personalizados cobrem linguagens ou extensões que não estão na configuração comum. Defina comando e extensões primeiro, acrescente inicialização conforme a documentação e altere uma coisa por vez. Guarde a última configuração que funcionou para fazer rollback.

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": false
}

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "custom-lsp": {
      "command": ["custom-lsp-server", "--stdio"],
      "extensions": [".custom"],
      "initialization": { "preferences": { "mode": "strict" } }
    }
  }
}

Não comece reescrevendo um módulo grande. Use um repositório limpo, abra um arquivo conhecido e faça uma solicitação somente de leitura: símbolo, definição ou diagnóstico. Compare o resultado com editor, compilador ou servidor confiável.

Depois, faça uma alteração pequena e reversível e veja o diff. Registre sistema, comando, extensões, raiz e prompt. Essa anotação transforma um teste pessoal em um procedimento reproduzível.

1. LimparComece com branch e árvore de trabalho conhecidos.
2. AssociarAbra um arquivo com a extensão configurada.
3. LerPeça símbolo, definição, referência ou diagnóstico.
4. EditarFaça uma alteração pequena e reversível e veja o diff.
5. RegistrarGuarde comando, modelo, servidor e rollback.

Se o OpenCode disser que os LSP estão desativados, confira a precedência antes de reinstalar. Outro arquivo pode impor lsp: false, o projeto pode não declarar o servidor ou uma entrada pode conter disabled. Compare a pasta do projeto com o arquivo de configuração vencedor.

Se o servidor está ativo, mas não há diagnóstico, verifique comando e extensão. Execute-o no mesmo shell, confirme runtime e PATH e veja se o projeto exige lockfile, configuração do compilador ou raiz do workspace. Um primeiro resultado lento pode ser apenas indexação.

Mantenha as permissões estreitas. LSP precisa de processo e contexto do projeto, não de shell amplo, mais ferramentas MCP ou aprovação automática. Use as páginas de permissões e MCP quando o problema mudar de camada.

LSP fornece inteligência de linguagem no repositório. MCP conecta ferramentas e dados externos. O formatador altera estilo e os testes fornecem evidência executável. O VS Code pode mostrar seus próprios diagnósticos; isso não prova que o OpenCode usa o mesmo servidor ou raiz.

Use a página correta para cada sintoma: MCP trata servidores locais e remotos, VS Code trata contexto do editor e terminal, e permissões trata aprovações. Assim a página LSP no OpenCode permanece focada.