OpenCode の LSP とは？有効化と無効化されたサーバーの直し方

LSP は Language Server Protocol の略です。言語サーバーはプロジェクトの横で動き、診断、シンボル、定義、参照、ホバー情報などを提供します。OpenCode はファイルを単なるテキストとして扱うのではなく、その情報をセッションで利用できます。

実用上のメリットはコンテキストの精度です。TypeScript サーバーが import の関係を理解していれば、agent は型エラーや rename をより具体的に検討できます。ただし、サーバーが起動しない、プロジェクトを読み込めない、言語パッケージに固有設定が必要ということもあります。LSP はテストや diff の確認を置き換えません。

LSP の項目には実行可能なコマンドと、ファイル拡張子との対応が必要です。コマンドがサーバーを起動し、拡張子の一覧が対象ファイルを示します。実行ファイル、引数、導入方法はサーバーのドキュメントに従い、パッケージ名を推測しないでください。

まず小さなリポジトリで一つの言語を試します。対象拡張子のファイルを開き、プロセスが起動することを確認し、読み取り専用の質問をします。拡張子が一致しないと、サーバーが正常でも OpenCode がファイルに接続できません。

リポジトリ全体で共有する LSP の決定は、レビューできるプロジェクト設定に置きます。個人の実験は、コマンド、拡張子、プロジェクトの root が分かるまでグローバル設定に残します。設定の範囲と Schema は既存の JSONC ガイドを参照し、このページではサーバーの動作に集中します。

大きな一覧より小さな項目の方が切り分けやすくなります。名前を分かりやすくし、command 配列を明示し、対応する拡張子だけを書きます。初期化オプションは基本プロセスが動いてから追加します。JSON が正しくても実行ファイルや workspace が違う可能性があります。

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

現在の公式ドキュメントでは、lsp を省略するとすべての LSP サーバーが無効になります。他の設定で有効になったサーバーを全て止めるには lsp: false、一つだけ止めるには disabled: true を使います。遅い、出力が多い、リポジトリに合わない場合に役立ちます。

カスタムサーバーは、通常の設定にない言語や拡張子を扱うためのものです。最初に command と extensions を定義し、初期化は公式資料にある場合だけ追加します。一度に一つだけ変更し、動作した設定を 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" } }
    }
  }
}

最初から大きなモジュールを書き換えないでください。Git の状態が分かるリポジトリでファイルを一つ開き、シンボル、定義、診断を読み取り専用で尋ねます。エディター、compiler、信頼できるサーバーの結果と比較できる内容にします。

読み取りが成功したら、小さく戻せる変更を一つ行い diff を確認します。OS、command、拡張子、root、テスト用 prompt を記録しておくと、次回も同じ条件で再現できます。

1. 確認ブランチと作業ツリーを確認する。
2. 一致設定した拡張子のファイルを開く。
3. 読み取りシンボル、定義、参照、診断を尋ねる。
4. 編集小さく戻せる変更をして diff を見る。
5. 記録command、モデル、サーバー、rollback を残す。

LSP が無効だと表示されたら、再インストールの前に設定の優先順位を確認します。別のファイルが lsp: false を指定している、プロジェクトにサーバー名がない、個別の disabled が有効という可能性があります。実際のプロジェクトフォルダーと最終的に効く設定を比べます。

有効なのに診断が出ない場合は command と拡張子を確認します。同じ shell で起動し、runtime と PATH、lockfile、compiler 設定、workspace root を調べます。最初だけ遅いなら大きなリポジトリの index 作成かもしれません。

権限は狭く保ちます。LSP に必要なのはプロセスとプロジェクトの文脈であり、広い shell、MCP の追加、auto approval ではありません。層が変わったら権限と MCP のガイドを参照します。

LSP はリポジトリ内の言語インテリジェンス、MCP は外部ツールやデータ、formatter はスタイル、テストは実行できる証拠を担当します。VS Code が診断を表示していても、OpenCode が同じサーバーや root を使っているとは限りません。

症状に合ったページを使います。MCP はローカルとリモートのツールサーバー、VS Code はエディターと terminal、permissions は承認範囲を扱います。この切り分けで OpenCode の LSP の意図を保てます。