Skip to content

Documentation for opencode outdated #3450

Open

Description

@mmesiti

opencode documentation https://github.com/github/github-mcp-server/blob/main/docs/installation-guides/install-opencode.md applies to opencode v1, and it might not be up-to-date for opencode v2. Flagged by opencode itself using DSv4Flash.

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).

Activity

  1. zhiganovsasha commented on Nov 13, 2026

    @zhiganovsasha

    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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions