You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Example: opencode v1 supposedly needs "enable":true in mcp configs, while in opencode v2 mcps are enabled by default and need to be disabled with "disable": true (or with the /mcps menu).
Confirmed on a current OpenCode install (v2.2.7): the v1 shapes in the guide are indeed not what v2 reads.
What actually applies in v2:
servers live under mcp.servers, not directly under mcp
there is no enabled flag; the opt-out is "disabled": true
the OAuth block is snake_case (client_id, client_secret, scope, callback_port, redirect_uri, auth_server_metadata_url)
hiding tools is done with the permissions array, e.g. {"action": "github_*", "resource": "*", "effect": "deny"}, not a tools map
opencode mcp add --global --url <url> --header 'Authorization=Bearer {env:VAR}' writes the global config, and opencode mcp list shows connected / needs authentication
So a reader on v2 who copies the current guide ends up with a server that never connects, with no diagnostic pointing at the version mismatch.
PR #3535 already covers this and looks complete, so I am not opening a duplicate PR. I did raise a separate documentation issue about the Antigravity guide in the same directory, which is unrelated to this one.
Activity
zhiganovsasha commentedon Nov 13, 2026
Confirmed on a current OpenCode install (v2.2.7): the v1 shapes in the guide are indeed not what v2 reads.
What actually applies in v2:
mcp.servers, not directly undermcpenabledflag; the opt-out is"disabled": trueclient_id,client_secret,scope,callback_port,redirect_uri,auth_server_metadata_url)permissionsarray, e.g.{"action": "github_*", "resource": "*", "effect": "deny"}, not atoolsmapopencode mcp add --global --url <url> --header 'Authorization=Bearer {env:VAR}'writes the global config, andopencode mcp listshowsconnected/needs authenticationSo a reader on v2 who copies the current guide ends up with a server that never connects, with no diagnostic pointing at the version mismatch.
PR #3535 already covers this and looks complete, so I am not opening a duplicate PR. I did raise a separate documentation issue about the Antigravity guide in the same directory, which is unrelated to this one.