MCP 連不上：401 / Authorization header

「MCP 連不上」90% 是 401。這篇按情況拆解。

401 — Unauthorized

最常見。表示 server 收到了你的 request，但沒看到、或不接受 Authorization header。

診斷步驟 1：確認 token 存在

本機 stdio：

npx slima-mcp@0 status

應該回顯「Token valid for [email protected]」。

如果回「No token found」 → 重跑：

npx slima-mcp@0 auth

詳見：取得 SLIMA_API_TOKEN

診斷步驟 2：確認 token 沒過期、沒被撤銷

到 Account → 已授權應用程式 看：

• Token 是否在列表中
• 是否標 "expired" 或 "revoked"

如果是 → 重新 auth。

診斷步驟 3：確認 client 的設定正確

Claude Desktop 重啟、看 logs：

macOS：

tail -f ~/Library/Logs/Claude/mcp*.log

Windows：

type "%APPDATA%\Claude\Logs\mcp*.log"

找：

• MCP server slima exited unexpectedly → 啟動指令設錯了
• Failed to fetch ... → 網路問題
• Authorization header not set → token 沒讀到

其他連線錯誤

403 Forbidden

Token 有效但權限不足——譬如 token 是某個被刪除帳號的、或 scope 不對。

修： 重新 auth。

408 / Timeout

網路太慢，或中間有 middleware 在擋。修： 換個網路 / proxy / VPN。

5xx

Slima server 出問題。修： 等 5-10 分鐘再試 / 看 status.slima.ai。

WWW-Authenticate flow

Web OAuth client（claude.ai / ChatGPT）401 後，Slima 會回 WWW-Authenticate: Bearer realm="slima", scope="..." header——client 應該據此自動觸發 OAuth reauth flow。

如果 reauth flow 沒觸發 → client 的 MCP 實作有 bug。試重啟 client / 移除再加 connector。

相關

• Token 過期
• Debug OAuth
• 管理已授權應用程式