[Dev] Opencode /mcps 失敗的原因與專案化解法 • BlogZzz

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "github": {
      "type": "remote",
      "url": "https://api.githubcopilot.com/mcp/",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:GITHUB_MCP_PAT}"
      }
    }
  }
}

這代表 opencode 會從環境變數 GITHUB_MCP_PAT 讀取 token VSCode 擴充套件也會讀同一份設定檔

5) 先用 CLI 確認 github mcp 是否成功

export GITHUB_MCP_PAT="你的 token"
opencode mcp list

如果顯示結果 github connected

只要這一步成功，CLI 就是 OK 的

6) 在 VSCode 內用 opencode 擴充套件確認 github mcp 是否成功

開啟 VSCode 後，開啟 opencode 執行 /mcps

如果顯示結果 github connected

只要這一步成功，擴充套件就是 OK 的

問題描述

CLI 端 opencode mcp list 顯示正常 connected，
擴充套件打開的 opencode /mcps 顯示 github failed
常見錯誤：SSE error: Non-200 status code (400)

如果重啟 VSCode 後連 CLI 也失敗，通常就是 token 變成空值了

解法

解法是「同一個終端啟動 VSCode」
長期解法是「專案內用 direnv 自動載入」

為什麼 CLI 正常，擴充套件的卻失敗

opencode mcp list 在 CLI 會吃到當前 shell 的環境變數，而 VSCode 的 GUI 是另一個程序，如果是從 Dock/Launcher 啟動，通常不會載入 ~/.zshrc

因此你在 Terminal 執行過：

export GITHUB_MCP_PAT="..."

CLI 能用，但 VSCode 內的 /mcps 會看到空值，最後就回 400

最短修法：同一個終端啟動 VSCode

export GITHUB_MCP_PAT="你的 token"
code .

這樣 VSCode 會繼承你的環境，擴充套件就能讀到 GITHUB_MCP_PAT

長期方案：direnv 專案化配置

「只在某個專案生效」，而且未來要方便換 token，direnv 很適合

1) 安裝 direnv

brew install direnv

2) 在 zsh 啟用 hook

把這行加到 ~/.zshrc：

eval "$(direnv hook zsh)"

3) 在專案內新增 `.envrc`

export GITHUB_MCP_PAT="你的 token"

建議把 .envrc 放進 .gitignore，避免 token 被提交

4) 允許這個專案

direnv allow

5) 從同一個終端啟動 VSCode

code .

這樣 token 只在專案內生效，想換就改 .envrc

排查清單

echo "$GITHUB_MCP_PAT" 是否有值
export GITHUB_MCP_PAT= 是否不小心把變數清空
VSCode 是不是從 Dock 啟動
/mcps 的錯誤是否為 400

只要把環境變數來源釐清，通常就能一次解掉