ConnectError: [unavailable] when using AI features via SSH Remote

Where does the bug appear (feature/product)?

Cursor IDE

Describe the Bug

Describe the Bug
AI features (Chat, Composer, Cmd+K, etc.) fail with ConnectError: [unavailable] when connected to a remote server via SSH Remote.
The same AI features work perfectly on my local machine, and the remote server has full network connectivity to Cursor’s API servers (verified via curl and nslookup).
This issue started after updating Cursor today. It was working fine before the update.

Error message:

Request ID: a5e2e584-6d5a-4db8-a6ee-918c5a7ce22a
ConnectError: [unavailable]
at _Gc.$streamAiConnect (vscode-file://vscode-app/Applications/Cursor.app/Contents/Resources/app/out/vs/workbench/workbench.desktop.main.js:12154:453319)
at async vscode-file://vscode-app/Applications/Cursor.app/Contents/Resources/app/out/vs/workbench/workbench.desktop.main.js:585:94724
at async Object.run (vscode-file://vscode-app/Applications/Cursor.app/Contents/Resources/app/out/vs/workbench/workbench.desktop.main.js:12202:10221)
at async o (vscode-file://vscode-app/Applications/Cursor.app/Contents/Resources/app/out/vs/workbench/workbench.desktop.main.js:8603:1269)
at async Promise.allSettled (index 0)
at async Mzr.run (vscode-file://vscode-app/Applications/Cursor.app/Contents/Resources/app/out/vs/workbench/workbench.desktop.main.js:8603:6561)

Steps to Reproduce

Open Cursor on local macOS machine
Connect to a remote Ubuntu server via SSH Remote (Cmd+Shift+P → “Remote-SSH: Connect to Host”)
Once connected, open any project folder on the remote server
Try to use any AI feature (Chat, Composer, Cmd+K, etc.)
Error appears: ConnectError: [unavailable]

Expected Behavior

AI features should work normally when connected via SSH Remote, just as they do on the local machine.

Operating System

MacOS

Current Cursor Version (Menu → About Cursor → Copy)

Version: 2.2.17 (Universal)
VSCode Version: 1.105.1
Commit: cf858ca030e9c9a99ea444ec6efcbcfc40bfda70
Date: 2025-12-11T18:30:06.649Z
Electron: 37.7.0
Chromium: 138.0.7204.251
Node.js: 22.20.0
V8: 13.8.258.32-electron.0
OS: Darwin arm64 25.1.0

Does this stop you from using Cursor

Yes - Cursor is unusable

I found the cause.

  • Local: AI works fine (HTTP/2 enabled)

  • SSH Remote + HTTP/2 enabled: AI not working

  • SSH Remote + HTTP/2 disabled: AI works

Great find! HTTP/2 can indeed cause connectivity issues in certain network configurations, including SSH Remote connections. Disabling HTTP/2 is the recommended workaround for this.

For others who encounter this: App Settings (CMD/CTRL + ,) > search “HTTP/2” > enable “Disable HTTP/2”

Thanks for sharing the solution!