OpenCode LSP: qué hace, cómo activarlo y cómo corregir servidores desactivados

LSP significa Language Server Protocol. Un servidor de lenguaje se ejecuta junto al proyecto y ofrece diagnósticos, símbolos, definiciones, referencias y detalles de una función. OpenCode puede usar esa información durante una sesión en vez de tratar cada archivo como texto aislado.

El beneficio real es el contexto. Si el servidor de TypeScript entiende una importación, el agente tiene más evidencia al explicar un fallo de tipos o un cambio de nombre. Aun así, LSP no garantiza una respuesta correcta: el servidor puede faltar, el proyecto puede no cargarse o el paquete puede exigir su propia configuración. LSP mejora la información, pero no sustituye las pruebas ni la revisión del diff.

Una entrada LSP necesita un comando ejecutable y una relación clara con las extensiones. El comando inicia el servidor y la lista de extensiones indica qué archivos deben usarlo. El ejecutable, los argumentos y el método de instalación dependen de la documentación del servidor; no adivines un paquete.

Empieza con un lenguaje y un repositorio pequeño. Abre un archivo con la extensión esperada, comprueba que el proceso puede iniciarse y después pide una consulta de solo lectura. Si la extensión no coincide, un servidor válido puede parecer roto porque OpenCode no lo vincula al archivo.

Usa la configuración del proyecto para decisiones que todo el repositorio debe revisar. Mantén los experimentos personales en la configuración global hasta conocer el comando, las extensiones y la raíz del proyecto. La guía de JSONC cubre alcance y Schema; esta página se centra en el servidor de lenguaje.

Una entrada pequeña se depura mejor que un catálogo grande. Usa un nombre descriptivo, un array de comandos explícito y solo las extensiones que el servidor admite. Añade opciones de inicialización después de que el proceso básico funcione. JSON válido no garantiza que el ejecutable o el workspace sean correctos.

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

La documentación oficial actual indica que omitir lsp desactiva todos los servidores. Para apagar todos los servidores después de otra configuración, usa lsp: false; para uno concreto, usa disabled: true. Es útil cuando el servidor es lento, produce ruido o no es compatible con un repositorio.

Los servidores personalizados cubren lenguajes o extensiones que no aparecen en la configuración habitual. Define primero comando y extensiones, añade inicialización solo cuando la documentación lo pida y cambia una sola cosa cada vez. Guarda la última configuración que funcionó para poder volver atrás.

{
  "$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" } }
    }
  }
}

No empieces reescribiendo un módulo grande. Usa un repositorio limpio, abre un archivo conocido y formula una petición de solo lectura: identificar un símbolo, explicar un diagnóstico o localizar una definición. Compara el resultado con el editor, el compilador o el servidor que ya consideres fiable.

Cuando esa ruta funcione, haz un cambio pequeño y reversible y revisa el diff. Anota sistema, comando, extensiones, raíz y prompt de prueba. Esa nota convierte una prueba personal en un procedimiento reproducible.

1. LimpiarParte de una rama y un árbol de trabajo conocidos.
2. CoincidirAbre un archivo con una extensión configurada.
3. LeerPide un símbolo, definición, referencia o diagnóstico.
4. EditarHaz un cambio pequeño y reversible y mira el diff.
5. AnotarGuarda comando, modelo, servidor y rollback.

Si OpenCode dice que los LSP están desactivados, revisa primero la precedencia. Otro archivo puede imponer lsp: false, el proyecto puede no declarar el servidor o una entrada puede tener disabled. Compara la carpeta real del proyecto con la ubicación de la configuración.

Si el servidor está activo pero no hay diagnósticos, revisa comando y extensión. Ejecútalo en el mismo shell cuando sea posible, confirma runtime y PATH, y comprueba si necesita lockfile, configuración del compilador o raíz del workspace. Un primer resultado lento puede deberse al indexado de un repositorio grande.

Mantén estrechos los permisos. LSP necesita un proceso y contexto de proyecto, no permiso shell ilimitado, más herramientas MCP o autoaprobación. Usa las guías de permisos y MCP cuando el fallo cambie de capa.

LSP aporta inteligencia de lenguaje al repositorio. MCP conecta herramientas o datos externos. El formateador cambia el estilo y las pruebas aportan evidencia ejecutable. VS Code puede mostrar diagnósticos con su propia integración; eso no demuestra que OpenCode use el mismo servidor o la misma raíz.

Enlaza la guía adecuada para cada síntoma: MCP trata servidores locales y remotos, VS Code trata contexto y terminal, y permisos trata aprobaciones. Separar estas intenciones mantiene enfocada la página LSP en OpenCode.